डेवलपर API
Cuneiform Chat पर बनाएं अपने ही कोड से
एक सार्वजनिक, की-आधारित प्रमाणीकरण वाला REST API जो आपके कोड को वही करने देता है जो डैशबोर्ड करता है — ज्ञान भरें, अपने AI एजेंट प्रबंधित करें, और उन्हें कहीं से भी क्वेरी करें। एक bearer की, अनुमानयोग्य JSON, और एक ऐसा संदर्भ जिससे आप कॉपी कर सकते हैं।
API से आप क्या बना सकते हैं
ज्ञान को प्रोग्रामैटिक रूप से इनजेस्ट करें
अपने कोड या पाइपलाइन से सीधे किसी एजेंट के ज्ञान-आधार में दस्तावेज़ भेजें। फ़ाइलें पार्स होती हैं, खंडों में बँटती हैं, एम्बेड होती हैं और खोजने योग्य बनती हैं — वही RAG स्टैक जिसे डैशबोर्ड इस्तेमाल करता है, एक API कॉल से संचालित।
एजेंट को कोड की तरह प्रबंधित करें
API के ज़रिए अपने AI एजेंट बनाएं, सूचीबद्ध करें, अपडेट करें और जाँचें। एजेंट कॉन्फ़िगरेशन को अपने प्रोविज़निंग या CI में जोड़ें ताकि नया एजेंट एक डिप्लॉय चरण बने, न कि डैशबोर्ड पर एक क्लिक।
किसी एजेंट को कहीं से भी क्वेरी करें
किसी भी एजेंट को एक प्रश्न भेजें और एक आधारित उत्तर पाएं, उसी रिट्रीवल और रीज़निंग के साथ जो आपके चैनल इस्तेमाल करते हैं। इसे किसी ऐप, बैकएंड जॉब, या किसी अन्य उत्पाद में एम्बेड करें।
स्कोप वाली, रद्द करने योग्य API कीज़
किसी वर्कलोड को जितने स्कोप चाहिए केवल उतने के साथ कीज़ बनाएं और लीक होते ही उन्हें रद्द कर दें। कीज़ के आगे cuk_live_ उपसर्ग रहता है और वे केवल एक बार दिखाई जाती हैं — डिज़ाइन से ही न्यूनतम विशेषाधिकार।
अनुमानयोग्य त्रुटियाँ और दर सीमाएँ
हर प्रतिक्रिया एक स्थिर संरचना वाला JSON है, जिसमें संगत त्रुटि कोड और स्पष्ट दर-सीमा हेडर होते हैं — ताकि आपका क्लाइंट बिना अनुमान लगाए पुनः प्रयास कर सके, बैक-ऑफ कर सके और विफलताएँ दिखा सके।
एक ऐसा संदर्भ जिससे आप कॉपी कर सकते हैं
एक पूर्ण, प्रकाशित संदर्भ प्रमाणीकरण, परिपाटियों, त्रुटियों, दर सीमाओं और तीनों डोमेन के हर एंडपॉइंट को कवर करता है — पेस्ट करने के लिए तैयार अनुरोध और प्रतिक्रिया उदाहरणों के साथ।
की से पहली प्रतिक्रिया तक
खाली टर्मिनल से एक लाइव इंटीग्रेशन तक पाँच चरण।
एक की प्राप्त करें
अपने डैशबोर्ड में डेवलपर कंसोल खोलें और इंटीग्रेशन के लिए ज़रूरी स्कोप चुनते हुए एक API की जारी करें। इसे केवल एक बार कॉपी करें — यह cuk_live_ से शुरू होती है।
प्रमाणित करें
हर अनुरोध में की को Authorization: Bearer के रूप में भेजें (X-API-Key हेडर एक प्रलेखित उपनाम है)। न कोई OAuth झंझट, न ही रिफ़्रेश करने योग्य कोई सत्र।
एक एंडपॉइंट कॉल करें
/api/developer/v1 के अंतर्गत किसी भी पथ पर जाएं — Knowledge में इनजेस्ट करें, Agents प्रबंधित करें, या कोई Agent Query चलाएं। वही बेस URL, वही प्रमाणीकरण, तीन डोमेन।
प्रतिक्रिया संभालें
JSON बॉडी पार्स करें, दर-सीमा हेडर पढ़ें, और कुछ गलत होने पर त्रुटि कोड के अनुसार शाखा चुनें। संरचना हर एंडपॉइंट पर स्थिर रहती है।
शिप करें और स्केल करें
एक curl परीक्षण से प्रोडक्शन तक जाएं: कीज़ रोटेट करें, प्रति वर्कलोड स्कोप दें, और प्रलेखित दर सीमाएँ आपके क्लाइंट के पुनः-प्रयास और समवर्तीता का मार्गदर्शन करें।
उपयोग के मामले
टीमें API पर क्या बनाती हैं
अपने सिस्टम से ज्ञान सिंक करें
नए दस्तावेज़, हेल्प-सेंटर लेख या उत्पाद विनिर्देश किसी एजेंट के ज्ञान-आधार में भेजने के लिए एक रात्रिकालीन जॉब या एक webhook जोड़ें — ताकि किसी के डैशबोर्ड छुए बिना ही उत्तर अद्यतन रहें।
अपने उत्पाद में एक एजेंट एम्बेड करें
जिस सतह के लिए हम कोई चैनल नहीं देते, वहाँ एक आधारित AI सहायक जोड़ने के लिए अपने ऐप या बैकएंड से क्वेरी एंडपॉइंट कॉल करें — आपका मोबाइल ऐप, कोई आंतरिक टूल, कोई कस्टम विजेट।
CI/CD में एजेंट प्रोविज़न करें
एजेंट को एक डिप्लॉय पाइपलाइन के हिस्से के रूप में बनाएं और कॉन्फ़िगर करें, ताकि कोई नया एनवायरनमेंट या ग्राहक टेनेंट खड़ा करने पर उसका AI एजेंट एक मैनुअल सेटअप चरण नहीं, बल्कि कोड के रूप में शामिल हो।
बैक-ऑफ़िस वर्कफ़्लो स्वचालित करें
एक स्क्रिप्ट से किसी एजेंट को निर्धारित समय पर अपने ज्ञान-आधार पर सारांश बनाने, वर्गीकृत करने या उत्तर देने को कहें, और परिणाम को वहाँ रूट करें जहाँ आपकी टीम पहले से काम करती है।
आंतरिक टूल और डैशबोर्ड को सशक्त करें
एजेंट के उत्तरों को अपने ही Slack बॉट, ऑप्स डैशबोर्ड या सपोर्ट कंसोल में लाएं — इंटीग्रेशन के लिए एक bearer की और एक JSON प्रतिक्रिया ही काफ़ी है।