Criando um Agente de IA com Google ADK em poucos minutos
Nos últimos dias comecei a explorar o Google ADK (Agent Development Kit), uma ferramenta criada para facilitar a construção de agentes de IA em Python.
O que mais me chamou a atenção foi a simplicidade para criar agentes, adicionar ferramentas customizadas e visualizar todo o fluxo de execução através da interface web.
Neste artigo vou mostrar como construir um agente simples capaz de responder perguntas e utilizar tools específicas.
O que é o Google ADK?
O Google ADK é um framework para criação de agentes inteligentes. Ele permite combinar modelos de linguagem com ferramentas externas, memória e fluxos mais complexos.
A ideia é que o agente possa executar tarefas além de apenas gerar texto, como:
- Buscar informações;
- Chamar APIs;
- Consultar bancos de dados;
- Executar funções customizadas;
- Trabalhar em conjunto com outros agentes.
Criando uma tool simples
Uma das características mais interessantes é a facilidade para adicionar funções que podem ser utilizadas pelo agente.
def get_current_year() -> int:
"""Retorna o ano atual."""
return 2026
Agora podemos registrar essa função como uma ferramenta disponível para o agente.
from google.adk.agents import Agent
root_agent = Agent(
name="assistant",
model="gemini-2.5-flash",
description="Assistente simples",
instruction="Responda perguntas usando as tools disponíveis",
tools=[get_current_year]
)
Se o usuário perguntar:
Em que ano estamos?
O agente poderá utilizar automaticamente a função e responder corretamente.
Utilizando modelos gratuitos
Para estudos e testes, não é necessário começar com modelos pagos.
O Google disponibiliza modelos como:
- gemini-2.5-flash;
- gemini-2.5-flash-lite;
- gemini-2.5-pro.
Com uma chave da API do Gemini é possível começar rapidamente e experimentar diferentes configurações.
Isso torna o ADK uma ótima opção para aprendizado e prototipação.
Testando com o ADK Web
Outro recurso bastante interessante é o ADK Web.
Com um simples comando:
adk web
Uma interface é iniciada localmente, permitindo:
- Conversar com o agente;
- Visualizar o histórico;
- Inspecionar chamadas de tools;
- Entender o fluxo de execução;
- Testar alterações rapidamente.
Essa visualização ajuda muito durante o desenvolvimento e facilita a depuração do comportamento do agente.
Conclusão
O Google ADK simplifica bastante a criação de agentes de IA. Em poucos minutos já é possível ter um agente funcional utilizando ferramentas customizadas e modelos gratuitos.
Além disso, a interface do ADK Web torna o processo de desenvolvimento mais intuitivo, permitindo observar como o agente raciocina e quando cada tool é utilizada.
Nos próximos estudos pretendo explorar recursos mais avançados, como múltiplos agentes, memória e integração com APIs externas.
Saiba mais
Se você quiser se aprofundar no Google ADK, estas são algumas referências oficiais:
- Google ADK Documentation
https://google.github.io/adk-docs/ - Google ADK Quickstart
https://google.github.io/adk-docs/get-started/quickstart/ - Google AI Studio
https://aistudio.google.com/ - Gemini API Documentation
https://ai.google.dev/gemini-api/docs - Google ADK GitHub
https://github.com/google/adk-python - Modelos Gemini disponíveis
https://ai.google.dev/gemini-api/docs/models
Essas referências são excelentes para explorar recursos mais avançados, como memória, múltiplos agentes, workflows e integrações externas.