Usar um agente

Como usar o SDK da plataforma de agentes

Ao usar o SDK da plataforma de agente, 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 cada 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 rapidamente soluções robustas baseadas em agentes.
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 desenvolvidos e implantados sem o uso de um modelo específico do framework.

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.

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 Google Cloud console para interagir com seu agente:

  1. No console do Google Cloud , acesse a página Implantações da plataforma de agente.

    Acessar implantações da plataforma de agentes

    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 sessão com ele.

  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. Requer que o agente implemente Sessões da plataforma do agente para persistência.
Agent2Agent (A2A) Compatível. Requer que o agente implemente Sessões da plataforma do agente para persistência. Compatível. Exige que o agente use sessões da plataforma de agente e envie o valor user_id como parte do objeto de contexto. Para ver um exemplo de como transmitir o valor user_id como parte do executor do agente, consulte o notebook Introdução ao A2A.

A seguir