1. O que você vai aprender
Bem-vindo à aula avançada do ADK: sua jornada para sistemas multiagentes
Você está prestes a entrar no incrível mundo dos agentes de IA. Esqueça os chatbots simples que apenas respondem a perguntas. Vamos nos aprofundar no Agent Development Kit (ADK) para criar sistemas sofisticados e autônomos que podem raciocinar, planejar e usar ferramentas para realizar tarefas complexas.
Ao final deste tutorial, você poderá:
- Criar seu primeiro agente de IA: comece do zero e crie um agente totalmente funcional que possa entender as necessidades de um usuário, usar ferramentas como a Pesquisa Google e gerar respostas detalhadas e úteis.
- Construir sistemas multiagentes: aprenda o padrão "Agente como ferramenta", um conceito revolucionário em que os agentes delegam tarefas a outros agentes especializados, criando uma equipe de especialistas em IA que trabalham juntos.
- Orquestrar fluxos de trabalho complexos: vá além da delegação simples e domine padrões avançados, como roteadores, cadeias sequenciais, loops e execução paralela, para criar aplicativos robustos, eficientes e inteligentes que possam lidar com quase todos os pedidos.
- Dar memória aos seus agentes: entenda o papel fundamental da memória conversacional, permitindo que seus agentes lidem com perguntas de acompanhamento, aprendam com o feedback e gerenciem tarefas de várias etapas sem problemas.
- Conectar-se ao MCP: conecte-se à caixa de ferramentas do MCP.
Vamos começar! 🚀
2. Configurar o GCP e a chave da API Gemini
Como configurar seu projeto do GCP e a chave da API Gemini
Para ativar nossos agentes de IA, precisamos de duas coisas: um projeto do Google Cloud para fornecer a base e uma chave da API Gemini para acessar os modelos avançados do Google.
Etapa 1: ativar a conta de faturamento
Para executar este codelab, você precisa de uma conta de faturamento com algum crédito. Use os créditos do banner na parte de cima deste codelab para começar. Se você já estiver conectado a uma conta de faturamento, pule esta etapa.
Etapa 2: criar um novo projeto do GCP
- Acesse o console do Google Cloud e crie um projeto.
- Acesse o console do Google Cloud e crie um projeto.
- Abra o painel esquerdo, clique em
Billinge verifique se a conta de faturamento está vinculada a essa conta do GCP.
Se você vir esta página, marque a opção manage billing account, escolha a versão de teste do Google Cloud e vincule a ela.
Etapa 3: encontrar o ID do projeto do Google Cloud
👉Clique em Ativar o Cloud Shell na parte de cima do console do Google Cloud (é o ícone em formato de terminal na parte de cima do painel do Cloud Shell), 
👉Clique no botão "Abrir editor" (parece uma pasta aberta com um lápis). Isso vai abrir o editor de código do Cloud Shell na janela. Um explorador de arquivos será mostrado no lado esquerdo. 
👉Encontre o ID do projeto do Google Cloud:
- Abra o console do Google Cloud: link
- Selecione o projeto que você quer usar neste workshop no menu suspenso na parte de cima da página.
- O ID do projeto é mostrado no card de informação do projeto no painel.
👉💻 No terminal, verifique se você já está autenticado e se o projeto está definido como o ID do projeto usando o comando a seguir:
gcloud auth list
👉💻 Clone o projeto de inicialização do GitHub:
git clone https://github.com/cuppibla/adk_tutorial.git
👉💻 Execute o script de inicialização. Ele vai pedir que você insira o ID do projeto do Google Cloud. Insira o ID do projeto do Google Cloud encontrado na última etapa quando solicitado pelo script setup_venv.sh.
cd ~/adk_tutorial
./setup_venv.sh
gcloud services enable compute.googleapis.com \
artifactregistry.googleapis.com \
run.googleapis.com \
iam.googleapis.com \
aiplatform.googleapis.com \
cloudresourcemanager.googleapis.com
3. Sessão 1: seu primeiro agente na Web do ADK
Abra a Web do ADK executando:
cd ~/adk_tutorial
source .adk_env/bin/activate
adk web
Depois de executar os comandos, você verá uma saída no terminal indicando que o servidor da Web do ADK foi iniciado, semelhante a esta:
+-----------------------------------------------------------------------------+
| ADK Web Server started |
| |
| For local testing, access at http://localhost:8000. |
+-----------------------------------------------------------------------------+
INFO: Application startup complete.
INFO: Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)
👉 Em seguida, para acessar a interface de desenvolvimento do ADK no navegador:
No ícone de visualização da Web (geralmente parece um olho ou um quadrado com uma seta) na barra de ferramentas do Cloud Shell (geralmente no canto superior direito), selecione "Alterar porta". Na janela pop-up, defina a porta como 8000 e clique em "Alterar e visualizar". O Cloud Shell vai abrir uma nova guia ou janela do navegador mostrando a interface de desenvolvimento do ADK.
👉 Seu ritual de invocação está concluído, e o agente está em execução. A interface de desenvolvimento do ADK no navegador é sua conexão direta com o Familiar.
Escolha o agente de fluxo de trabalho paralelo No menu suspenso na parte de cima da interface, escolha parallel_agent.
Você pode selecionar o single_agent aqui: 
Você pode conferir o rastreamento aqui: 
👉 Comando de teste:
Plan a trip from Sunnyvale to San Francisco this weekend, I love food and art.
4. Sessão 2: agente de fluxo de trabalho: agente sequencial, agente paralelo, agente de loop
Agente paralelo
Escolha o agente de fluxo de trabalho paralelo No menu suspenso na parte de cima da interface, escolha parallel_agent.
👉 Comando de teste:
Plan my trip to San Francisco, I want to find some good concert, restaurant and museum.
Você pode selecionar o parallel_agent aqui: 
Você pode conferir o rastreamento aqui: 
Agente sequencial
Escolha o agente de fluxo de trabalho sequencial No menu suspenso na parte de cima da interface, escolha sequential_agent.
👉 Comando de teste:
Find a good sushi near Standford and tell me how to get there.
Você pode selecionar o sequential_agent aqui: 
Você pode conferir o rastreamento aqui: 
Agente de loop
Escolha o agente de fluxo de trabalho de loop No menu suspenso na parte de cima da interface, escolha loop_agent.
👉 Comando de teste:
Plan a trip from Sunnyvale to San Francisco today.
Você pode selecionar o loop_agent aqui: 
Você pode conferir o rastreamento aqui: 
5. Sessão 3: agente personalizado
Depois que a interface da Web do ADK for aberta, você poderá selecionar o agente Custom_Agent.
👉 Comando de teste:
Plan a trip from Sunnyvale to San Francisco this weekend, I love food and art. Make sure within budget of 100 dollars.
Você pode selecionar o Custom_Agent aqui: 
Você pode conferir o rastreamento aqui: 
6. Sessão 4: padrão de orquestrador: agente de roteamento
Depois que a interface da Web do ADK for aberta, você poderá selecionar o routing_agent.
👉 Comando de teste:
Plan a trip from Sunnyvale to San Francisco this weekend, I love concert, restaurant and museum.
Você pode selecionar o routing_agent aqui: 
Você pode conferir o rastreamento aqui: 
7. Sessão 5: agente como ferramenta
Depois que a interface da Web do ADK for aberta, você poderá selecionar o agente Agent_as_tool.
👉 Comando de teste:
Plan a trip from Sunnyvale to San Francisco this weekend, I love concert, restaurant and museum.
Você pode selecionar o agent_as_tool aqui: 
Você pode conferir o rastreamento aqui: 
8. Sessão 6: agente com memória de longo prazo
👉💻 Para testar sua memória de longo prazo, acesse a pasta e use o executor para turbinar o agente:
cd ~/adk_tutorial
source .adk_env/bin/activate
cd ~/adk_tutorial/f_agent_with_memory
python main.py
👉 Comando de teste:
I like Art and Italian food.
Em seguida, encerre a sessão pressionando "crtl+C". Reinicie a sessão:
cd ~/adk_tutorial
source .adk_env/bin/activate
cd ~/adk_tutorial/f_agent_with_memory
python main.py
👉 Comando de teste:
Plan a trip to San Francisco based on my preference.
9. Sessão 7: capacite seu agente com o MCP
Etapa 1: preparar o banco de dados local
👉💻 Execute o comando a seguir no terminal.
cd ~/adk_tutorial
source .adk_env/bin/activate
chmod +x setup_trip_database.py
./setup_trip_database.py
Etapa 2: instalar e executar o servidor da caixa de ferramentas do MCP
👉💻 Execute o comando a seguir no terminal.
cd ~/adk_tutorial/mcp_tool_box
export VERSION=0.16.0
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v$VERSION/linux/amd64/toolbox
Depois de concluir o download, execute
chmod +x toolbox
Etapa 3
Em um terminal , execute o comando a seguir.
cd ~/adk_tutorial
source .adk_env/bin/activate
cd ~/adk_tutorial/mcp_tool_box
./toolbox --tools-file "trip_tools.yaml" --port 7001
Em outro terminal , execute o comando a seguir.
cd ~/adk_tutorial
source .adk_env/bin/activate
cd ~/adk_tutorial/g_agents_mcp
python main.py