⚡ नवीन — Kimi K3 आता लाइव: तुमची Moonshot की जोडा →
दस्तऐवज

कलेक्शन्स

एक कलेक्शन म्हणजे एका कॅटलॉग मॉडेलसाठीची नाव असलेली, आवृत्तिबद्ध fallback चेन आहे — { model, provider }पायऱ्यांचा एक चाचणी केलेला क्रम जो तुम्ही पब्लिश, शेअर आणि import करू शकता. याला एक रूटिंग रेसिपी म्हणून समजा: "llama-3.1-8b-instruct साठी, आधी माझा स्वतःचा GPU वापरून पाहा, मग Krutrim, मग OpenRouter." कलेक्शन्समध्ये फक्त पायऱ्या आणि एक README असते — कधीही API keys नाहीत.

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

कोणीही — माणूस असो वा एजंट — प्रकाशित कलेक्शन्स ब्राउझ करू शकतो; कोणत्याही प्रमाणीकरणाची गरज नाही.

endpointपरत देते
GET /v1/collectionsपब्लिक रजिस्ट्री, स्टारच्या आधारे वरील 200 आणि नंतर recency च्या आधारे.
GET /v1/collections/:slugएक कलेक्शन त्याच्या आवृत्ती इतिहासासह.

वापरण्यापूर्वी fork करा

जेव्हा तुम्ही दुसऱ्या org चे एखादे कलेक्शन import करता, तेव्हा BharatRouter आधी ते fork करते — तुमच्या org मध्ये एक खाजगी स्नॅपशॉट घेते — आणि मग तो स्नॅपशॉट लागू करते. वंशावळ (forked_from) ठेवली जाते, पण मूळ लेखकाने नंतर केलेले संपादन तुमच्या रूटिंगला कधीही गुपचूप बदलत नाहीत. तुमचेच स्वतःचे कलेक्शन import केल्यास ते थेट लागू होते, कोणतेही fork नाही. एखादे विद्यमान fork डुप्लिकेट करण्याऐवजी पुन्हा वापरले जाते.

import → तुमचे रूटिंग

import केल्याने कलेक्शनच्या पायऱ्या त्या मॉडेलसाठी तुमच्या org च्या जतन केलेल्या fallback चेन म्हणून सेट होतात, ज्या एका मिनिटाच्या आत प्रभावी होतात. तेव्हापासून, त्या मॉडेलसाठीच्या विनंत्या चेनचे अनुसरण करतात (एक प्रति-विनंती fallbacks array अजूनही एकाच कॉलसाठी जिंकते).

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 endpoint ला (byoe:<slug>) संदर्भित करत असेल, तर ती तेव्हाच सोडवली जाते जेव्हा तुमच्या org कडे ती key जतन केलेली असेल किंवा तो endpoint नोंदणीकृत असेल — विनंतीच्या वेळी न सुटलेल्या पायऱ्या वगळल्या जातात, अगदी चेनमधील एका रिकाम्या लिंकप्रमाणे.

तयार करणे & व्यवस्थापित करणे

endpointहे काय करते
GET /me/collectionsतुमच्या org चे कलेक्शन्स (खाजगी, सार्वजनिक, fork केलेले).
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एखादे पब्लिक कलेक्शन import न करता तुमच्या org मध्ये fork करा.
POST /me/collections/import/:slugपरके असल्यास fork करा, मग तुमचे रूटिंग म्हणून लागू करा (मालक/प्रशासक).

सदस्य स्टार आणि fork करू शकतात; फक्त मालक आणि प्रशासकच तयार, संपादित, हटवू किंवा import करू शकतात. मर्यादा: प्रति org कमाल 50 कलेक्शन्स, README कमाल 20,000 वर्ण, नाव कमाल 80 वर्ण. slug तुमच्या org च्या आत auto-जनरेट आणि टक्कर-प्रत्ययित होतात.

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

कोणतेही कलेक्शन मॉनिटर केलेले म्हणून चिन्हांकित केले जाऊ शकते: BharatRouter मग एका शेड्यूलवर प्रत्येक पायरीचे canary करते आणि प्रति-पायरी uptime आणि p95 latency ट्रॅक करते, ज्यात त्रुटी दर किंवा latency वर ईमेल/webhook अलर्ट असतात. विश्वसनीयता मॉनिटरिंग पाहा.

एजंट्सकडून (MCP)

एजंट्सना MCP वर तीच सर्फेस मिळते: list_collections(वाचणे) आणि import_collection (लिहिणे — यासाठी user_confirmed: true ची गरज असते, वापरण्यापूर्वी fork लागू होते).