GML016

Visão geral

Os modelos de linguagem grandes (LLMs, na sigla em inglês) são potentes, mas têm duas limitações consideráveis: o conhecimento deles é fixo no momento do treinamento e eles não podem interagir com o mundo externo para acessar dados em tempo real ou realizar ações como agendar uma reunião ou atualizar o registro de um cliente.

É aqui que o Protocolo de Contexto de Modelo (MCP, na sigla em inglês) entra em ação. O MCP é um padrão aberto criado para resolver as limitações dos LLMs.

Por que usar o MCP?

O MCP fornece uma "linguagem" segura e padronizada para que LLMs se comuniquem com dados, aplicativos e serviços externos. Ele funciona como uma ponte, impulsionando os agentes de IA a ir além do conhecimento estático e se tornarem dinâmicos. Com o MCP, eles podem buscar informações atualizadas e agir, tornando-os mais precisos, úteis e automatizados.

Este laboratório fornece instruções detalhadas para instalar o Kit de Desenvolvimento de Agente (ADK, na sigla em inglês), adaptar um agente do ADK para usar o MCP e implantar o agente atualizado para inicializar uma sessão interativa pela interface de linha de comando.

Objetivos

Neste laboratório, você aprenderá a fazer o seguinte:

• Instalar o Kit de Desenvolvimento de Agente (ADK) e criar um ambiente virtual para seu projeto.
• Testar o sistema do agente de moeda (o "antes").
• Modificar o agente para usar um servidor MCP.
• Reiniciar o servidor MCP e o agente para que as mudanças entrem em vigor.
• Verificar as mudanças feitas no servidor MCP (o "depois").

Configuração e requisitos

• Os laboratórios são cronometrados e não podem ser pausados. O timer começa quando você clica em Iniciar laboratório.
• O terminal de nuvem incluído já vem pré-configurado com o SDK gcloud.
• Use o terminal para executar comandos e clique em Verificar meu progresso para conferir seu trabalho.

Configure o ambiente e instale as dependências relevantes

1. Execute o comando a seguir no terminal para copiar arquivos de código de um bucket do Cloud Storage para este laboratório:

   gcloud storage cp -r gs://{{{project_0.project_id| YOUR_GCP_PROJECT_ID}}}-bucket/currency-agent .

2. Configure o ambiente e crie o arquivo .env no diretório do agente de moeda usando os seguintes comandos:

   cd currency-agent cp /home/student/keys.json . uv venv --python 3.13 source .venv/bin/activate uv sync touch .env echo "GOOGLE_CLOUD_PROJECT={{{ project_0.project_id }}}" >> .env echo "GOOGLE_CLOUD_LOCATION=global" >> .env echo "GOOGLE_GENAI_USE_VERTEXAI=True" >> .env echo "MODEL={{{project_0.startup_script.gemini_flash_model_id | gemini_flash_model_id}}}" >> .env

Tarefa 1: instalar o Kit de Desenvolvimento de Agente (ADK)

1. Em um novo terminal (selecione Terminal > Novo terminal na barra de menus ou pressione CTRL+SHIFT+') e inicie o servidor MCP usando os seguintes comandos:

   cd currency-agent uv run mcp-server/server.py

2. Em um novo terminal (selecione Terminal > Novo terminal na barra de menus ou pressione CTRL+SHIFT+'), inicie o servidor A2A (ele é iniciado na porta 10000) usando os seguintes comandos:

   cd currency-agent uv run uvicorn currency_agent.agent:a2a_app --host localhost --port 10000

Tarefa 2: executar o agente de valor de referência (o "antes")

1. Na sua instância de terminal inicial, inicie o agente de moeda usando os seguintes comandos:

   adk run currency_agent

2. Interaja com o agente usando este comando:

   What's the exchange rate between USD and EUR?

   O agente vai informar a taxa de câmbio em tempo real entre o dólar americano e o euro.

3. Teste outro comando:

   What's the exchange rate between USD and CNY?

   O agente vai informar a taxa de câmbio em tempo real entre o dólar americano e o yuan chinês.

4. Interaja com o agente usando este comando:

   What's the price of Bitcoin?

   Com base na resposta, você verá que o agente só conhece moedas fiduciárias (ou seja, não pode fornecer dados atuais sobre criptomoedas).

Tarefa 3: modificar o agente

Nesta tarefa, você vai modificar o agente de moeda para usar o servidor Protocolo de Contexto de Modelo (MCP). Pense nisso como uma maneira de chamar um "servidor de moeda" separado (pela API Coinbase, disponível para o público) para receber taxas a que o agente não teria acesso de outra forma.

1. Clique no ícone Buscador de arquivos no painel à esquerda e navegue até a pasta do projeto currency-agent/mcp-server.

2. No Buscador de arquivos, dentro do diretório mcp-server, abra o arquivo server.py, insira o código a seguir na linha 52 e salve as mudanças:

   @mcp.tool() def get_crypto_price(currency_pair: str = "BTC-USD") -> dict: """Receber o preço atual de um par de criptomoedas.""" # Não é necessário usar uma chave de API para este endpoint público url = f"https://api.coinbase.com/v2/prices/{currency_pair}/spot" response = httpx.get(url) return response.json()["data"]

Tarefa 4: reiniciar os servidores MCP e A2A

1. Mude para a instância do terminal em que o servidor MCP ainda está em execução.

2. Pressione CTRL+C para interromper o servidor.

3. Ainda no mesmo terminal, execute o comando a seguir para reiniciar o servidor MCP:

   uv run mcp-server/server.py

4. Mude para a instância de terminal em que o servidor A2A ainda está em execução.

5. Pressione CTRL+C para interromper o servidor.

6. Ainda nesse terminal, execute o seguinte comando para reiniciar o agente:

   uv run uvicorn currency_agent.agent:a2a_app --host localhost --port 10000

Tarefa 5: executar e testar o agente atualizado (o "depois")

1. Mude para a instância do terminal em que o currency_agent estava sendo executado.

2. Digite sair para encerrar a sessão original.

3. Use o comando a seguir para executar o agente outra vez e testá-lo:

   adk run --save_session currency_agent Observação: ignore os avisos relacionados a dependências da versão do Python.

4. Use este seguinte comando para interagir com o agente:

   Use the get_crypto_price tool to get me the current price of Bitcoin.

O agente agora tem acesso à ferramenta get_crypto_price (via MCP), que permite responder a perguntas sobre mais do que apenas moedas fiduciárias.

5. Digite sair e insira 1 quando receber a solicitação para informar o ID da sessão.

Clique em Verificar meu progresso para conferir o objetivo. Modificar um agente do ADK para usar o MCP.

Parabéns!

Você implantou um agente do ADK e o modificou para usar o servidor Protocolo de Contexto de Modelo (MCP).

Manual atualizado em 21 de janeiro de 2026

Laboratório testado em 21 de janeiro de 2026

Copyright 2026 Google LLC. Todos os direitos reservados. Google e o logotipo do Google são marcas registradas da Google LLC. Todos os outros nomes de produtos e empresas podem ser marcas registradas das respectivas empresas a que estão associados.