diogodev_

Voltar à listagem

Conteúdo

Criando um agente com Google ADK

Com o crescimento dos agentes de IA, frameworks como o Google ADK (Agent Development Kit) surgiram para simplificar a criação de aplicações inteligentes. Com poucas linhas de código é possível criar agentes, adicionar ferramentas e testar tudo através de uma interface visual.

O que é o Google ADK?

Google ADK (Agent Development Kit) é um framework open source desenvolvido pelo Google para construção de agentes de IA em Python.

Ele fornece recursos para:

  • Criar agentes;
  • Adicionar ferramentas (tools);
  • Trabalhar com múltiplos agentes;
  • Integrar APIs externas;
  • Gerenciar memória e contexto;
  • Testar fluxos através do ADK Web.

Instalando o projeto

A instalação é simples:

pip install google-adk

Também é necessário configurar a chave da API do Gemini:

export GOOGLE_API_KEY=SEU_TOKEN

Criando o primeiro agente

Um agente básico pode ser criado em poucas linhas:

from google.adk.agents import Agent

root_agent = Agent(
    name="assistant",
    model="gemini-2.5-flash",
    description="Assistente simples",
    instruction="Responda as perguntas do usuário."
)

Nesse exemplo estamos utilizando o modelo gemini-2.5-flash, que possui ótima performance e baixo custo.

Adicionando uma Tool

Uma das características mais interessantes do ADK é a facilidade para adicionar funções ao agente.

Vamos criar uma ferramenta simples:

def get_current_year() -> int:
    """Retorna o ano atual."""
    return 2026

Agora basta registrar essa função:

root_agent = Agent(
    name="assistant",
    model="gemini-2.5-flash",
    instruction="Use as tools quando necessário.",
    tools=[get_current_year]
)

Quando o usuário perguntar:

Em que ano estamos?

O agente poderá chamar automaticamente essa função.

Estrutura do projeto

Uma organização simples poderia ser:

project/
│
├── agent.py
├── tools/
│     ├── date_tool.py
│     ├── weather_tool.py
│     └── search_tool.py
│
├── prompts/
│     └── system_prompt.txt
│
└── .env

Essa divisão facilita a manutenção do projeto.

Utilizando modelos gratuitos

Durante estudos e prototipação é possível utilizar modelos gratuitos do Gemini.

Alguns exemplos:

  • gemini-2.5-flash
  • gemini-2.5-flash-lite
  • gemini-2.5-pro

Esses modelos oferecem excelente qualidade para testes e desenvolvimento.

Testando com ADK Web

Um dos recursos mais interessantes é a interface web do framework.

Basta executar:

adk web

Uma interface será iniciada localmente.

Nela é possível:

  • Conversar com o agente;
  • Visualizar o histórico;
  • Ver quando as tools são chamadas;
  • Entender o fluxo de execução;
  • Depurar comportamentos.

Exemplo prático

Imagine um agente de suporte.

Ele possui três ferramentas:

tools = [
    get_current_year,
    get_user_by_id,
    get_orders
]

Fluxo:

Usuário
     ↓
Agente
     ↓
Pergunta
     ↓
Tool necessária
     ↓
Resposta

Se o usuário perguntar:

Quais pedidos o cliente 10 possui?

O agente poderá utilizar get_orders() para obter os dados e construir a resposta.

Trabalhando com múltiplos agentes

Outra funcionalidade interessante é a possibilidade de criar agentes especializados.

Por exemplo:

Supervisor Agent
      ↓
┌────────────┬────────────┬────────────┐
│ Financeiro │ Vendas     │ Suporte    │
└────────────┴────────────┴────────────┘

Cada agente possui responsabilidades específicas.

Boas práticas

Crie tools pequenas

Prefira funções específicas e simples.

Por exemplo:

get_orders()

get_customer()

get_invoice()

Ao invés de:

process_everything()

Escreva boas descrições

As docstrings ajudam o modelo a entender quando utilizar cada ferramenta.

def get_weather(city: str):
    """
    Retorna a temperatura atual da cidade.
    """

Mantenha o prompt simples

Prompts muito grandes podem dificultar o comportamento do agente.

Teste frequentemente

O ADK Web é excelente para validar chamadas de tools e ajustar o fluxo.

Vantagens do Google ADK

  • Fácil de utilizar;
  • Integração nativa com Gemini;
  • Suporte a múltiplos agentes;
  • Ferramentas customizadas;
  • Interface visual para testes;
  • Código simples e organizado.

Quando utilizar?

Google ADK é uma excelente escolha para:

  • Assistentes inteligentes;
  • Chatbots;
  • Agentes corporativos;
  • Integração com APIs;
  • Ferramentas internas;
  • Estudos sobre agentes de IA.

Conclusão

Google ADK é uma ótima opção para quem deseja começar a desenvolver agentes de IA utilizando Python. Sua simplicidade, integração com modelos Gemini e interface visual tornam o processo de desenvolvimento muito mais intuitivo.

Com poucas linhas de código já é possível criar agentes capazes de utilizar ferramentas e executar tarefas complexas, tornando o ADK uma excelente alternativa para aprendizado e prototipação.

Saiba mais