डेवलपर और एजेंट संसाधन
Ivy द्वारा प्रकाशित हर मशीन-पठनीय दस्तावेज़, एक ही जगह। न कोई कुंजी, न साइनअप, न रेट-लिमिट की बातचीत — नीचे दिया हर एंडपॉइंट एक सार्वजनिक GET है।
Ivy इस तरह बनाया गया है कि सॉफ़्टवेयर इसे उतनी ही आसानी से इस्तेमाल कर सके जितनी आसानी से लोग। साइट अपनी सार्वजनिक सतह का OpenAPI 3.1 विवरण, उत्तर इंजनों के लिए llms.txt सारांश, /.well-known/ के अंतर्गत डिस्कवरी दस्तावेज़, और Accept-हेडर नेगोशिएशन के ज़रिए हर मार्केटिंग पेज का text/markdown रूप देती है। इस पेज पर मौजूद हर चीज़ स्थिर, संस्करणबद्ध और ऑटोमेशन के लिए सुरक्षित है।
API विनिर्देश
सार्वजनिक API के मशीन-पठनीय विवरण। दोनों दस्तावेज़ एक ही स्रोत से बनते हैं, इसलिए वे कभी अलग नहीं हो सकते।
सार्वजनिक एजेंट API
बिना प्रमाणीकरण वाले चार JSON एंडपॉइंट, जो बताते हैं कि Ivy क्या है, कोई एजेंट इसे कब चुने, और इसे कहाँ से डाउनलोड करें।
एजेंट क्षमताएँ
/api/v1/agent/capabilitiesसमर्थित कोडिंग एजेंट और भाषा मॉडल, हर एक के फ़ीचर मैट्रिक्स के साथ।
एजेंट निर्देश
/api/v1/agent/instructionsTendril का उपयोग कब करें, कब न करें, इसे कैसे बुलाएँ, और शुरुआत का रास्ता।
कंपनी और उत्पाद संदर्भ
/api/v1/agent/contextसंगठन का विवरण, उत्पाद सूची, मूल्य स्तर, और पूरा एंडपॉइंट मानचित्र।
रिलीज़ डाउनलोड
/api/v1/agent/downloadsTendril का मौजूदा रिलीज़, हर समर्थित प्लेटफ़ॉर्म के इंस्टॉलर URL के साथ।
उत्तर-इंजन संसाधन
llms.txt परंपरा के अनुसार, बड़े भाषा मॉडलों के लिए लिखे गए सादे-पाठ सारांश।
llms.txt सारांश
/llms.txtIvy, Tendril, डेवलपर संसाधनों और एजेंटों द्वारा उन्हें बुलाने के तरीके का संक्षिप्त अवलोकन।
llms-full.txt विस्तृत सारांश
/llms-full.txtविस्तारित संस्करण, जिसमें हर मार्केटिंग पेज, मूल्य स्तर और प्रकाशित लेख शामिल है।
agent-instructions.txt
/agent-instructions.txtTendril का मूल्यांकन या इंस्टॉल करने वाले स्वायत्त एजेंटों के लिए संचालन निर्देश।
डिस्कवरी दस्तावेज़
well-known URI, जिनसे कोई क्लाइंट यह बताए बिना कि क्या कहाँ है, ख़ुद को कॉन्फ़िगर कर सकता है।
Model Context Protocol मैनिफ़ेस्ट
/.well-known/mcp.jsonModel Context Protocol बोलने वाले एजेंटों के लिए MCP सर्वर डिस्क्रिप्टर।
Universal Commerce Protocol मैनिफ़ेस्ट
/.well-known/ucp/manifest.jsonकॉमर्स एजेंटों के लिए घोषित प्रदाता पहचान, सेवा श्रेणी और मूल्य निर्धारण।
security.txt
/.well-known/security.txtRFC 9116 के अनुसार, सुरक्षा भेद्यता की रिपोर्ट कहाँ करें।
Markdown कंटेंट नेगोशिएशन
किसी भी मार्केटिंग पेज पर Accept: text/markdown भेजिए और HTML के बजाय साफ़ markdown मिलेगा — न स्क्रैपिंग, न DOM पार्सिंग। यह acceptmarkdown.com की परंपरा का पालन करता है।
curl -H 'Accept: text/markdown' https://ivy.app/productदर सीमाएँ
सार्वजनिक एंडपॉइंट IETF मसौदा मानक के RateLimit हेडर के ज़रिए अपना अनुरोध बजट बताते हैं, ताकि क्लाइंट सीमा पहले से जान सके, न कि कटने पर पता चले। दस्तावेज़ कैश से परोसे जाते हैं और हर घंटे पुनः सत्यापित होते हैं, इसलिए Cache-Control का पालन करने वाला क्लाइंट बजट ख़त्म नहीं कर सकता। यदि बजट कभी पार हो जाए, तो प्रतिक्रिया 429 होती है, Retry-After हेडर और RFC 9457 के problem दस्तावेज़ के साथ।
संस्करण और अप्रचलन
एजेंट एंडपॉइंट पथ में संस्करणबद्ध हैं (/api/v1/)। असंगत बदलाव मौजूदा संस्करण को बदलने के बजाय नए संस्करण के तहत आते हैं। किसी ऑपरेशन को हटाने से पहले उसे OpenAPI दस्तावेज़ में अप्रचलित चिह्नित किया जाता है और हटाने से कम से कम 180 दिन पहले तक Deprecation तथा Sunset हेडर भेजे जाते हैं, RFC 9745 और RFC 8594 के अनुसार।
Ivy के साथ बनाएँ
Tendril सोर्स-उपलब्ध है और ऑर्केस्ट्रेशन परत आपकी अपनी मशीन पर चलती है।