Gemini Enterprise 등록

Agent Engine에 배포된 에이전트를 Gemini Enterprise에 등록하는 방법

Agent Engine에 배포된 에이전트를 Gemini Enterprise에 등록하여 사용자에게 제공하는 방법을 설명합니다.

1. 개요

Gemini Enterprise는 기업용 AI 어시스턴트 플랫폼입니다. Agent Engine에 배포된 에이전트를 Gemini Enterprise에 등록하면 조직 내 사용자들이 쉽게 에이전트를 활용할 수 있습니다.

등록 프로세스 개요

OAuth 클라이언트 ID 생성
에이전트 유형 선택
인증 설정
에이전트 구성
생성 확인
에이전트 테스트

2. OAuth 클라이언트 ID 생성

Gemini Enterprise가 사용자를 대신하여 인증할 수 있도록 OAuth 자격 증명을 생성해야 합니다.

Google Cloud Console 설정

Google Cloud Console의 탐색 메뉴에서 [APIs & Services] > [Credentials]로 이동합니다.
상단의 [+ Create Credentials]를 클릭하고 [OAuth client ID]를 선택합니다.
OAuth 클라이언트 ID 만들기 화면에서 다음과 같이 설정합니다:

항목	값
Application type	Web application
Name	식별하기 쉬운 이름 입력

Authorized redirect URIs 설정

아래 두 가지 URI를 반드시 추가해야 합니다:

https://vertexaisearch.cloud.google.com/oauth-redirect
https://vertexaisearch.cloud.google.com/static/oauth/oauth.html

[Create] 버튼을 클릭합니다.
생성 후 팝업되는 Client ID와 Client Secret을 메모장 등에 따로 복사해 둡니다.

3. 에이전트 유형 선택

Gemini Enterprise 콘솔 접속

Gemini Enterprise 콘솔로 이동합니다.
좌측 메뉴에서 [Apps] > [구성할 앱 선택] > [Agents] 탭으로 이동합니다.
상단의 [+ Add agent] 버튼을 클릭합니다.

에이전트 유형 선택

에이전트 유형	설명
Custom agent via Agent Engine	Agent Engine을 통한 맞춤 에이전트
Custom agent via Dialogflow	Dialogflow 프레임워크 사용
Custom agent via A2A	A2A 프로토콜 사용
Agents via Marketplace	마켓플레이스 에이전트

[Custom agent via Agent Engine] 카드의 [Add] 버튼을 클릭합니다.

4. 인증 설정

Authorization 화면 설정

Create agent 마법사의 첫 번째 단계인 ① Authorizations 화면이 나타납니다.
[Add authorization] 버튼을 클릭합니다.
New authorization 설정창에 정보를 입력합니다:

필드	값
Authorization name	Google OAuth
Client ID	복사한 Client ID
Client secret	복사한 Client Secret
Token URI	`https://oauth2.googleapis.com/token`
Authorization URI	`https://accounts.google.com/o/oauth2/v2/auth?client_id=YOUR_CLIENT_ID`

입력 완료 후 [Done]을 클릭하고, 하단의 [Next] 버튼을 눌러 다음 단계로 진행합니다.

5. 에이전트 구성

Configuration 화면 설정

② Configuration 화면에서 다음 정보를 입력합니다:

필드	설명	예시
Agent name	에이전트의 표시 이름	Data Engineer Agent
Agent description	에이전트가 수행하는 작업 설명	자연어를 SQL로 변환하는 에이전트
Agent Engine reasoning engine	배포된 Agent Engine 리소스 경로	projects/xxx/locations/us-central1/reasoningEngines/xxx

Agent Engine Reasoning Engine 경로 형식

projects/{project_id}/locations/{location}/reasoningEngines/{reasoning_engine_id}

모든 정보가 정확한지 확인 후 [Create] 버튼을 클릭합니다.

6. 생성 확인 및 테스트

에이전트 목록 확인

생성이 완료되면 Agents 목록 화면으로 돌아갑니다.
방금 생성한 에이전트가 목록에 표시되는지 확인합니다.

확인 사항

항목	확인 내용
Display name	에이전트 이름이 올바르게 표시
Agent type	Agent Engine으로 표시
Agent state	✅ Enabled로 표시

에이전트 테스트

Gemini Enterprise 인터페이스에서 직접 테스트합니다:

사용자 입력:

전월 대비 택시 이용 건수 증감률 분석

에이전트 응답:

네, 좋은 분석 주제입니다. 전월 대비 택시 이용 건수의 증감률을 분석해 보겠습니다.

| ride_month | ride_count | growth_rate_percentage |
|------------|------------|------------------------|
| 2022-01-01 | 62,511 | 2,083,600% |
| 2022-02-01 | 69,398 | 11.02% |
| 2022-03-01 | 78,518 | 13.14% |

7. 문제 해결

일반적인 오류

오류	원인	해결 방법
OAuth 인증 실패	Redirect URI 누락	두 개의 redirect URI 확인
Agent Engine 연결 실패	리소스 경로 오류	reasoning engine 경로 확인
권한 오류	IAM 권한 부족	적절한 역할 부여

Agent Engine Workbook