Jadikan ejen anda boleh ditemui
Agent Card yang jelas memberikan klien A2A titik permulaan yang boleh dipercayai: kepunyaan siapa ejen tersebut, di mana ia berada, dan binding protokol serta versi apa yang dituturkannya.
Apa yang dihasilkan penjana Agent Card untuk ejen AI anda
Agent Card ialah penerangan antara muka awam bagi ejen A2A. Sebelum ejen lain boleh memutuskan sama ada untuk memanggil perkhidmatan anda, ia memerlukan lebih daripada URL: ia memerlukan penerangan yang boleh dipercayai tentang tujuan ejen, kontrak teknikal, skill, dan keperluan akses.
Penjana Agent Card ini menukar butiran pelaksanaan tersebut kepada JSON yang mudah dibaca dalam bentuk A2A v1.0, sambil mengekalkan pembuatan keputusan berhampiran borang. Gunakannya selepas anda membina logik teras ejen dan sebelum menggunakannya atau menyenaraikannya — titik di mana fail JSON yang ditulis tangan biasanya rosak.
Terangkan antara muka yang boleh digunakan
Rekod antara muka pilihan, mod kandungan, kelakuan streaming, dan sokongan pemberitahuan tolak yang diperlukan ejen lain sebelum membuat panggilan.
Tetapkan jangkaan untuk akses
Dokumenkan sama ada perkhidmatan itu awam, menggunakan kunci API, atau memerlukan OAuth 2.0, supaya integrasi boleh memilih aliran pengesahan yang betul — tanpa sekali-kali meletakkan kelayakan dalam Agent Card.
Tukar skill kepada kontrak yang jelas
Namakan kerja yang boleh dilakukan ejen anda, tambah tag yang diperlukan v1.0 berserta contoh yang berguna, dan jadikan sempadannya mudah difahami oleh orang, pasaran, dan klien AI.
Cara Penjana Agent Card berfungsi
Daripada butiran perkhidmatan kepada Agent Card yang sedia diterbitkan
Penjana Agent Card menukar butiran perkhidmatan kepada dokumen JSON yang jelas dan sedia diterbitkan. Ikuti aliran kerja ringkas ini sebelum menghantar Agent Card ke pengeluaran.
- 1
Mulakan dengan perkhidmatan sebenar
Tambah titik akhir A2A awam, binding protokol, butiran penyedia, versi ejen, dan jenis kandungan yang diterima dan dikembalikan oleh pelayan anda.
- 2
Tentukan sempadan keupayaan dan skill
Pilih hanya keupayaan yang disokong pelaksanaan anda, kemudian terangkan satu skill wakil dalam bahasa yang mudah dan khusus.
- 3
Semak JSON yang dihasilkan
Gunakan pratonton langsung untuk mengesan medan yang hilang, URL ruang letak, atau penerangan yang tidak mencerminkan perkhidmatan yang digunakan dengan tepat.
- 4
Sahkan dan terbitkan
Jalankan Agent Card melalui pengesah, kemudian letakkan dokumen yang telah disemak di /.well-known/agent-card.json pada domain perkhidmatan anda.
Siapa yang menggunakan Penjana Agent Card
Dibina untuk semua orang yang mencipta, menghantar, atau menyemak Agent Card
Penjana Agent Card membantu pembina, pasukan platform, dan penyemak mencipta metadata ejen A2A yang konsisten tanpa bermula daripada fail JSON kosong.
Pembangun AI dan bebas
Gantikan agent-card.json yang ditulis tangan dengan titik permulaan lengkap yang mengikut spesifikasi apabila melancarkan ejen serasi A2A.
Jurutera prompt dan pengurus produk
Rangka dokumen penemuan yang boleh dipercayai daripada penerangan perkhidmatan tanpa menyentuh sintaks JSON, kemudian serahkan kepada kejuruteraan untuk semakan.
Pasukan platform dan DevOps
Piawaikan cara ejen dalaman menerangkan titik akhir, pengesahan, dan skill sebelum mereka memasuki katalog ejen syarikat atau saluran paip CI.
Penerbit pasaran
Sediakan metadata penyedia, tag skill, dan pengisytiharan keselamatan yang benar-benar boleh dihuraikan oleh penyemak dan sistem penarafan.
Soalan lazim
Soalan tentang penjana Agent Card
Betulkan perkara asas sebelum klien A2A menemui titik akhir anda.
Apakah A2A Agent Card?
A2A Agent Card ialah dokumen penemuan JSON untuk ejen AI. Ia menyampaikan identiti, maklumat penyedia, antara muka yang disokong, keupayaan, skill, mod kandungan yang diterima, dan keperluan keselamatan kepada klien berpotensi — setara ejen-ke-ejen bagi README ditambah gambaran keseluruhan API.
Mengapa menggunakan penjana Agent Card berbanding menulis JSON secara manual?
Agent Card yang ditulis tangan selalunya kehilangan medan wajib, menggunakan nama medan pra-v1.0, atau mengandungi ralat sintaks. Penjana menghasilkan bentuk A2A v1.0 semasa — supportedInterfaces, provider.organization, tag skill wajib — dan mengesahkan semasa anda menaip, jadi kesilapan struktur tidak akan sampai ke pengeluaran.
Versi A2A manakah yang disasarkan Agent Card yang dihasilkan?
Penjana menghasilkan struktur A2A v1.0: array supportedInterfaces tersusun dengan protocolBinding dan protocolVersion bagi setiap antara muka, version ejen peringkat atas, dan capabilities termasuk extendedAgentCard. Agent Card dengan medan url atau preferredTransport peringkat atas adalah pra-v1.0.
Adakah JSON yang dihasilkan memerlukan semakan sebelum pengeluaran?
Ya. Penjana mencipta dokumen permulaan yang praktikal, bukan pengganti kontrak yang telah anda gunakan. Sahkan bahawa titik akhir, binding protokol, skill, dan pengesahan sepadan dengan perkhidmatan yang benar-benar akan diakses pengguna.
Di manakah saya menerbitkan Agent Card?
Terbitkan JSON yang telah disemak pada domain yang sama dengan perkhidmatan A2A anda di https://domain-anda/.well-known/agent-card.json, laluan well-known yang didaftarkan oleh spesifikasi A2A. Banyak integrasi lama juga menyemak /.well-known/agent.json, jadi menyajikan kedua-duanya adalah strategi peralihan yang selamat.
Sedia untuk diterbitkan
Kembali ke Penjana Agent Card sebelum menerbitkan.
Lengkapkan butiran, semak JSON yang dihasilkan, dan gunakan pengesahan langsung sebelum menerbitkan Agent Card anda.