A2A (Agent2Agent) adalah protokol terbuka untuk komunikasi antar-Agent. Melalui A2A, berbagai Agent dapat menemukan kemampuan satu sama lain, mengirim pesan, dan mengembalikan hasil eksekusi.A2A Debugger adalah alat visual untuk melakukan debugging pada A2A Agent. Anda dapat terhubung ke A2A Agent, mengirim pesan pengujian, melihat konten yang dikembalikan oleh Agent, status eksekusi, dan log debug, sehingga membantu pengembang dengan cepat memecahkan masalah terkait integrasi Agent, pengiriman pesan, dan hasil yang dikembalikan.A2A Debugger cocok untuk skenario berikut:Memeriksa apakah A2A Agent dapat terhubung secara normal
Melihat nama, deskripsi, kemampuan, dan Skills Agent
Mengirim teks atau lampiran ke Agent untuk memverifikasi responsnya
Memecahkan masalah koneksi atau permintaan seperti autentikasi, Header, jenis file, dan sebagainya
Melihat detail permintaan dan respons untuk mengidentifikasi penyebab konten yang dikembalikan secara tidak normal
Kami menyarankan penggunaan klien Apidog terbaru untuk menikmati fitur lengkap AI Agent Debugger.
Menghubungkan ke A2A Agent#
Masukkan Agent Card URL di bagian atas halaman, lalu klik Connect.Setelah koneksi berhasil, status di bagian atas akan ditampilkan sebagai Connected. Pada titik ini, Anda dapat melihat informasi Agent dan mulai mengirim pesan.Jika Anda perlu beralih ke Agent lain, Anda dapat mengklik Disconnect, lalu memasukkan kembali Agent Card URL.Tulis input pengujian yang akan dikirim ke Agent pada tab Messages.Area pengeditan pesan dibagi menjadi bagian kiri dan kanan:Sisi kiri: Memasukkan teks pesan, mengunggah lampiran, mengonfigurasi Metadata
Sisi kanan: Melihat konten permintaan mentah yang sesuai
Mengirim Pesan#
Setelah konfigurasi pesan selesai, klik Send.Jika saat ini belum ada Agent yang terhubung, A2A Debugger akan terlebih dahulu mencoba untuk terhubung; pesan akan dikirim setelah koneksi berhasil.Setelah dikirim, Anda dapat melihat pesan pengguna dan konten yang dikembalikan oleh Agent di area pesan.Melihat Pesan Balasan#
Area pesan menampilkan pesan pengguna dan balasan Agent dalam sesi saat ini.Konten yang dikembalikan oleh Agent dapat berupa teks biasa, atau dapat mencakup status tugas, hasil eksekusi, atau artefak yang dihasilkan. Anda dapat dengan cepat menentukan apakah Agent memahami dan memproses permintaan dengan benar melalui area tampilan pesan.Klik pesan debug apa pun untuk melihat detail di sisi kanan. Panel detail mendukung tiga tampilan:Preview: Menampilkan konten utama dengan cara yang lebih mudah dibaca
Content: Melihat teks atau data inti dalam pesan
Raw Data: Melihat JSON mentah lengkap
What is the distance between the Earth and the Moon?
Melihat Agent Card#
Tab Agent Card pada panel debugging digunakan untuk melihat deskripsi kemampuan Agent yang saat ini terhubung.Alamat Agent, versi protokol, nomor versi
Kemampuan yang didukung Agent, seperti apakah Agent mendukung respons streaming, notifikasi push, riwayat status, dan sebagainya
Jenis input default dan jenis output
Skills yang dideklarasikan oleh Agent
Kesalahan validasi Agent Card
Menambahkan Lampiran#
Jika Agent saat ini mendukung input file, Anda dapat mengklik tombol lampiran di bawah area input pesan untuk mengunggah file.A2A Debugger menentukan apakah pengunggahan lampiran diizinkan berdasarkan jenis input yang dideklarasikan oleh Agent:Jika Agent hanya mendukung input teks, tombol lampiran tidak tersedia
Jika Agent hanya mendukung jenis file tertentu, Anda hanya dapat mengunggah file dengan jenis yang sesuai
Jika Agent mendukung jenis file apa pun, Anda dapat mengunggah file apa pun
Mengonfigurasi Autentikasi#
Jika A2A Agent memerlukan autentikasi, Anda dapat mengonfigurasi metode autentikasi pada tab Authentication.Jenis autentikasi berikut didukung:| Metode Autentikasi | Deskripsi |
|---|
| None | Tidak ada informasi autentikasi yang ditambahkan |
| Bearer Token | Melakukan autentikasi menggunakan token |
| Basic Auth | Melakukan autentikasi menggunakan nama pengguna dan kata sandi |
| API Key | Meneruskan API Key melalui Header yang ditentukan |
Jika kesalahan tidak berwenang dikembalikan saat mengirim pesan, periksa apakah metode autentikasi, token, nama pengguna/kata sandi, atau API Key sudah benar.Pada tab Header, Anda dapat menambahkan Header permintaan khusus.Header khusus umumnya digunakan dalam skenario berikut:Meneruskan parameter bisnis seperti ID tenant, pengenal lingkungan, dan sebagainya
Autentikasi melalui gateway, proxy, atau layanan internal
Melakukan debugging pada layanan Agent yang memerlukan header permintaan khusus
FAQ#
Apa yang harus saya lakukan jika koneksi gagal?#
1.
Apakah Agent Card URL benar dan dapat diakses dari lingkungan saat ini.
2.
Apakah layanan Agent sedang berjalan.
3.
Jika autentikasi diperlukan, apakah informasi autentikasi yang benar telah dikonfigurasi pada tab Authentication.
4.
Apakah Header tambahan diperlukan, seperti ID tenant, pengenal lingkungan, atau informasi autentikasi gateway.
5.
Apakah konten yang dikembalikan oleh Agent Card merupakan JSON yang valid.
Tidak dapat mengunggah lampiran setelah koneksi berhasil?#
Hal ini biasanya terjadi karena Agent saat ini belum mendeklarasikan dukungan untuk input file, atau hanya mengizinkan pengunggahan jenis file tertentu.Lihat jenis input yang didukung oleh Agent pada tab Agent Card, dan pastikan apakah jenis file yang diunggah sesuai.Bagaimana cara melihat permintaan dan respons lengkap?#
Klik log permintaan atau respons yang sesuai pada tab Messages di panel debugging, lalu beralih ke tampilan Raw Data untuk melihat JSON lengkap.Apa yang harus saya lakukan jika konten yang dikembalikan oleh Agent ditampilkan secara tidak normal?#
Anda dapat melakukan pemecahan masalah dalam urutan berikut:1.
Periksa konten pratinjau dalam pesan debug untuk memastikan apakah Agent telah mengembalikan hasil.
2.
Beralih ke tampilan Raw Data untuk melihat respons lengkap.
3.
Periksa apakah jenis input, jenis output, dan Skills yang dideklarasikan dalam Agent Card sesuai dengan ekspektasi.
4.
Periksa prompt kesalahan validasi dalam pesan atau detail debug.
