Depois de implantar o agente A2A no Cloud Run, teste a funcionalidade dele. Estabeleça práticas de monitoramento eficientes para garantir desempenho e confiabilidade contínuos.
Inspetor de A2A: validar a conformidade do agente
Use a ferramenta a2a-inspector para inspecionar, depurar e validar o agente do Google A2A implantado. Essa ferramenta garante que seu agente esteja em total conformidade com a especificação A2A e funcione corretamente.
Após uma conexão bem-sucedida, o inspetor realiza as seguintes ações:
- Mostra o card do agente:mostra automaticamente o card do seu agente.
- Valida a conformidade:verifica se o cartão atende às especificações A2A.
- Ativa o chat ao vivo:permite enviar e receber mensagens com o agente.
- Mostra dados brutos:exibe mensagens JSON-RPC 2.0 brutas em um console para depuração.
Interação da CLI com um agente A2A implantado
Use as ferramentas de interface de linha de comando (CLI) do repositório de amostras A2A para interagir com o serviço implantado. Essa CLI é compatível com autenticação baseada em token de portador.
Se o serviço usa a autenticação baseada no 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 serviço do Cloud Run implantado.
Teste local de serviços A2A implantados
É possível testar o serviço do Cloud Run implantado localmente. Isso é especialmente útil ao implementar a autenticação baseada no IAM.
Testar a autenticação baseada no IAM para agentes do Cloud Run
Os clientes que interagem com seu serviço do Cloud Run protegido pelo Identity and Access Management (IAM) precisam ter o papel do IAM roles/run.invoker.
Teste localmente o fluxo de autenticação do serviço implantado usando 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 serviço do Cloud Run implantado.