API से जुड़े किसी प्रश्न का उत्तर देने वाले एजेंट को शायद एक ऑथेंटिकेशन गाइड और एक एंडपॉइंट संदर्भ की ज़रूरत हो। पूरी वेबसाइट लोड करने पर ऐसी सामग्री भी आ जाती है जिसका उस कार्य से कोई संबंध नहीं है।
llms.txt प्रस्ताव प्रकाशकों को एक ऐसी जगह देता है जहाँ वे अपनी सामग्री का वर्णन कर सकें और उपयोगी Markdown पेजों के लिंक दे सकें।
फ़ाइल में क्या होता है?
फ़ाइल में प्रोजेक्ट का नाम होता है, और इसमें एक सारांश, मार्गदर्शन और अधिक जानकारी के समूहबद्ध लिंक भी शामिल हो सकते हैं।
प्रस्ताव Markdown का उपयोग करता है, ताकि लोग और प्रोग्राम एक ही फ़ाइल को प्रोसेस कर सकें। इसकी लिंक सूचियाँ उस सामग्री की ओर इशारा करती हैं जिसे एजेंट ज़रूरत पड़ने पर प्राप्त कर सकता है।
किसी दस्तावेज़ीकरण इंडेक्स में ऑथेंटिकेशन, संदेश भेजना और डिलीवरी इवेंट अलग-अलग शीर्षकों के अंतर्गत रखे जा सकते हैं। छोटे विवरणों की मदद से एजेंट इन गंतव्यों को डाउनलोड करने से पहले ही उनमें अंतर कर पाता है।
प्रस्ताव साइट रूट से नीचे के स्तरों पर भी इंडेक्स रखने की अनुमति देता है। किसी दस्तावेज़ीकरण पाथ के अंतर्गत रखा इंडेक्स उस पाथ के नीचे की सामग्री को कवर करता है।
क्या यह robots.txt या साइटमैप जैसा ही है?
इन फ़ाइलों के उद्देश्य अलग-अलग हैं: एक्सेस से जुड़ा मार्गदर्शन, URL खोजना, और सामग्री तक पहुँचने का चुना हुआ रास्ता।
| फ़ाइल | उद्देश्य |
|---|---|
robots.txt | स्वचालित क्लाइंट को क्रॉलिंग के नियम देती है |
| साइटमैप | सर्च इंजन के खोजने के लिए URL की सूची देता है |
llms.txt | सामग्री का वर्णन करती है और एजेंटों के लिए उपयोगी विवरण के लिंक देती है |
मौजूदा मानकों से प्रस्ताव की तुलना llms.txt को बाकी फ़ाइलों का पूरक बताती है। इसे प्रकाशित करने से सुरक्षित सामग्री तक पहुँच नहीं मिलती।
यह कोई निष्पादन-योग्य कार्रवाई भी उपलब्ध नहीं कराती। वर्कस्पेस में काम करने के लिए एजेंट को अलग से API या MCP कनेक्शन चाहिए।
क्या इसे प्रकाशित करने से साबित होता है कि एजेंट इसका उपयोग करते हैं?
पढ़ने योग्य इंडेक्स प्रकाशित करने से केवल यह तय होता है कि सामग्री उपलब्ध है। उपयोग का प्रमाण पाने के लिए आपको देखना होगा कि कोई क्लाइंट उस सामग्री को प्राप्त करके उसका उपयोग करता है।
Chrome का Lighthouse ऑडिट फ़ाइल प्राप्त करते समय सर्वर त्रुटियों की जाँच करता है। फ़ाइल वैकल्पिक है, इसलिए फ़ाइल न होने पर परिणाम "लागू नहीं" आता है। यह जाँच पास होने से यह नहीं मापा जाता कि एजेंट के उत्तर कितने अच्छे हैं।
अपने मूल्यांकन के लिए कार्य और वे दस्तावेज़ दर्ज करें जो क्लाइंट ने प्राप्त किए। जाँचें कि एजेंट सही उत्तर तक पहुँचा या इच्छित कार्रवाई पूरी की। इंडेक्स से मदद मिली या नहीं, यह आँकने के लिए समान रन की तुलना करें।
एक्सेस लॉग में दर्ज अनुरोध यह साबित करता है कि फ़ाइल प्राप्त की गई। अकेले यह साबित नहीं करता कि क्लाइंट ने उस सामग्री को अपने उत्तर में इस्तेमाल किया। उद्धरण एक और अलग अवलोकन है। परिणाम रिपोर्ट करते समय इन नतीजों को अलग-अलग रखें।
मुझे एजेंट को Bird का कौन-सा दस्तावेज़ देना चाहिए?
जब किसी एजेंट को दस्तावेज़ खोजने और प्रासंगिक पेज प्राप्त करने हों, तो आप उसे Bird का llms.txt इंडेक्स दे सकते हैं।
मशीन-पठनीय दस्तावेज़ गाइड इंडेक्स, अलग-अलग Markdown पेज और पूरे संग्रह का वर्णन करती है। इंडेक्स लिंक देता है; अलग-अलग पेज क्लाइंट को केंद्रित उत्तर प्राप्त करने देते हैं।
llms-full.txt पूरे दस्तावेज़ को स्रोत URL के साथ एक फ़ाइल में जोड़ता है। यह बड़ा रूप उस वर्कफ़्लो के लिए उपयुक्त है जिसे स्पष्ट रूप से पूरा संग्रह चाहिए, बशर्ते वह क्लाइंट की संदर्भ सीमाओं में समा सके।
निर्देश प्राप्त करने के बाद मैसेजिंग कार्य करने के लिए Bird का MCP सर्वर कनेक्ट करें। दस्तावेज़ जानकारी देते हैं; प्रमाणित कनेक्शन वर्कस्पेस संचालनों तक पहुँच देता है।