Como instalar o Google ADK para construir multiagentes no Windows 11

Um ADK ou Agent Development Kit fornece ferramentas para construir agentes de IA. O Google revelou o Google ADK. O Google ADK integra-se comvários modelos de IA, incluindo o Gemini do Google, para oferecer recursos como arquitetura modular, orquestração flexível e ferramentas de avaliação integradas. Neste post vamos ver como você podeinstale o Google ADK para criar multiagentes no Windows 11/10.

Quais são os pré-requisitos para o Google ADK?

Os pré-requisitos para o Google ADK incluem ter o Python versão 3.9 ou superior instalado e configurado corretamente. Você também precisará de um IDE como VS Code ou PyCharm para desenvolvimento e um terminal funcional para executar comandos de forma eficaz. Certifique-se de que a variável PATH do seu sistema esteja configurada corretamente para Python.

Instale o Google ADK para criar multiagentes no Windows 11/10

Para instalar o Google ADK para construir multiagentes, você precisa seguir as etapas mencionadas abaixo.

1. Instale o Google ADK
2. Configure seu ambiente
3. Importar Google ADK
4. Execute o agente

Vamos discuti-los em detalhes.

1] Instale o Google ADK

Primeiro de tudo, precisamos instalar o Google ADK em nosso sistema. Mesmo que o código-fonte esteja hospedado emgithub.com, podemos simplesmente seguir o caminho mais fácil para instalar o aplicativo executando o seguinte comando no modo elevado do prompt de comando.

pip install google-adk

Isso levará um pouco de tempo para instalar. Depois que o ADK estiver instalado, vá para a próxima etapa.

2] Configure seu ambiente

Agora que temos o ADK à nossa disposição, vamos montar o ambiente do nosso projeto. Para fazer isso, você precisa abrir outra sessão do Prompt de Comando, desta vez, não em modo elevado, e ir para qualquer diretório de sua escolha. Fomos para a área de trabalho usando o seguinte comando e criamos outro diretório lá.

cd Desktop

mkdir sample_agents

cd sample_agents

Agora, para montar o projeto,execute o UV init.

Agora você pode correrdiretóriopara ver se todos os arquivos estão colocados dentro da pasta ou não.Você pode conferir a captura de tela anexada para saber os arquivos necessários. Para executar o programa a ser testado, execute –uv execute main.py

Uma vez feito isso, precisaríamos instalar um modelo LLM. Para o bem deste tutorial, vamos comLiteLLM.Execute o seguinte comando para fazer o mesmo.

pip install litellm

Tenha em mente que como estamos instalando o serviço sem um modo elevado de CMD, ele será instalado apenas para o usuário atual.

Para adicioná-lo ao nosso projeto, execute –uv adicione litellm.

Ler:: Guia para iniciantes da Microsoft

3]Importar Google ADK

Para esta etapa, precisamos de um IDE. Estaremos usandomas fique à vontade para usar qualquer IDE de sua escolha. Portanto, abra o VS Code e abra sua pasta.

Em nosso primeiro método, precisamos excluir oprincipal.pyarquivo, pois não é necessário, então clique com o botão direito nele e selecioneExcluir.Em seguida, crie outro arquivo Python e nomeie-oagente.py.Assim que o arquivo agent.py estiver aberto, precisamos importar o Google ADK. Para começar, você pode executar a seguinte linha de código.

from google.adk.agents import Agent

from google.adk.models.lite_llm import LiteLLM

E então podemos escrever nosso código do zero. Certifique-se de especificar seu modelo de IA, você pode usar Ollama, por exemplo, e então adicionar um agente raiz, usando a seguinte sintaxe.

root_agent = Agent(

Write your code here

)

Você pode especificar o modo, a descrição e as instruções dentro do contêiner root_agent.

Alternativamente, em vez de excluir oarquivo main.py,copie e cole o seguinte código de exemplo nele.

import datetime
from google.adk.agents import Agent

def get_trivia(topic: str) -> dict:
"""Provides trivia information about a specified topic.

Args:
topic (str): The topic for which to retrieve trivia.

Returns:
dict: status and result or error msg.
"""
trivia_data = {
"space": "Did you know? A day on Venus is longer than a year on Venus.",
"technology": "The first computer virus was created in 1986 and was called 'Brain.'",
"history": "The Great Wall of China is the largest man-made structure in the world.",
}

topic = topic.lower()
if topic in trivia_data:
return {
"status": "success",
"report": trivia_data[topic],
}
else:
return {
"status": "error",
"error_message": f"Trivia information for '{topic}' is not available.",
}

root_agent = Agent(
name="trivia_agent",
model="gemini-2.0-flash",
description=(
"An agent designed to answer trivia questions about various topics."
),
instruction=(
"You are a knowledgeable agent capable of providing trivia about different subjects."
),
tools=[get_trivia],
)

O código de exemplo mencionado anteriormente foi inspirado no código mencionado em Google.github.io.

O código cria um Trivia Agent que responde a perguntas triviais de conhecimento geral sobre um tópico específico.

Ler:Windows Driver Kit e Windows ADK agora disponíveis para Windows 11

4] Execute o agente

Agora que criamos o agente, vamos executá-lo. Para fazer isso, precisamos abrir o Terminal no VS Code e executar o seguinte comando.

adk run folder_name

Nota: O nome_da_pasta é uma variável que deve ser substituída pela pasta na qual os arquivos do agente estão armazenados.

Você também pode abrir o agente na web, usando o seguinte comando.

adk web

Isso lhe dará um hiperlink no qual você precisa clicar para executar o servidor web.

Esperamos que com a ajuda deste post você tenha uma ideia de como criar agentes usando o Google ADK. Para saber mais sobre isso, você pode acessargoogle.adk.io.

Ler:Como criar agentes de IA poderosos sem codificação?

Como instalar o Google ADK?

Para instalar o Google ADK, primeiro crie um ambiente virtual Python usandoe ative-o (venv\Scripts\activate.bat para CMD ou .\venv\Scripts\Activate.ps1 para PowerShell). Em seguida, execute pip install google-adk para instalar o ADK. Uma vez feito isso, você está pronto para iniciar o ADK. Verifique a instalação compip mostrar google-adk.

Leia também:.