Apresentando a documentação e os pré-requisitos do Google ADK
Documentação oficial do Google ADK
Esta é a documentação oficial do Google ADK. Podemos acessá-la pesquisando por adk.dev no Google. Ao entrar, encontraremos a documentação do ADK e diversos conteúdos relevantes, incluindo integração, referências, comunidade, entre outros.
Linguagens suportadas
O Google ADK pode ser utilizado com cinco linguagens de programação: Python, TypeScript, Go, Java e Kotlin. Neste curso, nós utilizaremos Python.
Requisitos para Python
Para usar Python com o Google ADK, precisamos da versão mínima 3.10. Ou seja, com Python 3.10 ou superior já podemos utilizar o Google ADK.
Instalação e gerenciador de pacotes
Para instalar o Google ADK, precisamos de um gerenciador de pacotes. Na documentação oficial, é utilizado o pip. Nós utilizaremos o uv, pois é mais completo, consideravelmente mais rápido e é o gerenciador que usamos no dia a dia de desenvolvimento. Recomendamos adotá-lo também, porque é muito mais rápido e mais completo do que o pip.
Apresentando o Agency Ally e suas habilidades
Agency Ally
A documentação do ADK, fornecida pela Google, apresenta um recurso muito interessante: o Agency Ally. O Agency Ally é um pacote de habilidades, ou seja, um pacote de skills (habilidades), para criar, avaliar e implementar agentes de IA no Google Cloud. Os agentes são criados com o ADK, e o Agency Ally se encarrega de toda a parte relacionada à estruturação, avaliação, implementação e observabilidade.
Aumentamos o zoom para facilitar a visualização.
Para usar o Agency Ally, podemos trabalhar com um agente de codificação — por exemplo, um antigraft, o Cloud Code, o Codex e assim por diante — ou, sem um agente de codificação, executar os comandos diretamente no terminal.
O Agency Ally inclui sete habilidades que nos proporcionarão uma atuação aprofundada em todo o ciclo de vida do ADK.
Habilidades e ciclo de vida do ADK
Essas habilidades estão documentadas na própria documentação do Agency Ally. Recomendamos analisá-las e compreendê-las. Elas abrangem:
- Ciclo de vida de desenvolvimento
- Preservação de código
- Seleção do modelo
- API
- ADK Python
- Agentes
- Ferramentas
- Orquestração
- Callbacks (retornos de chamada)
Em resumo, cobrindo todo o ciclo de vida do ADK, essas habilidades nos auxiliarão no desenvolvimento.
Planejando o ambiente e ferramentas de desenvolvimento
Faremos a instalação disso na próxima aula. Porém, um ponto importante é que, no dia a dia, normalmente usamos um agente de codificação. Por quê? Porque isso facilita muito nosso trabalho, acelera a construção de agentes, garante que não implantemos agentes com erros e problemas, e ainda permite desenvolver agentes de uma forma melhor. Por isso, utilizamos um agente de codificação.
Como estamos falando de uma infraestrutura completa da Google — o Google ADK é da Google e o Agency Ally é da Google —, nós usaremos o Antigravity CLI. Por quê? No nosso aprendizado do Google ADK, estudando a própria documentação da Google e, principalmente, nas formações da Google, a recomendação é usar o Antigravity junto com o Agency Ally para construir agentes. Isso facilita muito a criação de agentes e acelera bastante o processo. Portanto, usaremos o Antigravity CLI.
Se pesquisarmos por antigravity.google no Google, chegaremos à página de documentação do Antigravity. Nessa página, basicamente, há alguns produtos que a Google oferece: Antigravity 2.0, Antigravity CLI, IDE (Ambiente de Desenvolvimento Integrado) e SDK (Kit de Desenvolvimento de Software). Usaremos a CLI (Interface de Linha de Comando).
Na próxima aula, ensinaremos como instalar o Antigravity, como instalar o Agency Ally e também instalaremos com vocês o uv. Instalaremos tudo. Mencionamos isso porque é bastante importante. Atualmente, ao desenvolver aplicações de agentes, ou qualquer aplicação, usar inteligência artificial facilita, acelera e garante padronização e uma melhor entrega de aplicações.
Usaremos o Antigravity como gerador de código, o Agency Ally com habilidades para nos ajudar a seguir o padrão de desenvolvimento do Google ADK, o uv para a gestão de pacotes e nosso IDE de desenvolvimento será o VS Code. Nós usaremos o VS Code.
Um ponto importante: estamos usando o WSL2 como nosso ambiente para usar o VS Code e instalar tudo. Fique à vontade para usar o que preferir; as documentações mostram como instalar no seu próprio sistema operacional. Usaremos o WSL2 dentro do Windows.
Na próxima aula, faremos a instalação de tudo isso.