google/adk-python

O que é?

Recursos principais

• 01Runtime de Workflow baseado em grafo, com roteamento, loops, novas tentativas e gerenciamento de estado
• 02Task API para delegação estruturada entre agentes
• 03Hierarquias multiagente compostas por agentes especializados
• 04Ecossistema de ferramentas que inclui funções personalizadas, especificações OpenAPI e ferramentas MCP
• 05Fluxo de confirmação de ferramentas para aprovação humana antes da execução
• 06Interface web de desenvolvimento integrada, CLI e comando de avaliação

Casos de uso

• Criar uma aplicação multiagente em que agentes especializados cuidam de diferentes subtarefas
• Criar agentes baseados em Gemini que chamam APIs externas por meio de ferramentas OpenAPI ou MCP
• Testar e avaliar o comportamento de agentes com arquivos evalset reproduzíveis
• Implantar um agente como contêiner no Cloud Run ou executá-lo localmente com Docker

Início rápido

1. 1

   Instale a versão estável do PyPI

   pip install google-adk
2. 2

   Crie um arquivo de agente com um root_agent (copie o exemplo de Agent do README)

3. 3

   Execute o agente na CLI interativa

   adk run path/to/my_agent

Antes de usar

• !É otimizado para Gemini, e alguns recursos exigem credenciais do Google Cloud ou do Gemini.
• !Requer Python 3.11 ou superior.
• !A versão de desenvolvimento em main pode conter alterações experimentais ou bugs.

Tópicos

Perguntas frequentes

O que é adk-python?

Framework Python code-first do Google para criar, avaliar e implantar agentes de IA, otimizado para Gemini, mas independente de modelo. O Agent Development Kit (ADK) é um framework modular em Python que aplica práticas de desenvolvimento de software à criação de agentes de IA. Você define a lógica dos agentes, as ferramentas e a orquestração diretamente em Python, mantendo os agentes testáveis e com controle de versão. Ele é otimizado para Gemini, mas também funciona com outros modelos e frameworks.

adk-python é gratuito? Qual é a licença?

adk-python é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

adk-python ainda é mantido?

Manutenção ativa. O último commit de adk-python foi em 20 de out. de 2026.

Para que posso usar adk-python?

Criar uma aplicação multiagente em que agentes especializados cuidam de diferentes subtarefas Criar agentes baseados em Gemini que chamam APIs externas por meio de ferramentas OpenAPI ou MCP Testar e avaliar o comportamento de agentes com arquivos evalset reproduzíveis Implantar um agente como contêiner no Cloud Run ou executá-lo localmente com Docker

Como instalar adk-python?

Instale a versão estável do PyPI: pip install google-adk Crie um arquivo de agente com um root_agent (copie o exemplo de Agent do README) Execute o agente na CLI interativa: adk run path/to/my_agent

Onde consigo adk-python?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/google/adk-python