Nachdem Sie Ihren A2A-Agenten erfolgreich in Cloud Run bereitgestellt haben, testen Sie seine Funktionalität gründlich. Richten Sie solide Überwachungspraktiken ein, um kontinuierliche Leistung und Zuverlässigkeit zu gewährleisten.
A2A-Prüftool: Agent-Compliance validieren
Mit dem Tool a2a-inspector können Sie Ihren bereitgestellten Google A2A-Agenten prüfen, debuggen und validieren. Mit diesem Tool wird sichergestellt, dass Ihr Agent die A2A-Spezifikation vollständig erfüllt und korrekt funktioniert.
Nach einer erfolgreichen Verbindung führt der Inspector die folgenden Aktionen aus:
- Agent-Karte anzeigen:Die Karte Ihres Agenten wird automatisch angezeigt.
- Compliance wird geprüft:Es wird geprüft, ob die Karte den A2A-Spezifikationen entspricht.
- Livechat aktivieren:Sie können Nachrichten mit dem Kundenservicemitarbeiter senden und empfangen.
- Rohdaten anzeigen:Zeigt zur Fehlerbehebung JSON-RPC 2.0-Rohdaten in einer Konsole an.
CLI-Interaktion mit einem bereitgestellten A2A-Agent
Verwenden Sie die Befehlszeilentools aus dem A2A-Beispiel-Repository, um mit Ihrem bereitgestellten Dienst zu interagieren. Diese Befehlszeile unterstützt die Authentifizierung auf Basis von Bearertokens.
Wenn Ihr Dienst die IAM-basierte Authentifizierung verwendet, exportieren Sie das gcloud-Token für eine erfolgreiche Interaktion:
export A2A_CLI_BEARER_TOKEN=$(gcloud auth print-identity-token)
# From CLI directory
uv run . --agent CLOUD_RUN_SERVICE_URL
Ersetzen Sie CLOUD_RUN_SERVICE_URL durch die URL Ihres bereitgestellten Cloud Run-Dienstes.
Bereitgestellte A2A-Dienste lokal testen
Sie können Ihren bereitgestellten Cloud Run-Dienst lokal testen. Dies ist besonders nützlich, wenn Sie die IAM-basierte Authentifizierung implementieren.
IAM-basierte Authentifizierung für Cloud Run-Agents testen
Clients, die mit Ihrem durch Identity and Access Management (IAM) geschützten Cloud Run-Dienst interagieren, müssen die IAM-Rolle roles/run.invoker haben.
Testen Sie den Authentifizierungsablauf Ihres bereitgestellten Dienstes lokal mit dem Befehl gcloud auth print-identity-token:
curl -H "Authorization: Bearer $(gcloud auth print-identity-token)" CLOUD_RUN_SERVICE_URL/.well-known/agent.json
Ersetzen Sie CLOUD_RUN_SERVICE_URL durch die URL Ihres bereitgestellten Cloud Run-Dienstes.