---
title: "Google ADK: 기능, 버전, Quickstart · DotsAgent"
description: "Google의 Google ADK: 라이선스, 최신 버전, MCP 지원, 내구성 있는 실행, 사람의 승인, 추적 및 평가 기능을 확인하고 복사해 쓸 수 있는 Quickstart를 살펴보세요."
url: https://dotsagent.io/ko/frameworks/google-adk
---

프레임워크 · 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](https://github.com/google/adk-python) · 별 21,687개
- **호스팅 옵션**: [Agent Runtime on Gemini Enterprise Agent Platform (formerly Vertex AI Agent Engine); also Cloud Run, GKE](https://docs.cloud.google.com/gemini-enterprise-agent-platform/build/runtime/quickstart-adk)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 출처](https://google.github.io/adk-docs/get-started/python/)

### 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 출처](https://google.github.io/adk-docs/)

## 기능

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

## 같은 언어로 만든 대안

- [OpenAI Agents SDK](https://dotsagent.io/ko/frameworks/openai-agents-python)

- [OpenAI Agents SDK (JS)](https://dotsagent.io/ko/frameworks/openai-agents-js)

- [Claude Agent SDK](https://dotsagent.io/ko/frameworks/claude-agent-sdk)

- [Microsoft Agent Framework](https://dotsagent.io/ko/frameworks/microsoft-agent-framework)

- [LangGraph](https://dotsagent.io/ko/frameworks/langgraph)

- [CrewAI](https://dotsagent.io/ko/frameworks/crewai)

## 출처

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

AI 에이전트를 만드는 개발자를 위한 독립적인 참고 자료입니다. 여기에 언급된 어떤 업체와도 제휴 관계가 없습니다.

© 2026 DotsAgent · 정보 확인일: 2026년 10월 1일
