Usar um agente

Como usar o SDK da Agent Platform

Ao usar o SDK da Agent Platform, o código para consultar um agente é o mesmo, seja ele executado localmente ou implantado remotamente. Como o conjunto de operações compatíveis varia entre os frameworks, fornecemos instruções de uso para modelos específicos de framework:

Framework Descrição
Kit de Desenvolvimento de Agente Projetado com base nas práticas recomendadas internas do Google para desenvolvedores que criam aplicativos de IA ou equipes que precisam criar protótipos e implantar soluções robustas baseadas em agentes rapidamente.
Agent2Agent (prévia) O protocolo Agent2Agent (A2A) é um padrão aberto criado para permitir a comunicação e a colaboração perfeitas entre agentes de IA.
LangChain Mais fácil de usar para casos de uso básicos devido às configurações e abstrações predefinidas.
LangGraph Abordagem baseada em gráficos para definir fluxos de trabalho, com recursos avançados de human-in-the-loop e de voltar/reproduzir.
AG2 (antigo AutoGen) O AG2 oferece um framework de conversa multiagente como uma abstração de alto nível para criar fluxos de trabalho de LLM.
LlamaIndex (pré-lançamento) O pipeline de consultas do LlamaIndex oferece uma interface de alto nível para criar fluxos de trabalho de geração aumentada por recuperação (RAG).
Personalizado Agentes que foram desenvolvidos e implantados sem o uso de um modelo específico do framework.
Contrato de tempo de execução Especificação da API HTTP para agentes personalizados baseados em contêineres.

Usar agentes veiculados no localhost

Se você veicular agentes por um servidor de API que está aguardando solicitações em http://localhost:PORT_NUMBER, envie solicitações para

http://localhost:PORT_NUMBER/API_PATH

em que

  • PORT_NUMBER é o número da porta em que o servidor está recebendo conexões, por exemplo, 8080.
  • API_PATH é o caminho do endpoint de API correspondente (como run ou run_sse)

Usar agentes implantados pela API subjacente

Se você implantou um agente, envie solicitações para o endpoint correspondente:

https://LOCATION-aiplatform.googleapis.com/reasoningEngines/v1/projects/PROJECT_NUMBER/locations/<var>LOCATION</var>/reasoningEngines/RESOURCE_ID/api/API_PATH

em que

Esse endpoint equivale a substituir o URL base do localhost pelo URL base do agente implantado. Se você estiver implantando um contêiner personalizado, os endpoints da API e as estruturas de solicitação e resposta serão definidos pelo contrato de ambiente de execução.

Por exemplo, se você implantou o servidor da API ADK de um Dockerfile ou de uma imagem de contêiner, invoque os endpoints da API da seguinte maneira:

Executar agente (resposta única) 

curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/RESOURCE_ID/api/run -d '{
  "appName": "my_sample_agent",
  "userId": "u_123",
  "sessionId": "s_abc",
  "newMessage": {
    "role": "user",
    "parts": [{"text": "What is the capital of France?"}]
  }
}'

Executar agente (streaming) 

curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/RESOURCE_ID/api/run_sse -d '{
  "appName": "my_sample_agent",
  "userId": "u_123",
  "sessionId": "s_abc",
  "newMessage": {
    "role": "user",
    "parts": [{"text": "What is the weather in New York?"}]
  },
  "streaming": true
}'

Usar agentes implantados no console do Google Cloud

Para agentes implantados desenvolvidos com o Kit de Desenvolvimento de Agente (ADK), use o consoleGoogle Cloud para interagir com seu agente:

  1. No Google Cloud console, acesse a página Implantações da Agent Platform.

    Acessar as implantações da Agent Platform

    Os runtimes que fazem parte do projeto selecionado aparecem na lista. Use o campo Filtro para filtrar a lista pela coluna especificada.

  2. Clique no nome do seu ambiente de execução.

  3. Clique na guia Playground.

  4. Você pode Digitar uma mensagem para interagir com o agente e clicar em Nova sessão para iniciar uma nova conversa.

  5. Se você ativou rastreamentos pelo OpenTelemetry, é possível conferir detalhes sobre o comportamento do seu agente durante as interações:

    • Rastreamento: rastreamentos das suas conversas com o agente.

    • Evento: um gráfico das APIs invocadas e detalhes do evento durante suas conversas com o agente.

    • Estado: informações sobre o estado do seu agente durante as conversas.

    • Sessões: uma lista de sessões associadas ao seu agente. Para mais informações, consulte Gerenciar usando o console Google Cloud ou chamadas de API

Suporte do Playground

Você pode usar os seguintes frameworks para testar seu agente:

Framework Conversar com um agente Ver sessões
Kit de Desenvolvimento de Agente (ADK) Com suporte Compatível. Exige que o agente implemente sessões da Agent Platform para persistência.
Agent2Agent (A2A) Compatível. Exige que o agente implemente Agent Platform Sessions para persistência. Compatível. Exige que o agente use sessões do Agent Platform e envie o valor user_id como parte do objeto de contexto. Para um exemplo de como transmitir o valor user_id como parte do executor do agente, consulte o notebook Introdução ao A2A.

A seguir