अपने एजेंट को खोजने योग्य बनाएं
एक स्पष्ट Agent Card A2A क्लाइंट को एक भरोसेमंद शुरुआती बिंदु देता है: एजेंट किसका है, यह कहाँ रहता है, और यह कौन से प्रोटोकॉल बाइंडिंग और संस्करण बोलता है।
Agent Card जनरेटर आपके AI एजेंट के लिए क्या बनाता है
Agent Card एक A2A एजेंट का सार्वजनिक इंटरफेस विवरण है। कोई दूसरा एजेंट आपकी सेवा को कॉल करने का निर्णय लेने से पहले, उसे केवल एक URL से अधिक की आवश्यकता होती है: उसे एजेंट के उद्देश्य, तकनीकी अनुबंध, स्किल्स और एक्सेस आवश्यकताओं का भरोसेमंद विवरण चाहिए।
यह Agent Card जनरेटर उन कार्यान्वयन विवरणों को पठनीय, A2A v1.0-आकार के JSON में बदल देता है, जबकि निर्णय लेने को फॉर्म के करीब रखता है। इसे एजेंट का मूल तर्क बनाने के बाद और तैनात या सूचीबद्ध करने से पहले उपयोग करें — वह बिंदु जहाँ हाथ से लिखी JSON फ़ाइल आमतौर पर टूट जाती है।
एक उपयोगी इंटरफेस का वर्णन करें
पसंदीदा इंटरफेस, सामग्री मोड, स्ट्रीमिंग व्यवहार, और पुश नोटिफिकेशन समर्थन को कैप्चर करें जिसकी दूसरे एजेंट को कॉल करने से पहले आवश्यकता होती है।
पहुँच के लिए अपेक्षाएँ निर्धारित करें
दस्तावेज़ करें कि क्या सेवा सार्वजनिक है, API कुंजी का उपयोग करती है, या OAuth 2.0 की आवश्यकता है, ताकि एकीकरण सही प्रमाणीकरण प्रवाह चुन सकें — बिना कभी Agent Card में कोई क्रेडेंशियल डाले।
स्किल्स को स्पष्ट अनुबंधों में बदलें
आपका एजेंट जो काम कर सकता है उसका नाम रखें, v1.0 द्वारा आवश्यक टैग और उपयोगी उदाहरण जोड़ें, और इसकी सीमाओं को लोगों, मार्केटप्लेस और AI क्लाइंट के लिए समझने योग्य बनाएं।
Agent Card जनरेटर कैसे काम करता है
सेवा विवरण से प्रकाशन-योग्य Agent Card तक
Agent Card जनरेटर सेवा विवरण को एक स्पष्ट, प्रकाशन-योग्य JSON दस्तावेज़ में बदल देता है। Agent Card को उत्पादन में भेजने से पहले इस संक्षिप्त वर्कफ़्लो का पालन करें।
- 1
वास्तविक सेवा से शुरू करें
सार्वजनिक A2A एंडपॉइंट, प्रोटोकॉल बाइंडिंग, प्रोवाइडर विवरण, एजेंट संस्करण, और आपका सर्वर जो सामग्री प्रकार स्वीकार करता और लौटाता है उन्हें जोड़ें।
- 2
क्षमता और स्किल सीमाएँ परिभाषित करें
केवल उन क्षमताओं का चयन करें जिन्हें आपका कार्यान्वयन समर्थन करता है, फिर एक प्रतिनिधि स्किल का सरल, विशिष्ट भाषा में वर्णन करें।
- 3
जनरेट किए गए JSON की समीक्षा करें
लापता फ़ील्ड, प्लेसहोल्डर URL, या ऐसे विवरण खोजने के लिए लाइव पूर्वावलोकन का उपयोग करें जो तैनात सेवा को सही ढंग से प्रतिबिंबित नहीं करते।
- 4
सत्यापित करें और प्रकाशित करें
Agent Card को वैलिडेटर से गुजारें, फिर समीक्षित दस्तावेज़ को अपने सेवा डोमेन पर /.well-known/agent-card.json पर रखें।
Agent Card जनरेटर का उपयोग कौन करता है
हर उस व्यक्ति के लिए बनाया गया जो Agent Cards बनाता, शिप करता या समीक्षा करता है
Agent Card जनरेटर बिल्डरों, प्लेटफ़ॉर्म टीमों और समीक्षकों को खाली JSON फ़ाइल से शुरू किए बिना सुसंगत A2A एजेंट मेटाडेटा बनाने में मदद करता है।
AI और स्वतंत्र डेवलपर्स
A2A-संगत एजेंट लॉन्च करते समय हाथ से लिखी agent-card.json को एक पूर्ण, स्पेक-आकार के शुरुआती बिंदु से बदलें।
प्रॉम्प्ट इंजीनियर और प्रोडक्ट मैनेजर
JSON सिंटैक्स को छुए बिना सेवा विवरण से एक विश्वसनीय डिस्कवरी दस्तावेज़ तैयार करें, फिर समीक्षा के लिए इंजीनियरिंग को सौंपें।
प्लेटफ़ॉर्म और DevOps टीमें
आंतरिक एजेंटों के कंपनी एजेंट कैटलॉग या CI पाइपलाइन में प्रवेश करने से पहले उनके एंडपॉइंट, प्रमाणीकरण और स्किल्स का वर्णन करने के तरीके को मानकीकृत करें।
मार्केटप्लेस प्रकाशक
प्रोवाइडर मेटाडेटा, स्किल टैग, और सुरक्षा घोषणाएँ तैयार करें जिन्हें समीक्षक और रैंकिंग सिस्टम वास्तव में पार्स कर सकें।
सामान्य प्रश्न
Agent Card जनरेटर से जुड़े सामान्य प्रश्न
A2A क्लाइंट के आपके एंडपॉइंट को खोजने से पहले आवश्यक बातें सही करें।
A2A Agent Card क्या है?
A2A Agent Card एक AI एजेंट के लिए एक JSON डिस्कवरी दस्तावेज़ है। यह संभावित क्लाइंट को पहचान, प्रोवाइडर जानकारी, समर्थित इंटरफेस, क्षमताएँ, स्किल्स, स्वीकृत सामग्री मोड, और सुरक्षा आवश्यकताएँ बताता है — README प्लस API अवलोकन का एजेंट-टू-एजेंट समकक्ष।
हाथ से JSON लिखने के बजाय Agent Card जनरेटर का उपयोग क्यों करें?
हाथ से लिखे Agent Card अक्सर आवश्यक फ़ील्ड गायब होने, v1.0 से पहले के फ़ील्ड नामों, या सिंटैक्स त्रुटियों के साथ आते हैं। जनरेटर वर्तमान A2A v1.0 आकार — supportedInterfaces, provider.organization, आवश्यक स्किल टैग — उत्पन्न करता है और टाइप करते समय सत्यापित करता है, इसलिए संरचनात्मक गलतियाँ कभी उत्पादन तक नहीं पहुँचतीं।
जनरेट किया गया Agent Card किस A2A संस्करण को लक्षित करता है?
जनरेटर A2A v1.0 संरचना उत्सर्जित करता है: प्रति-इंटरफेस protocolBinding और protocolVersion के साथ एक क्रमबद्ध supportedInterfaces सरणी, एक शीर्ष-स्तरीय एजेंट version, और extendedAgentCard सहित क्षमताएँ। शीर्ष-स्तरीय url या preferredTransport फ़ील्ड वाले Agent Card v1.0 से पहले के हैं।
क्या जनरेट किए गए JSON को उत्पादन से पहले समीक्षा की आवश्यकता है?
हाँ। जनरेटर एक व्यावहारिक शुरुआती दस्तावेज़ बनाता है, आपके तैनात अनुबंध का विकल्प नहीं। पुष्टि करें कि एंडपॉइंट, प्रोटोकॉल बाइंडिंग, स्किल्स, और प्रमाणीकरण उस सेवा से मेल खाते हैं जिस तक उपयोगकर्ता वास्तव में पहुँचेंगे।
मुझे Agent Card कहाँ प्रकाशित करना चाहिए?
समीक्षित JSON को अपनी A2A सेवा के समान डोमेन पर https://your-domain/.well-known/agent-card.json पर प्रकाशित करें, जो A2A विनिर्देश द्वारा पंजीकृत well-known पथ है। कई पुराने एकीकरण /.well-known/agent.json भी जाँचते हैं, इसलिए दोनों की सेवा करना एक सुरक्षित संक्रमण रणनीति है।
प्रकाशित करने के लिए तैयार
प्रकाशित करने से पहले Agent Card जनरेटर पर लौटें।
विवरण पूरा करें, जनरेट किए गए JSON की समीक्षा करें, और अपना Agent Card प्रकाशित करने से पहले लाइव सत्यापन का उपयोग करें।