feat: add Google Vertex AI connector implementation #493

hxcva1 · 2025-10-08T15:48:18Z

Purpose

Close Connector Implementation & Inheritance: Google Vertex AI #237

Does this introduce a breaking change?

[ ] Yes
[x] No

Pull Request Type

What kind of change does this Pull Request introduce?

[ ] Bugfix
[x] New feature
[ ] Refactoring (no functional changes, no api changes)
[ ] Documentation content changes
[ ] Other... Please describe:

README updated?

The top-level readme for this repo contains a link to each sample in the repo. If you're adding a new sample did you update the readme?

[x] Yes
[ ] No
[ ] N/A

What to Check

Verify that the following are valid

Required Parameters: ApiKey, Model

…d chat client

…fra bicep templates

…sing

…rtexAIConnectorTests

tae0y · 2025-10-09T06:24:54Z

오셨군요! 내용 확인해보겠습니다 ~

tae0y · 2025-10-09T06:29:34Z

tae0y · 2025-10-09T06:38:15Z

test/OpenChat.PlaygroundApp.Tests/Connectors/GoogleVertexAIConnectorTests.cs 테스트 시나리오 정리

Given_Settings_Is_Null_When_EnsureLanguageModelSettingsValid_Invoked_Then_It_Should_Thro
- GoogleVertexAI 설정이 null일 때 EnsureLanguageModelSettingsValid 호출 시 예외가 발생해야 함
Given_Invalid_ApiKey_When_EnsureLanguageModelSettingsValid_Invoked_Then_It_Should_Thro
- ApiKey가 null, 빈 문자열, 공백만 있을 때 EnsureLanguageModelSettingsValid 호출 시 예외가 발생해야 함
Given_Invalid_Model_When_EnsureLanguageModelSettingsValid_Invoked_Then_It_Should_Thro
- Model이 null, 빈 문자열, 공백만 있을 때 EnsureLanguageModelSettingsValid 호출 시 예외가 발생해야 함
Given_Valid_Settings_When_EnsureLanguageModelSettingsValid_Invoked_Then_It_Should_Return_Tru
- 올바른 설정이 주어졌을 때 EnsureLanguageModelSettingsValid 호출 시 true를 반환해야 함
Given_Valid_Settings_When_GetChatClient_Invoked_Then_It_Should_Return_ChatClien
- 올바른 설정이 주어졌을 때 GetChatClientAsync 호출 시 ChatClient가 반환되어야 함
Given_Settings_Is_Null_When_GetChatClientAsync_Invoked_Then_It_Should_Thro
- GoogleVertexAI 설정이 null일 때 GetChatClientAsync 호출 시 예외가 발생해야 함
Given_Missing_ApiKey_When_GetChatClient_Invoked_Then_It_Should_Thro
- ApiKey가 null 또는 빈 문자열일 때 GetChatClientAsync 호출 시 예외가 발생해야 함
Given_Missing_Model_When_GetChatClient_Invoked_Then_It_Should_Thro
- Model이 null일 때 GetChatClientAsync 호출 시 예외가 발생해야 함
Given_Valid_Settings_When_CreateChatClientAsync_Invoked_Then_It_Should_Return_ChatClien
- 올바른 설정이 주어졌을 때 LanguageModelConnector.CreateChatClientAsync 호출 시 IChatClient가 반환되어야 함
Given_Invalid_Settings_When_CreateChatClientAsync_Invoked_Then_It_Should_Thro
- 잘못된 설정(예: ApiKey가 null)이 주어졌을 때 LanguageModelConnector.CreateChatClientAsync 호출 시 예외가 발생해야 함

tae0y

10/9 변경 요청사항

아래 LanguageModelConnectorTests에서 GoogleVertexAIConnector 구문 각주해제
- test/OpenChat.PlaygroundApp.Tests/Abstractions/LanguageModelConnectorTests.cs
- GoogleVertexAIConnector가 LanguageModelConnector를 잘 상속하는지 테스트
- 관련내용은 이 이슈 참조 #423

그리고 Connector로직과 테스트가 어느정도 정리되었으니 문서로 넘어가시죠!

PR본문 정리 : 불필요한 부분은 남겨두지 마시고 삭제해주세요
docs 디렉토리 아래에 googlevertexai 문서화해주세요
- docs/openai, docs/huggingface를 참고해서 작성하시면 됩니다
- 다른 분들 PR에서 자주 언급됐던 부분을 공유드리면
  - bash/powershell로 구분하여 샘플을 작성해주세요
  - bash 명령어에서 강제개행은 / 역슬래시, powershell은 ` 백틱을 사용합니다
  - docker 컨테이너를 말 때 Github container registry에서 이미지 가져오는 샘플도 작성해주세요
그밖에 리포지토리 루트, docs 루트에 있는 README 수정이 필요합니다

hxcva1 · 2025-10-09T13:10:39Z

피드백 주신 부분 하나씩 수정하면서 코멘트 남기겠습니다!

hxcva1 · 2025-10-10T07:09:53Z

우선 PR 본문 정리했습니다!

…elConnectorTests

hxcva1 · 2025-10-10T08:10:28Z

test/OpenChat.PlaygroundApp.Tests/Abstractions/LanguageModelConnectorTests.cs 부분 주석 해제 했습니다!

tae0y · 2025-10-10T14:55:43Z

test/OpenChat.PlaygroundApp.Tests/Connectors/GoogleVertexAIConnectorTests.cs

+    [InlineData(null, typeof(InvalidOperationException), "GoogleVertexAI:ApiKey")]
+    [InlineData("", typeof(InvalidOperationException), "GoogleVertexAI:ApiKey")]
+    [InlineData("   ", typeof(InvalidOperationException), "GoogleVertexAI:ApiKey")]
+    public void Given_Invalid_ApiKey_When_EnsureLanguageModelSettingsValid_Invoked_Then_It_Should_Throw(string? apiKey, Type expectedType, string expectedMessage)


Type expectedType 매개인자는 사용하지 않으니 모두 제거해주세요
다른 테스트 메서드도 모두 동일합니다 ~

tae0y

10/10 수정요청입니다 LanguageModelConnector 상속 테스트는 잘 확인했습니다!

테스트 메서드에서 불필요한 매개인자 제거하기
지난번 요청한 문서작업

hxcva1 · 2025-10-13T12:29:50Z

불필요한 매개인자 제거했습니다!

tae0y · 2025-10-13T12:33:33Z

@hxcva1 넵 확인했습니다!
문서 작업으로 넘어가시죵

justinyoo · 2025-10-16T00:39:38Z

@hxcva1 #494 PR이 머지가 됐으므로 테스트 코드는 이를 참고해서 작성해 주세욥! 촘촘하게 작성하셔야 합니다.

tae0y · 2025-10-16T12:37:50Z

docs/google-vertex-ai.md

+
+1. Get the repository root.
+
+```bash


코드블럭은 한 탭 들여 씁니다
그래야 1. 만 써도 1, 2, 3으로 순번이 잘 넘어갈 거에요

아래 github models 문서를 참고해주세요
https://github.com/aliencube/open-chat-playground/blob/main/docs/github-models.md?plain=1

tae0y · 2025-10-16T12:38:07Z

docs/google-vertex-ai.md

+    set GoogleVertexAI:ApiKey "{{GOOGLE_VERTEX_AI_API_KEY}}"
+```
+
+> Note: code and tests in this repository use the config keys `GoogleVertexAI:ApiKey` and `GoogleVertexAI:Model`.


이런 각주도 잊지 말고 한 탭 들여 써주세요.

tae0y · 2025-10-16T12:39:52Z

docs/google-vertex-ai.md

+azd down --force --purge
+```
+
+## Notes & troubleshooting


이 아래 내용은 모두 삭제하고, 필요하면 이 PR 본문 혹은 이슈에 코멘트로 남겨주세요.

tae0y · 2025-10-16T12:41:36Z

docs/google-vertex-ai.md

+cd $REPOSITORY_ROOT
+```
+
+1. Add Google Vertex AI API Key. Replace `{{GOOGLE_VERTEX_AI_API_KEY}}` with your key.


API KEY 발급방법을 전부 다 설명할 필요는 없지만
조금만 더 친절하게 어떤 구글 공식문서를 참고하면 되는지만 링크를 달아주세요

이런식으로요

open-chat-playground/docs/github-models.md

Line 41 in 64e41f8

> For more details about GitHub PAT, refer to the doc, [Managing your personal access tokens](https://docs.github.com/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens).

tae0y

고생많으셨습니다! ㅎㅎ
문서 스타일을 맞추고, API KEY 발급시 참고할 문서 링크를 추가해주세요.

tae0y · 2025-10-18T15:03:46Z

@hxcva1 잘 지내시죠? 진행상황 업데이트 부탁드립니다
기한이 있어서 필요하면 저도 같이 작업 진행해볼게요

hxcva1 · 2025-10-19T13:20:23Z

그러면 저는 우선 테스트 코드 보완 부터 시도해보도록 하겠습니다

hxcva1 · 2025-10-21T13:36:16Z

Github 상에서 Conflict 해결하고 커밋을 했는데 로컬에서 이 버전을 pull 안하고 작업한 내용을 커밋했는데 푸쉬하려고 하니 에러가 나서 어떻게 해야할까요? rebase 기능을 사용해도 되는지 git이 아직 완전히 익숙하지는 않아서 죄송합니다.

sikutisa · 2025-10-21T16:36:02Z

Github 상에서 Conflict 해결하고 커밋을 했는데 로컬에서 이 버전을 pull 안하고 작업한 내용을 커밋했는데 푸쉬하려고 하니 에러가 나서 어떻게 해야할까요? rebase 기능을 사용해도 되는지 git이 아직 완전히 익숙하지는 않아서 죄송합니다.

git pull 해보셨나요?
git fetch & git rebase origin/<branch명> 하셔도 되겠지만, 그냥 git pull 하셔도 됩니다.

conflict 발생하면 로컬에서 수정하고 commit & push 하시면 됩니다.

…nt creation)

hxcva1 added 10 commits September 16, 2025 19:52

feat: Add GoogleVertexAIConnector with settings validation and stubbe…

448aa7f

…d chat client

feat: Add GoogleVertexAIConnector to LanguageModelConnector factory

389481a

feat: Add Google Vertex AI parameters and environment variables to in…

12d2bd6

…fra bicep templates

feat: Implement GoogleVertexAIConnector using GeminiChatClient

0be2a59

test: Add unit tests for GoogleVertexAIConnector

4c28c4c

test: Fix failing tests for GoogleVertexAIConnector when model is mis…

319f6be

…sing

chore: Resolve conflicts between main.bicep and main.parameters.json

4d05176

refactor: Replace magic strings with private const string in GoogleVe…

2dff61a

…rtexAIConnectorTests

Merge branch 'main' into feature/237-connector-impl-google-vertex-ai

274a22a

test: Add new test cases to GoogleVertexAIConnectorTests

d2e7f6d

justinyoo linked an issue Oct 8, 2025 that may be closed by this pull request

Connector Implementation & Inheritance: Google Vertex AI #237

Open

justinyoo assigned hxcva1 Oct 8, 2025

justinyoo added ossca p1 team-park phase-1 task maas labels Oct 8, 2025

justinyoo requested a review from tae0y October 8, 2025 16:00

tae0y requested changes Oct 9, 2025

View reviewed changes

test: Enable GoogleVertexAIConnector inheritance check in LanguageMod…

148ba33

…elConnectorTests

tae0y reviewed Oct 10, 2025

View reviewed changes

tae0y requested changes Oct 10, 2025

View reviewed changes

refactor: Remove unnecessary function parameter

282cc6f

docs: Add Google Vertex AI (draft)

e87a218

tae0y reviewed Oct 16, 2025

View reviewed changes

tae0y requested changes Oct 16, 2025

View reviewed changes

Merge branch 'main' into feature/237-connector-impl-google-vertex-ai

1c620b4

test: Add unit tests for GoogleVertexAIConnector (validation and clie…

0c4314f

…nt creation)

feat: add Google Vertex AI connector implementation #493

Are you sure you want to change the base?

feat: add Google Vertex AI connector implementation #493

Uh oh!

Conversation

hxcva1 commented Oct 8, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Purpose

Does this introduce a breaking change?

Pull Request Type

README updated?

What to Check

Uh oh!

tae0y commented Oct 9, 2025

Uh oh!

tae0y commented Oct 9, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

리뷰 진행상황

리뷰 백로그 / 기타 메모

Uh oh!

tae0y commented Oct 9, 2025

Uh oh!

tae0y left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

hxcva1 commented Oct 9, 2025

Uh oh!

hxcva1 commented Oct 10, 2025

Uh oh!

hxcva1 commented Oct 10, 2025

Uh oh!

tae0y Oct 10, 2025

Choose a reason for hiding this comment

Uh oh!

tae0y left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

hxcva1 commented Oct 13, 2025

Uh oh!

tae0y commented Oct 13, 2025

Uh oh!

justinyoo commented Oct 16, 2025

Uh oh!

tae0y Oct 16, 2025

Choose a reason for hiding this comment

Uh oh!

tae0y Oct 16, 2025

Choose a reason for hiding this comment

Uh oh!

tae0y Oct 16, 2025

Choose a reason for hiding this comment

Uh oh!

tae0y Oct 16, 2025

Choose a reason for hiding this comment

Uh oh!

tae0y left a comment

Choose a reason for hiding this comment

Uh oh!

tae0y commented Oct 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

hxcva1 commented Oct 19, 2025

Uh oh!

hxcva1 commented Oct 21, 2025

Uh oh!

sikutisa commented Oct 21, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

hxcva1 commented Oct 8, 2025 •

edited

Loading

tae0y commented Oct 9, 2025 •

edited

Loading

tae0y left a comment •

edited

Loading

tae0y left a comment •

edited

Loading

tae0y commented Oct 18, 2025 •

edited

Loading