एजेंट की एक डिस्कवरी फ़ाइल पढ़ी नहीं जा सकती
/.well-known/ के नीचे की एक फ़ाइल, जिसे एजेंट खोजते हैं, जवाब तो देती है, पर पढ़ी नहीं जा सकती: agent-card.json (A2A एजेंट कार्ड), mcp.json (MCP सर्वर डिस्क्रिप्टर), api-catalog (RFC 9727) या, दुकानों पर, ucp। यह मान्य JSON नहीं है, या इसमें कोई ज़रूरी फ़ील्ड नहीं है, जैसे एजेंट कार्ड का name या API कैटलॉग का linkset।
इसका मतलब
/.well-known/ के नीचे की एक फ़ाइल, जिसे एजेंट खोजते हैं (एजेंट कार्ड, MCP डिस्क्रिप्टर, API कैटलॉग या UCP प्रोफ़ाइल), जवाब देती है, लेकिन मान्य JSON के साथ नहीं, या ज़रूरी फ़ील्ड के बिना। जो एजेंट इसे पाते हैं, वे वहीं रुक जाते हैं। फ़ाइल ठीक करें या हटा दें।
AI सर्च के लिए यह क्यों मायने रखता है
ये फ़ाइलें एजेंट को बताती हैं कि साइट क्या देती है: बात करने के लिए एक एजेंट, MCP सर्वर, API, ख़रीदने का तरीका। जो एजेंट इनमें से कोई फ़ाइल पाता है और उसे पार्स नहीं कर पाता, वह अंदाज़ा लगाने के बजाय वहीं रुक जाता है।
ज़्यादातर साइटों को इनमें से किसी की ज़रूरत नहीं होती, इसलिए फ़ाइल न होने की कभी रिपोर्ट नहीं होती। जो फ़ाइल मौजूद है पर टूटी है, वह आम तौर पर किसी टेस्ट, टेम्पलेट या प्लगइन से आती है जिसे सेट करके भुला दिया गया।
इसे कैसे ठीक करें
- सबूत से हर फ़ाइल खोलें और उसे किसी JSON वैलिडेटर से जाँचें।
- फ़ाइल के अपने स्पेसिफ़िकेशन के अनुसार सिंटैक्स ठीक करें और ज़रूरी फ़ील्ड जोड़ें।
- इसे
Content-Type: application/jsonके साथ परोसें (API कैटलॉग के लिएapplication/linkset+json)। - अगर साइट वह नहीं देती जिसका वर्णन फ़ाइल में है, तो फ़ाइल हटा दें। नतीजा पक्का करने के लिए पेज रिपोर्ट में "दोबारा जाँचें" चलाएँ।
उदाहरण
{
"name": "Example support agent",
"description": "Answers questions about orders",
"url": "https://example.com/a2a",
"version": "1.0.0",
"skills": []
} सुधार की पुष्टि कैसे करें
बदलाव के बाद रिपोर्ट पर "दोबारा जाँचें" दबाएँ: यह बताती है कि क्या ठीक हुआ और स्कोर कैसे बदला।