dotsagent.io
언어:한국어
프레임워크 · Google

Google ADK 한눈에 보기

Google의 Agent Development Kit은 Python, TypeScript, Go, Java, Kotlin용 SDK를 제공하며 평가 기능이 핵심에 내장되어 있습니다. Gemini를 우선 지원하지만 어댑터를 통해 다른 모델도 사용할 수 있으며, Google Cloud의 Agent Runtime에 배포할 수 있습니다.

추천 용도: 여러 언어를 사용하는 팀에서 Gemini 우선 에이전트와 내장 평가 기능을 활용하고 Google Cloud에 바로 배포하려는 경우.

주요 정보

관리자
Google
언어
Python, TypeScript, Go, Java, Kotlin
라이선스
Apache-2.0
최신 버전
Python 2.10.0 · 2026년 9월 25일
저장소
google/adk-python · 별 21,687개
호스팅 옵션
Agent Runtime on Gemini Enterprise Agent Platform (formerly Vertex AI Agent Engine); also Cloud Run, GKE
Agent Runtime은 이전에 Vertex AI Agent Engine이었습니다. 배포 호출은 여전히 client.agent_engines.create(...)입니다.

Quickstart

패키지를 설치하고 인증 정보를 설정한 다음, 공식 문서에서 가장 간단한 에이전트를 실행하세요. 모델 ID는 문서에서 사용하는 값이며 계정에서 활성화되지 않았을 수 있습니다.

Python

설치
pip install google-adk && adk create my_agent  (run with: adk run my_agent  or  adk web --port 8000)

GOOGLE_API_KEY in my_agent/.env 필요

Python
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],
)

Quickstart 출처

TypeScript

설치
npm install @google/adk (inferred from package name; not copied from docs)

GOOGLE_API_KEY 필요

TypeScript
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],
});

Quickstart 출처

기능

모든 모델예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으로 변경됐습니다.

같은 언어로 만든 대안

출처

  1. google.github.io/adk-docs/
  2. google.github.io/adk-docs/get-started/python/
  3. adk.dev/tools-custom/confirmation/
  4. adk.dev/tools-custom/mcp-tools/advanced/
  5. adk.dev/tools-custom/mcp-tools/agent-as-server/
  6. docs.cloud.google.com/gemini-enterprise-agent-platform/vertex-ai-name-changes
  7. cloud.google.com/blog/products/ai-machine-learning/introducing-gemini-enterprise-agent
  8. docs.cloud.google.com/gemini-enterprise-agent-platform/build/runtime/quickstart-adk
  9. pypi.org/pypi/google-adk/json
  10. registry.npmjs.org/@google%2fadk
  11. api.github.com/repos/google/adk-python