ADK(Agent Development Kit) 관련

ADK Tool - Google Cloud Tools

alienbuddy 2025. 7. 5. 18:56

✅ Google Cloud Tools 요약

도구 구분                                 기능 요약                                                                          대표 사례
Apigee API Hub Toolset Apigee API Hub에 등록된 OpenAPI 기반 API를 Agent Tool로 사용 사내 API 호출
Application Integration Toolset Google Cloud Integration Connectors 및 Workflow 자동화와 연결 Salesforce, SAP, JIRA 연동
Toolbox for Databases MCP 기반 DB 접근/쿼리 Tool 구성 AlloyDB, Spanner, Postgres 등 DB 자동화

🔹 1. Apigee API Hub Toolset

✅ 개요

  • Apigee API Hub에 등록된 OpenAPI 기반 API를 자동으로 불러와 Agent에 도구로 등록

✅ 구성 순서

  1. gcloud auth print-access-token 으로 access token 확보
  2. APIHubToolset 생성 시, access_token, apihub_resource_name 제공
  3. 인증 필요 시 auth_scheme, auth_credential 설정
  4. .get_tools()로 에이전트에 도구 추가

✅ 인증 방식

  • API Key, Bearer Token, 서비스 계정, OpenID Connect 지원

🔹 2. Application Integration Toolset

✅ 주요 용도

  • 100개 이상의 GCP Integration Connectors 사용
  • 기존 App Integration Workflow 트리거 호출
  • OAuth2 인증 또는 서비스 계정 사용 가능

✅ 사용 흐름

🔸 Connectors 기반 도구 구성

🔸 Workflow 기반 도구 구성

✅ OAuth2 인증 예시

  • dict_to_auth_scheme() + AuthCredential을 통해 동적 인증 가능

🔹 3. Toolbox for Databases (MCP 기반)

✅ 개요

  • Open Source MCP 서버인 Toolbox 기반
  • DB 접속/쿼리 도구를 안전하게 구성
  • 연결 풀링, 인증, 권한제어 등 처리

✅ 설정 방법

  1. toolbox-core 패키지 설치
  1. MCP 서버 실행 후 도구 불러오기

✅ 고급 기능

  • OIDC 기반 인증 매개변수 바인딩
  • 사용자 토큰 기반 호출 권한 제어
  • OpenTelemetry 연동으로 메트릭/트레이싱 수집

✅ 종합 요약

도구주요 사용처인증 방식특징
APIHubToolset 사내 API 호출 (Apigee API) Access Token, API Key, 서비스 계정 OpenAPI 기반 자동 연동
ApplicationIntegrationToolset 엔터프라이즈 앱 연동, Workflow 실행 서비스 계정 or OAuth2 Connectors + Triggers 지원
Toolbox for DB DB 쿼리 자동화 (MCP 서버 기반) 서버 인증 및 사용자 권한 고급 인증/감사 기능 내장
 

'ADK(Agent Development Kit) 관련' 카테고리의 다른 글

ADK Tool - OpenAPI  (2) 2025.07.08
ADK Tool - MCP  (1) 2025.07.07
ADK Tool - Third-Party Tool  (1) 2025.07.04
ADK Tool - Built-in Tools  (1) 2025.07.03
ADK Tool - Function Tool, Long Running Function Tool, Agent-as-a-Tool  (0) 2025.07.02