Teste e monitorize a implementação de agentes A2A

Depois de implementar com êxito o agente A2A no Cloud Run, teste minuciosamente a respetiva funcionalidade. Estabeleça práticas de monitorização rigorosas para garantir o desempenho e a fiabilidade contínuos.

Inspetor A2A: valide a conformidade dos agentes

Use a ferramenta a2a-inspector para inspecionar, depurar e validar o seu agente Google A2A implementado. Esta ferramenta garante que o seu agente está totalmente em conformidade com a especificação A2A e funciona corretamente.

Após uma ligação bem-sucedida, o inspetor realiza as seguintes ações:

  • Apresenta o cartão do agente: mostra automaticamente o cartão do agente.
  • Valida a conformidade: verifica se o cartão cumpre as especificações de A2A.
  • Ativa o chat em direto: permite-lhe enviar e receber mensagens com o agente.
  • Mostra dados não processados: apresenta mensagens JSON-RPC 2.0 não processadas numa consola para depuração.

Interação da CLI com um agente A2A implementado

Use as ferramentas da interface de linhas de comando (CLI) do repositório de exemplos A2A para interagir com o serviço implementado. Esta CLI suporta a autenticação baseada em tokens de portador.

Se o seu serviço usar a autenticação baseada na IAM, exporte o token gcloud para uma interação bem-sucedida:

export A2A_CLI_BEARER_TOKEN=$(gcloud auth print-identity-token)
# From CLI directory
uv run . --agent CLOUD_RUN_SERVICE_URL

Substitua CLOUD_RUN_SERVICE_URL pelo URL do seu serviço do Cloud Run implementado.

Testes locais de serviços A2A implementados

Pode testar o serviço do Cloud Run implementado localmente. Isto é particularmente útil quando implementa a autenticação baseada na IAM.

Teste a autenticação baseada na IAM para agentes do Cloud Run

Os clientes que interagem com o seu serviço do Cloud Run protegido pela gestão de identidade e de acesso (IAM) têm de ter a função de IAM roles/run.invoker.

Teste localmente o fluxo de autenticação do serviço implementado com o comando gcloud auth print-identity-token:

curl -H "Authorization: Bearer $(gcloud auth print-identity-token)" CLOUD_RUN_SERVICE_URL/.well-known/agent.json

Substitua CLOUD_RUN_SERVICE_URL pelo URL do seu serviço do Cloud Run implementado.