कस्टम कनेक्टर

आप कौन-सा अनुभव उपयोग कर रहे हैं?

ये दस्तावेज़ दोनों अनुभवों को कवर करते हैं। यदि Settings → Personal → My Okou उपलब्ध है, तो My Okou के चरणों का पालन करें। यदि आप New agent वाले Agents पेज का उपयोग करते हैं, तो Legacy Agents के चरणों का पालन करें। उपलब्धता अलग-अलग सदस्यों के लिए भिन्न हो सकती है; ये दस्तावेज़ आपका अनुभव नहीं बदलते।

किसी भी अनुभव में, आप एक साथ कई चैट या कार्य चला सकते हैं, वर्कफ़्लो का पुनः उपयोग कर सकते हैं, और समीक्षा किए गए काम को अपनी टीम के साथ साझा कर सकते हैं। रनटाइम उप-एजेंट एक निष्पादन उपकरण है, कोई अलग उत्पाद प्रोफ़ाइल नहीं जिसे आपको बनाना पड़े।

सेटअप में अंतर: My Okou, Settings → Personal → My Okou में व्यक्तिगत निर्देश (Instructions) और कार्यक्षेत्र वर्कफ़्लो का उपयोग करता है। नीचे दिया गया कोई भी चरण जिसमें आपसे किसी नामित Agent को चुनने, बनाने या अधिकृत करने के लिए कहा गया हो, वह केवल Legacy Agents पर लागू होता है। My Okou में, अपनी स्वयं की Chat का उपयोग करें और दिखाए गए खाते तथा नामित-अनुमति अनुरोध का पालन करें। साझा वर्कफ़्लो क्रेडेंशियल साझा नहीं करते; Automations अपने स्वामी के संदर्भ और पहुँच का उपयोग करती हैं।

कस्टम कनेक्टर संगठन के व्यवस्थापक को ऐसा HTTPS API या, जहाँ सक्षम हो, ऐसा Streamable HTTP MCP सर्वर पंजीकृत करने देता है जो अंतर्निहित कैटलॉग में नहीं है। यह नेटवर्क सीमा और प्रमाणीकरण की विधि को परिभाषित करता है। यह Agent के लिए अपने-आप कोई पूर्ण API संदर्भ उत्पन्न नहीं करता।

कौन क्या कॉन्फ़िगर करता है

• संगठन व्यवस्थापक कनेक्टर की परिभाषा बनाते, संपादित करते और हटाते हैं।
• सदस्य अपना स्वयं का सीक्रेट जोड़ते हैं या कनेक्टर का OAuth प्रवाह पूरा करते हैं।
• प्राधिकरण और अनुमतियाँ नियंत्रित करती हैं कि Okou इस कनेक्शन के साथ कौन-सी नामित क्रियाओं का अनुरोध कर सकता है। Legacy Agents, Agent-विशिष्ट प्राधिकरण का भी उपयोग करते हैं।

यह परिभाषा पूरे संगठन में साझा होती है। सदस्यों के क्रेडेंशियल सदस्य और संगठन तक ही सीमित रहते हैं।

HTTP API कनेक्टर

1. Connectors → Custom खोलें और New connector चुनें।
2. HTTP API चुनें और एक प्रदर्शन नाम दर्ज करें।
3. एक या अधिक HTTPS Prefixes जोड़ें, प्रत्येक पंक्ति में एक। कनेक्टर किसी अनुरोध को अधिकृत करने से पहले उसका किसी कॉन्फ़िगर किए गए प्रीफ़िक्स से मेल खाना आवश्यक है।
4. यदि API को इसकी आवश्यकता हो, तो प्रमाणीकरण जोड़ें:
   • API authentication: हेडर का नाम और {{secret}} वाला हेडर टेम्पलेट दर्ज करें, उदाहरण के लिए Authorization और Bearer {{secret}}।
   • OAuth 2.0: authorization URL, token URL, client ID, client secret, scopes और token-endpoint authentication method दर्ज करें। फ़ॉर्म में दिखाया गया सटीक redirect URL प्रदाता के साथ पंजीकृत करें।
5. कनेक्टर बनाएँ। इसके बाद जिसे इसकी आवश्यकता हो, वह प्रत्येक सदस्य Connect चुनकर अपना सीक्रेट प्रदान करे या OAuth पूरा करे।
6. आवश्यक नामित अनुमतियों की समीक्षा करें और उन्हें अधिकृत करें। Legacy Agents में, इच्छित Agent भी चुनें।

किसी मौजूदा OAuth परिभाषा या उसके client credentials को बदलने पर वर्तमान OAuth कनेक्शन विच्छेदित हो जाते हैं। परिवर्तन के बाद सदस्यों को फिर से कनेक्ट करना होगा।

MCP कनेक्टर

यदि आपके कार्यक्षेत्र में कनेक्टर प्रकार के रूप में MCP दिखाई देता है, तो एक HTTPS Streamable HTTP MCP endpoint दर्ज करें और उसी फ़ॉर्म में API या OAuth प्रमाणीकरण कॉन्फ़िगर करें। यदि चयन सूची में MCP उपलब्ध नहीं है, तो वह उस कार्यक्षेत्र के लिए सक्षम नहीं है।

Agent को API प्रक्रिया सिखाएँ

कस्टम कनेक्टर सुरक्षित नेटवर्क पहुँच और क्रेडेंशियल इंजेक्शन प्रदान करता है। निर्माण फ़ॉर्म कोई OpenAPI दस्तावेज़ अपलोड नहीं करता और न ही उसे अपने-आप खोजता है। अनुरोध में Agent को endpoint, method, parameters और अपेक्षित response दें, या उस प्रक्रिया को किसी वर्कफ़्लो में सहेजें, जिसके साथ API संदर्भ फ़ाइल के रूप में संलग्न हो।

किसी ज्ञात endpoint पर सीमित, केवल-पठन अनुरोध के साथ नए कनेक्टर का सत्यापन करें। कोई सामान्य Test connection अनुरोध नहीं है, क्योंकि कई APIs कोई सार्थक root endpoint उपलब्ध नहीं करातीं।

सुरक्षा सीमाएँ

• केवल HTTPS प्रीफ़िक्स और MCP endpoints स्वीकार किए जाते हैं।
• फ़ायरवॉल सहेजे गए क्रेडेंशियल को केवल मेल खाते अनुरोधों में ही इंजेक्ट करता है।
• सहेजा गया सीक्रेट संग्रहित अवस्था में एन्क्रिप्टेड रहता है और Agent को environment variable के रूप में उजागर नहीं किया जाता।
• कुंजियाँ, tokens या client secrets को chat messages, workflow instructions या संलग्न फ़ाइलों में न रखें।
• वर्कफ़्लो के लिए आवश्यक न्यूनतम upstream scopes वाले service credential का उपयोग करें।

समस्या निवारण

आगे क्या

• बार-बार होने वाले कस्टम-कनेक्टर कार्य को सहेजने के लिए वर्कफ़्लो देखें।
• कस्टम कनेक्टर क्रेडेंशियल कैसे संभाले जाते हैं, यह जानने के लिए अनुमतियाँ देखें।
• कस्टम बनाने से पहले Catalog देखें — आपकी सेवा शायद पहले से समर्थित हो।