Menguji dan memantau deployment agen A2A

Setelah berhasil men-deploy agen A2A ke Cloud Run, uji fungsinya secara menyeluruh. Tetapkan praktik pemantauan yang efektif untuk memastikan performa dan keandalan yang berkelanjutan.

Pemeriksa A2A: Memvalidasi kepatuhan agen

Gunakan alat a2a-inspector untuk memeriksa, men-debug, dan memvalidasi agen Google A2A yang di-deploy. Alat ini memastikan bahwa agen Anda sepenuhnya mematuhi spesifikasi A2A dan berfungsi dengan benar.

Setelah koneksi berhasil, pemeriksa akan melakukan tindakan berikut:

  • Menampilkan kartu agen: Secara otomatis menampilkan kartu agen Anda.
  • Memvalidasi kepatuhan: Memeriksa apakah kartu memenuhi spesifikasi A2A.
  • Mengaktifkan live chat: Memungkinkan Anda mengirim dan menerima pesan dengan agen.
  • Menampilkan data mentah: Menampilkan pesan JSON-RPC 2.0 mentah di konsol untuk proses debug.

Interaksi CLI dengan agen A2A yang di-deploy

Gunakan alat command-line interface (CLI) dari repositori contoh A2A untuk berinteraksi dengan layanan yang di-deploy. CLI ini mendukung autentikasi berbasis token pembawa.

Jika layanan Anda menggunakan autentikasi berbasis IAM, ekspor token gcloud agar interaksi berhasil:

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

Ganti CLOUD_RUN_SERVICE_URL dengan URL layanan Cloud Run yang di-deploy.

Pengujian lokal layanan A2A yang di-deploy

Anda dapat menguji layanan Cloud Run yang di-deploy secara lokal. Hal ini sangat berguna saat menerapkan autentikasi berbasis IAM.

Menguji autentikasi berbasis IAM untuk agen Cloud Run

Klien yang berinteraksi dengan layanan Cloud Run yang diamankan dengan Identity and Access Management (IAM) harus memiliki peran IAM roles/run.invoker.

Uji alur autentikasi layanan yang di-deploy secara lokal menggunakan perintah gcloud auth print-identity-token:

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

Ganti CLOUD_RUN_SERVICE_URL dengan URL layanan Cloud Run yang di-deploy.