测试和监控 A2A 代理部署

成功将 A2A 代理部署到 Cloud Run 后，请全面测试其功能。建立完善的监控实践，确保持续的性能和可靠性。

A2A 检查器：验证代理合规性

使用 a2a-inspector 工具检查、调试和验证已部署的 Google A2A 代理。此工具可确保您的代理完全符合 A2A 规范并正常运行。

成功连接后，检查器会执行以下操作：

  • 显示代理卡片：自动显示代理的卡片。
  • 验证合规性：检查卡片是否符合 A2A 规范。
  • 启用实时聊天：让您可以通过代理发送和接收消息。
  • 显示原始数据：在控制台中显示原始 JSON-RPC 2.0 消息以进行调试。

通过 CLI 与已部署的 A2A 代理进行交互

使用 A2A 示例仓库中的命令行界面 (CLI) 工具与已部署的服务进行交互。此 CLI 支持基于不记名令牌的身份验证。

如果您的服务使用基于 IAM 的身份验证，请导出 gcloud 令牌以成功进行交互：

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

将 CLOUD_RUN_SERVICE_URL 替换为已部署的 Cloud Run 服务的网址。

对已部署的 A2A 服务进行本地测试

您可以在本地测试已部署的 Cloud Run 服务。在实现基于 IAM 的身份验证时，此操作特别有用。

测试基于 IAM 的 Cloud Run 代理身份验证

与受 Identity and Access Management (IAM) 保护的 Cloud Run 服务进行交互的客户端必须拥有 roles/run.invoker IAM 角色。

使用 gcloud auth print-identity-token 命令在本地测试已部署服务的身份验证流程：

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

将 CLOUD_RUN_SERVICE_URL 替换为已部署的 Cloud Run 服务的网址。