google/adk-python

어떤 프로젝트인가요?

핵심 기능

• 01라우팅·루프·재시도·상태 관리를 지원하는 그래프 기반 Workflow 런타임
• 02에이전트 간 구조화된 위임을 위한 Task API
• 03전문 에이전트를 조합해 구성하는 멀티 에이전트 계층 구조
• 04사용자 정의 함수, OpenAPI 사양, MCP 도구를 포함하는 도구 생태계
• 05실행 전에 사람의 승인을 받는 도구 확인 절차
• 06개발용 웹 UI, CLI, 평가 명령 기본 제공

활용 사례

• 전문 에이전트가 서로 다른 하위 작업을 처리하는 멀티 에이전트 애플리케이션 구축
• OpenAPI 또는 MCP 도구를 통해 외부 API를 호출하는 Gemini 기반 에이전트 제작
• 반복 가능한 evalset 파일로 에이전트 동작을 테스트하고 평가
• 에이전트를 컨테이너로 Cloud Run에 배포하거나 Docker로 로컬에서 실행

빠른 시작

1. 1

   PyPI에서 안정 버전을 설치하세요

   pip install google-adk
2. 2

   root_agent가 포함된 에이전트 파일을 만드세요(README의 Agent 예제를 복사하세요)

3. 3

   대화형 CLI에서 에이전트를 실행하세요

   adk run path/to/my_agent

사용 전 알아둘 점

• !Gemini에 최적화되어 있으며, 일부 기능에는 Google Cloud 또는 Gemini 인증 정보가 필요합니다.
• !Python 3.11 이상이 필요합니다.
• !main의 개발 버전에는 실험적인 변경 사항이나 버그가 포함될 수 있습니다.

토픽

자주 묻는 질문

adk-python은(는) 무엇인가요?

Google의 코드 우선 Python 프레임워크로, Gemini에 최적화되어 있지만 특정 모델에 종속되지 않으며 AI 에이전트를 구축·평가·배포할 수 있습니다. Agent Development Kit(ADK)는 소프트웨어 개발 방식을 AI 에이전트 제작에 적용한 모듈형 Python 프레임워크입니다. 에이전트의 로직, 도구, 오케스트레이션을 Python에서 직접 정의하므로 에이전트를 테스트하고 버전 관리하기 쉽습니다. Gemini에 최적화되어 있지만 다른 모델 및 프레임워크도 지원합니다.

adk-python은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

adk-python은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

adk-python은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. adk-python의 마지막 커밋은 2026년 10월 20일입니다.

adk-python은(는) 어디에 사용할 수 있나요?

전문 에이전트가 서로 다른 하위 작업을 처리하는 멀티 에이전트 애플리케이션 구축 OpenAPI 또는 MCP 도구를 통해 외부 API를 호출하는 Gemini 기반 에이전트 제작 반복 가능한 evalset 파일로 에이전트 동작을 테스트하고 평가 에이전트를 컨테이너로 Cloud Run에 배포하거나 Docker로 로컬에서 실행

adk-python는 어떻게 설치하나요?

PyPI에서 안정 버전을 설치하세요: pip install google-adk root_agent가 포함된 에이전트 파일을 만드세요(README의 Agent 예제를 복사하세요) 대화형 CLI에서 에이전트를 실행하세요: adk run path/to/my_agent

adk-python은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/google/adk-python