Buat agent Anda dapat ditemukan
Agent Card yang jelas memberi klien A2A titik awal yang dapat diandalkan: milik siapa agent tersebut, di mana ia berada, dan protocol binding serta versi apa yang digunakannya.
Apa yang dibuat generator Agent Card untuk agent AI Anda
Agent Card adalah deskripsi interface publik untuk agent A2A. Sebelum agent lain dapat memutuskan apakah akan memanggil layanan Anda, ia memerlukan lebih dari sekadar URL: ia memerlukan penjelasan yang dapat diandalkan tentang tujuan agent, kontrak teknis, skill, dan persyaratan akses.
Generator Agent Card ini mengubah detail implementasi tersebut menjadi JSON yang mudah dibaca dengan format A2A v1.0, sambil menjaga pengambilan keputusan tetap dekat dengan formulir. Gunakan setelah Anda membangun logika inti agent dan sebelum men-deploy atau mendaftarkannya — titik di mana file JSON yang ditulis tangan biasanya rusak.
Deskripsikan interface yang dapat digunakan
Tangkap interface pilihan, mode konten, perilaku streaming, dan dukungan notifikasi push yang dibutuhkan agent lain sebelum melakukan panggilan.
Tetapkan ekspektasi untuk akses
Dokumentasikan apakah layanan bersifat publik, menggunakan kunci API, atau memerlukan OAuth 2.0, sehingga integrasi dapat memilih alur autentikasi yang tepat — tanpa pernah memasukkan kredensial ke dalam Agent Card.
Ubah skill menjadi kontrak yang jelas
Beri nama pekerjaan yang dapat dilakukan agent Anda, tambahkan tag yang diwajibkan v1.0 beserta contoh yang berguna, dan buat batasannya dapat dipahami oleh orang, marketplace, dan klien AI.
Cara kerja Generator Agent Card
Dari detail layanan ke Agent Card yang siap diterbitkan
Generator Agent Card mengubah detail layanan menjadi dokumen JSON yang jelas dan siap diterbitkan. Ikuti alur kerja singkat ini sebelum mengirim Agent Card ke produksi.
- 1
Mulai dengan layanan nyata
Tambahkan endpoint A2A publik, protocol binding, detail provider, versi agent, dan jenis konten yang diterima dan dikembalikan server Anda.
- 2
Definisikan batas kapabilitas dan skill
Pilih hanya kapabilitas yang didukung implementasi Anda, lalu deskripsikan satu skill representatif dengan bahasa yang sederhana dan spesifik.
- 3
Tinjau JSON yang dihasilkan
Gunakan pratinjau langsung untuk menemukan field yang hilang, URL placeholder, atau deskripsi yang tidak secara akurat mencerminkan layanan yang di-deploy.
- 4
Validasi dan terbitkan
Jalankan Agent Card melalui validator, lalu tempatkan dokumen yang telah ditinjau di /.well-known/agent-card.json pada domain layanan Anda.
Siapa yang menggunakan Generator Agent Card
Dibuat untuk semua orang yang membuat, merilis, atau meninjau Agent Card
Generator Agent Card membantu pembuat, tim platform, dan peninjau membuat metadata agent A2A yang konsisten tanpa memulai dari file JSON kosong.
Pengembang AI dan independen
Gantikan agent-card.json yang ditulis tangan dengan titik awal lengkap yang sesuai spesifikasi saat meluncurkan agent yang kompatibel dengan A2A.
Prompt engineer dan product manager
Susun dokumen penemuan yang kredibel dari deskripsi layanan tanpa menyentuh sintaks JSON, lalu serahkan ke tim rekayasa untuk ditinjau.
Tim platform dan DevOps
Standarkan cara agent internal mendeskripsikan endpoint, autentikasi, dan skill sebelum masuk ke katalog agent perusahaan atau pipeline CI.
Penerbit marketplace
Siapkan metadata provider, tag skill, dan deklarasi keamanan yang benar-benar dapat diurai oleh peninjau dan sistem peringkat.
Pertanyaan umum
Pertanyaan tentang generator Agent Card
Pastikan hal-hal esensial benar sebelum klien A2A menemukan endpoint Anda.
Apa itu A2A Agent Card?
A2A Agent Card adalah dokumen penemuan JSON untuk agent AI. Ia menyampaikan identitas, informasi provider, interface yang didukung, kapabilitas, skill, mode konten yang diterima, dan persyaratan keamanan kepada klien potensial — setara agent-ke-agent dari README ditambah ringkasan API.
Mengapa menggunakan generator Agent Card alih-alih menulis JSON secara manual?
Agent Card yang ditulis tangan sering kali kehilangan field wajib, menggunakan nama field pra-v1.0, atau mengandung kesalahan sintaks. Generator menghasilkan bentuk A2A v1.0 saat ini — supportedInterfaces, provider.organization, tag skill wajib — dan memvalidasi saat Anda mengetik, sehingga kesalahan struktural tidak pernah sampai ke produksi.
Versi A2A mana yang ditargetkan Agent Card yang dihasilkan?
Generator menghasilkan struktur A2A v1.0: array supportedInterfaces berurutan dengan protocolBinding dan protocolVersion per interface, version agent tingkat atas, dan capabilities termasuk extendedAgentCard. Agent Card dengan field url atau preferredTransport tingkat atas adalah pra-v1.0.
Apakah JSON yang dihasilkan perlu ditinjau sebelum produksi?
Ya. Generator membuat dokumen awal yang praktis, bukan pengganti kontrak yang telah Anda deploy. Konfirmasikan bahwa endpoint, protocol binding, skill, dan autentikasi sesuai dengan layanan yang benar-benar akan diakses pengguna.
Di mana saya menerbitkan Agent Card?
Terbitkan JSON yang telah ditinjau pada domain yang sama dengan layanan A2A Anda di https://domain-anda/.well-known/agent-card.json, jalur well-known yang terdaftar oleh spesifikasi A2A. Banyak integrasi lama juga memeriksa /.well-known/agent.json, jadi menyajikan keduanya adalah strategi transisi yang aman.
Siap menerbitkan
Kembali ke Generator Agent Card sebelum menerbitkan.
Selesaikan detail, tinjau JSON yang dihasilkan, dan gunakan validasi langsung sebelum menerbitkan Agent Card Anda.