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 independentemente de ele estar sendo executado localmente ou implantado remotamente. Como o conjunto de operações com suporte varia entre os frameworks, fornecemos instruções de uso para modelos específicos do 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 retrocesso/repetição.
AG2 (antigo AutoGen) O AG2 fornece um framework de conversa multiagente como uma abstração de alto nível para criar fluxos de trabalho de LLM.
LlamaIndex (prévia) O pipeline de consulta 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.

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á aguardando (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, então você enviaria 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

  • PROJECT_ID é o Google Cloud ID do projeto em que você implantou o agente.
  • LOCATION é a região em que o agente está implantado.
  • RESOURCE_ID é o ID do agente implantado como um reasoningEngine recurso
  • API_PATH é o caminho do endpoint de API correspondente.

Esse endpoint é equivalente a substituir o URL base do localhost pelo URL base do agente implantado.

Para dar alguns exemplos, se você implantou o servidor de API do ADK de um Dockerfile ou 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 Google Cloud console

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

  1. Noconsole, acesse a página Implantações da Plataforma de Agentes.
    Google Cloud

    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 runtime.

  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 os traces pelo OpenTelemetry, confira detalhes sobre o comportamento do agente durante as interações:

    • Trace: traces 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 agente durante as conversas.

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

Suporte do Playground

Use os frameworks a seguir para testar o agente:

Framework Conversar com um agente Ver sessões
Kit de Desenvolvimento de Agente (ADK) Com suporte Com suporte. Exige que o agente implemente sessões da Agent Platform para persistência.
Agent2Agent (A2A) Com suporte. Exige que o agente implemente sessões da Agent Platform para persistência. Com suporte. Exige que o agente use sessões da Agent Platform e envie o user_id valor 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