프레임워크 · Google
Google ADK 한눈에 보기
Google의 Agent Development Kit은 Python, TypeScript, Go, Java, Kotlin용 SDK를 제공하며 평가 기능이 핵심에 내장되어 있습니다. Gemini를 우선 지원하지만 어댑터를 통해 다른 모델도 사용할 수 있으며, Google Cloud의 Agent Runtime에 배포할 수 있습니다.
추천 용도: 여러 언어를 사용하는 팀에서 Gemini 우선 에이전트와 내장 평가 기능을 활용하고 Google Cloud에 바로 배포하려는 경우.
주요 정보
- 관리자
- 언어
- Python, TypeScript, Go, Java, Kotlin
- 라이선스
- Apache-2.0
- 최신 버전
Python 2.10.0· 2026년 9월 25일- 저장소
- google/adk-python
- 호스팅 옵션
- Agent Runtime on Gemini Enterprise Agent Platform (formerly Vertex AI Agent Engine); also Cloud Run, GKE
Quickstart
패키지를 설치하고 인증 정보를 설정한 다음, 공식 문서에서 가장 간단한 에이전트를 실행하세요. 모델 ID는 문서에서 사용하는 값이며 계정에서 활성화되지 않았을 수 있습니다.
Python
pip install google-adk && adk create my_agent (run with: adk run my_agent or adk web --port 8000)from google.adk.agents.llm_agent import Agent
# Mock tool implementation
def get_current_time(city: str) -> dict:
"""Returns the current time in a specified city."""
return {"status": "success", "city": city, "time": "10:30 AM"}
root_agent = Agent(
model='gemini-flash-latest',
name='root_agent',
description="Tells the current time in a specified city.",
instruction="You are a helpful assistant that tells the current time in cities. Use the 'get_current_time' tool for this purpose.",
tools=[get_current_time],
)TypeScript
npm install @google/adk (inferred from package name; not copied from docs)import { LlmAgent, GOOGLE_SEARCH } from '@google/adk';
const agent = new LlmAgent({
name: 'researcher',
model: 'gemini-flash-latest',
instruction: 'You help users research topics thoroughly.',
tools: [GOOGLE_SEARCH],
});기능
| 모든 모델 | 예 | Gemini 우선 지원. LiteLLM 및 로컬 어댑터를 통해 다른 모델도 사용 가능 |
|---|---|---|
| MCP 클라이언트 | 예 | McpToolset을 제공하며, 도구별로 선택적 확인을 설정할 수 있습니다. |
| MCP 서버 | 예 | to_mcp_server()로 에이전트를 노출합니다 |
| 멀티 에이전트 | 예 | 하위 에이전트 트리와 ADK 2.0부터 지원하는 그래프 워크플로 |
| 내구성 있는 실행 | 예 | 중단된 에이전트를 재개하고, Agent Runtime으로 장기 실행 상태를 유지합니다 |
| 사람의 승인 | 예 | require_confirmation=True로 도구 사용을 확인합니다 |
| 트레이싱 | 예 | OpenTelemetry 기반이며 Google Cloud에서는 Cloud Trace를 사용합니다 |
| Evals | 예 | 평가는 ADK의 핵심 기능입니다 |
최근 변경 사항
- ADK 2.0에서 그래프 기반 워크플로가 추가됐습니다.
- Python, TypeScript, Go, Java에 이어 Kotlin SDK가 추가됐습니다.
- 문서 사이트가 adk.dev로 이전했습니다.
- Vertex AI Agent Engine의 이름이 Gemini Enterprise Agent Platform의 Agent Runtime으로 변경됐습니다.