स्कीमा अनुरूपता (A2A v1.0)
v1.0 विनिर्देश के विरुद्ध आवश्यक फ़ील्ड जाँचता है: name, description, version, प्रति-इंटरफेस protocolBinding और protocolVersion के साथ supportedInterfaces, capabilities, सामग्री मोड, और आवश्यक टैग वाला कम से कम एक स्किल।
A2A Agent Card वैलिडेटर
Agent Card वैलिडेटर पेस्ट किए गए JSON, अपलोड की गई Agent Card फाइलों, और पब्लिक एजेंट URL की जाँच A2A v1.0 डिस्कवरी आवश्यकताओं के विरुद्ध करता है।
Agent Card सत्यापनकर्ता का उपयोग करें
JSON, एक सार्वजनिक एजेंट URL चिपकाएँ, या JSON फ़ाइल को संपादक में खींचें।
Agent Card वैलिडेटर कवरेज
क्लाइंट आपके एजेंट को खोजें उससे पहले Agent Card वैलिडेटर क्या जाँचता है।
Agent Card वैलिडेटर A2A एजेंट प्रकाशित करने वाले डेवलपर्स, एजेंट मेटाडेटा की समीक्षा करने वाली आंतरिक प्लेटफ़ॉर्म टीमों, और यह जाँचने वाले मार्केटप्लेस ऑपरेटरों के लिए डिज़ाइन किया गया है कि क्या प्रस्तुत Agent Card में विश्वसनीय आह्वान के लिए पर्याप्त जानकारी है।
विकास के दौरान एक स्थानीय JSON दस्तावेज़ पेस्ट करें, अपने रिपॉजिटरी से एक Agent Card अपलोड करें, या सार्वजनिक डिस्कवरी पथों को सत्यापित करने के लिए तैनात डोमेन के विरुद्ध लाइव URL सत्यापन का उपयोग करें।
अर्थपूर्ण और माइग्रेशन समस्याएँ
v1.0 से पहले की संरचनाओं का पता लगाता है — शीर्ष-स्तरीय url, preferredTransport, protocolVersion, provider.name, stateTransitionHistory — और आपको बताता है कि प्रत्येक फ़ील्ड v1.0 में ठीक कहाँ स्थानांतरित हुआ।
सुरक्षा और गुप्त स्कैनिंग
सत्यापित करता है कि गैर-सार्वजनिक एंडपॉइंट के लिए securitySchemes और सुरक्षा आवश्यकताएँ घोषित हैं, गैर-HTTPS URL को फ़्लैग करता है, और उन मानों को स्कैन करता है जो एम्बेडेड API कुंजी, JWT, या bearer टोकन जैसे दिखते हैं।
डिस्कवरी तत्परता
एक लाइव डोमेन से /.well-known/agent-card.json और लेगेसी /.well-known/agent.json लाता है और पुष्टि करता है कि दोनों पार्स-योग्य Agent Card JSON लौटाते हैं।
सत्यापन कहाँ फिट होता है
हर चरण में सत्यापित करें: एडिटर, CI पाइपलाइन, लाइव डोमेन।
एक Agent Card जो पिछले महीने समीक्षा में पास हो गया था, आज भी डिस्कवरी को तोड़ सकता है — एक एंडपॉइंट बदलता है, एक स्किल बदलता है, एक पुनः तैनाती well-known रूट को हटा देती है। प्लेटफ़ॉर्म टीमें और मार्केटप्लेस समीक्षक सत्यापन को एक बार की जाँच के बजाय एक दोहराने योग्य गेट के रूप में मानते हैं।
सबसे सरल CI गार्ड को curl के अलावा कुछ नहीं चाहिए: ट्रैफ़िक नए परिनियोजन में बदलने से पहले पुष्टि करें कि well-known पथ पार्स-योग्य JSON के साथ प्रतिक्रिया देता है।
# deploy pipeline: fail if the published card breaks
curl -fsS https://your-domain/.well-known/agent-card.json \
| python3 -c '
import json, sys
card = json.load(sys.stdin)
assert card.get("name"), "name is required"
assert card.get("supportedInterfaces"), "supportedInterfaces missing"
assert card.get("skills"), "skills missing"
print("agent card OK:", card["name"])'फिक्स गाइड
सामान्य Agent Card फिक्स
पहले आवश्यक फ़ील्ड को हल करने के लिए Agent Card वैलिडेटर रिपोर्ट का उपयोग करें, फिर डिस्कवरी, विश्वास, और माइग्रेशन विवरण में सुधार करें।
प्लेसहोल्डर एंडपॉइंट URL को तैनात HTTPS A2A सेवा URL से बदलें।
शीर्ष-स्तरीय url और preferredTransport को एक क्रमबद्ध supportedInterfaces सरणी में ले जाएं — पहली प्रविष्टि पसंदीदा इंटरफेस है।
एजेंट का वर्णन करने वाला आवश्यक शीर्ष-स्तरीय version फ़ील्ड जोड़ें, और हर स्किल में टैग जोड़ें।
provider.name का नाम बदलकर provider.organization करें और संक्षिप्त विवरण का विस्तार करें ताकि क्लाइंट को पता चले कि एजेंट को कब आमंत्रित करना है।
जब भी एजेंट एंडपॉइंट पूरी तरह सार्वजनिक न हो, सुरक्षा मेटाडेटा घोषित करें — और कभी भी क्रेडेंशियल को ही एम्बेड न करें।
उसी वैध Agent Card को /.well-known/agent-card.json पर प्रकाशित करें (और लेगेसी agent.json पथ पर भी जब तक क्लाइंट दोनों की जाँच करते रहें)।
सामान्य प्रश्न
Agent Card वैलिडेटर से जुड़े सामान्य प्रश्न
आपका एजेंट किसी A2A क्लाइंट तक पहुँचे उससे पहले आवश्यक बातें सही करें।
मान्य उदाहरणों की तुलना करेंवैलिडेटर किस A2A संस्करण को लक्षित करता है?
जाँच A2A v1.0 Agent Card संरचना का पालन करती है — supportedInterfaces, प्रति-इंटरफेस प्रोटोकॉल संस्करण, आवश्यक स्किल टैग, provider.organization। v1.0 से पहले के Agent Card सीधे अस्वीकार नहीं किए जाते: लेगेसी फ़ील्ड सटीक v1.0 प्रतिस्थापन के साथ चेतावनी के रूप में सामने आते हैं।
यह दोनों well-known URL की जाँच क्यों करता है?
v1.0 विनिर्देश /.well-known/agent-card.json को पंजीकृत करता है, लेकिन पहले के A2A कार्यान्वयन /.well-known/agent.json का उपयोग करते थे। दोनों की जाँच क्लाइंट के विफल होने से पहले डिस्कवरी अंतराल को पकड़ लेती है।
क्या चेतावनियों को अनदेखा किया जा सकता है?
चेतावनियाँ JSON त्रुटियों की तरह अवरुद्ध नहीं करतीं, लेकिन वे आमतौर पर उस मेटाडेटा की ओर इशारा करती हैं जो एजेंट को खोजने, भरोसा करने, और कॉल करने में आसान बनाता है — या v1.0 से पहले के उन फ़ील्ड की ओर जिन्हें नए क्लाइंट पढ़ना बंद कर देंगे।
सत्यापन कब चलाया जाना चाहिए?
तीन क्षण: विकास के दौरान Agent Card संपादित करते समय, तैनाती से पहले CI गेट के रूप में, और प्रकाशन के बाद — यह पुष्टि करने के लिए लाइव सेवा URL पेस्ट करें कि क्लाइंट को दोनों डिस्कवरी पथों से वास्तव में क्या मिलता है।
सत्यापन के लिए तैयार
क्लाइंट के खोजने से पहले अपने Agent Card को सत्यापित करें।
एकीकृत वैलिडेटर वर्कस्पेस से JSON पेस्ट करें, Agent Card फ़ाइल डालें, या पब्लिक URL जाँचें।