दस्तावेज़

कलेक्शंस

एक कलेक्शन एक नाम वाली, संस्करणित फेलबैक चेन है जो एक कैटलॉग मॉडल के लिए होती है — { model, provider }चरणों का एक परीक्षित अनुक्रम जिसे आप पब्लिश, साझा और इम्पोर्ट कर सकते हैं। इसे एक रूटिंग रेसिपी के रूप में सोचें: "llama-3.1-8b-instruct के लिए, पहले मेरा अपना GPU आज़माएं, फिर Krutrim, फिर OpenRouter।" कलेक्शंस में केवल चरण और एक README होता है — कभी भी API कुंजी (keys) नहीं।

पब्लिक रजिस्ट्री

कोई भी — मानव या एजेंट — प्रकाशित कलेक्शंस को ब्राउज़ कर सकता है; किसी प्रमाणीकरण की आवश्यकता नहीं।

एंडपॉइंट	रिटर्न्स
`GET /v1/collections`	पब्लिक रजिस्ट्री, स्टार के आधार पर शीर्ष 200 फिर हालिया (recency) के आधार पर।
`GET /v1/collections/:slug`	एक कलेक्शन अपने संस्करण इतिहास के साथ।

उपयोग करने से पहले फ़ॉर्क करें

जब आप किसी ऐसे कलेक्शन को इम्पोर्ट करते हैं जो किसी अन्य org का है, तो BharatRouter पहले उसे फ़ॉर्क करता है — आपके org में एक निजी स्नैपशॉट लेता है — और फिर उस स्नैपशॉट को लागू करता है। वंशावली (forked_from) रखी जाती है, लेकिन मूल लेखक के बाद के संपादन चुपचाप आपके रूटिंग को कभी नहीं बदलते हैं। अपने स्वयं के कलेक्शन को इम्पोर्ट करने से यह सीधे लागू होता है, कोई फ़ॉर्क नहीं। एक मौजूदा फ़ॉर्क का पुन: उपयोग किया जाता है बजाय डुप्लिकेट करने के।

इम्पोर्ट → आपका रूटिंग

इम्पोर्ट करने से कलेक्शन के चरण आपके org की सहेजी गई फेलबैक चेन के रूप में उस मॉडल के लिए सेट हो जाते हैं, जो एक मिनट के भीतर प्रभावी हो जाते हैं। तब से, उस मॉडल के लिए अनुरोध चेन का पालन करते हैं (एक प्रति-अनुरोध fallbacks सरणी अभी भी एक ही कॉल के लिए जीत जाती है)।

POST /me/collections/import/india-first-llama
→ { "ok": true, "model": "llama-3.1-8b-instruct",
    "steps": [ {"model":"llama-3.1-8b-instruct","provider":"bharatrouter"},
               {"model":"llama-3.1-8b-instruct","provider":"krutrim"} ],
    "forked_as": "india-first-llama-2" }

यदि कोई चरण किसी BYOK मॉडल (provider/model-id) या किसी BYOE एंडपॉइंट (byoe:<slug>) को संदर्भित करता है, तो यह तभी हल होता है जब आपके org के पास वह कुंजी सहेजी गई हो या वह एंडपॉइंट पंजीकृत हो — अनुरोध के समय अनसुलझे चरणों को छोड़ दिया जाता है, ठीक वैसे ही जैसे चेन में एक खाली लिंक।

बनाना & प्रबंधित करना

एंडपॉइंट	यह क्या करता है
`GET /me/collections`	आपकी org के कलेक्शंस (निजी, सार्वजनिक, फ़ॉर्क किए गए)।
`POST /me/collections`	एक बनाएं — `name`, `model`, `steps`, `description?`, `readme_md?`, `public?` (स्वामी/व्यवस्थापक)।
`PATCH /me/collections/:id`	इसे संपादित करें; चरणों या README में बदलाव करने से संस्करण बढ़ जाता है (स्वामी/व्यवस्थापक)।
`DELETE /me/collections/:id`	इसे हटा दें (स्वामी/व्यवस्थापक)।
`POST /me/collections/star/:slug`	एक स्टार टॉगल करें (प्रति org एक — रैंकिंग सिग्नल)।
`POST /me/collections/fork/:slug`	एक पब्लिक कलेक्शन को इम्पोर्ट किए बिना अपने org में फ़ॉर्क करें।
`POST /me/collections/import/:slug`	यदि विदेशी है तो फ़ॉर्क करें, फिर अपने रूटिंग के रूप में लागू करें (स्वामी/व्यवस्थापक)।

सदस्य स्टार और फ़ॉर्क कर सकते हैं; केवल मालिक और व्यवस्थापक ही बना, संपादित, हटा या इम्पोर्ट कर सकते हैं। सीमाएँ: प्रति org अधिकतम 50 कलेक्शंस, README अधिकतम 20,000 वर्ण, नाम अधिकतम 80 वर्ण। स्लग आपके org के भीतर auto-जनरेट और टकराव-प्रत्ययित होते हैं।

विश्वसनीयता मॉनिटरिंग

किसी भी कलेक्शन को मॉनिटर किया गया चिह्नित किया जा सकता है: BharatRouter तब एक शेड्यूल पर प्रत्येक चरण का कैनरी करता है और प्रति-चरण uptime और p95 latency को ट्रैक करता है, जिसमें त्रुटि दर या latency पर ईमेल/वेबहुक अलर्ट होते हैं। विश्वसनीयता मॉनिटरिंग देखें।

एजेंटों से (MCP)

एजेंट MCP पर समान सतह प्राप्त करते हैं: list_collections(पढ़ना) और import_collection (लिखना — इसके लिए user_confirmed: true की आवश्यकता होती है, उपयोग करने से पहले फ़ॉर्क लागू होता है)।