測試及監控 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 為基礎的驗證時，這項功能特別實用。

測試 Cloud Run 代理程式的 IAM 驗證

與受 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 服務網址。