연동 개요와 옵션 비교

Gemini Enterprise에 등록 가능한 에이전트 종류와 Agent Engine 중심 연동의 장단점

Gemini Enterprise는 한 곳에서 여러 종류의 에이전트를 등록·관리할 수 있는 카탈로그입니다. 어떤 에이전트 유형이 있고, 어떤 경우에 어떤 옵션을 선택해야 하는지 정리합니다.

목차

등록 가능한 에이전트 유형
Agent Engine 중심 연동의 가치
전체 연동 흐름

1. 등록 가능한 에이전트 유형

유형	빌드 방식	특징	적합한 경우
Custom agent via Agent Engine	Python ADK + Agent Engine 배포	코드 기반, Tool/Memory/Trace 제공	다단계 추론, 외부 API 호출
Custom agent via Dialogflow	Dialogflow CX 콘솔	No-code 흐름 정의	결정 트리, 콜센터
Custom agent via A2A	A2A 프로토콜 호환 외부 서버	HTTP+JSON 표준, 어디서든 호스팅	타사·온프레미스 에이전트
Marketplace agent	마켓플레이스 설치	즉시 사용	검증된 서드파티 솔루션

본 워크북은 Agent Engine 기반 Custom Agent 등록을 중심으로 다룹니다. Dialogflow/A2A는 등록 단계의 인증·메타데이터 입력 형식만 다릅니다.

2. Agent Engine 중심 연동의 가치

가치	내용
운영 단순화	Agent Engine이 컨테이너·오토스케일링·세션·로그를 관리
추론 추적	Trace, Sessions, Playground가 기본 제공
평가 통합	Vertex AI Evaluation으로 응답 품질 정량 측정
권한 인지	Gemini Enterprise의 사용자 컨텍스트가 Tool 호출까지 전달 가능
모델 교체 용이	Gemini 모델 버전 업그레이드 시 코드 수정 최소화

비교: Cloud Run에 직접 배포 vs Agent Engine

항목	Cloud Run 직접 배포	Agent Engine
컨테이너 관리	직접	관리형
세션/메모리	직접 구현	내장
Trace	직접 계측	자동
Gemini Enterprise 등록	A2A 프로토콜로 가능	Custom agent via Agent Engine로 직접 등록
자유도	매우 높음	추상화에 맞춰야 함

3. 전체 연동 흐름

graph TD
    A[ADK로 Agent 코드 작성] --> B[Agent Engine에 배포]
    B --> C[Reasoning Engine ID 확보]
    C --> D[OAuth Client ID 발급]
    D --> E[Gemini Enterprise 콘솔 → Add agent]
    E --> F[Authorization 등록]
    F --> G[Agent 메타데이터 입력 + Reasoning Engine 연결]
    G --> H[Enabled 상태 확인]
    H --> I[End User에게 노출]

단계별 산출물

단계	산출물
ADK 코드 작성	`agent.py`, `tools.py`
Agent Engine 배포	Reasoning Engine 리소스 경로
OAuth 발급	Client ID / Client Secret
Authorization 등록	Authorization 리소스
Agent 등록	Gemini Enterprise Agent 엔트리

4. 다음 단계