मुख्य सामग्री पर जाएं

EKB चैटबॉट को MS Teams में एकीकृत करें

EKB को Microsoft Teams के साथ एकीकृत करने से आप बुद्धिमान, संदर्भ-जागरूक चैट सीधे अपनी टीम के सहयोग वातावरण में ला सकते हैं। यह गाइड Microsoft Teams में EKB चैटबॉट सेटअप करने के लिए चरणों में आपका मार्गदर्शन करता है, जिससे Teams इंटरफ़ेस छोड़े बिना आपके AI एजेंट के साथ सहज संचार सक्षम होता है।

पूर्व-आवश्यकताएँ​

  • बॉट बनाने के लिए Azure तक एडमिन पहुँच
  • Teams Dev Portal तक एडमिन पहुँच

सेटअप चरण​

1. Azure Bot बनाएँ​

  1. Azure डैशबोर्ड पर जाएँ।
  2. Create Resource पर क्लिक करें।
  3. खोज बार में Bot टाइप करें और Azure Bot चुनें।
  4. एक नया Azure Bot बनाएँ और वांछित प्रदर्शन नाम सेट करें।

2. Bot कॉन्फ़िगर करें​

  1. Configuration टैब पर जाएँ और Messaging Endpoint को अपने सर्वर URL की ओर इंगित करने के लिए अपडेट करें।
    जानकारी
    Cloud ग्राहक, कृपया https://api.getodin.ai/teams/events दर्ज करें
    On-Premise ग्राहक, कृपया <your backend root URL>/teams/events दर्ज करें

    Messaging Endpoint कॉन्फ़िगरेशन
  2. Configuration टैब में, App ID और Tenant ID कॉपी करें, फिर Manage Passwords पर जाएँ।
  3. बॉट के लिए एक नया पासवर्ड बनाएँ और बाद में उपयोग के लिए इसे सहेजें।
  4. Azure में बॉट के लिए streaming endpoint सक्षम करें और उस एंडपॉइंट के URL की ओर इसे इंगित करें।

3. Teams चैनल सक्षम करें​

  1. Azure पोर्टल के बाईं ओर Channels पर क्लिक करें और बॉट के लिए Teams इंटरैक्शन चैनल सक्षम करें।

4. EKB में Bot पंजीकृत करें​

जानकारी
Cloud ग्राहक, कृपया AA Support के साथ सहायता टिकट खोलें और अपना App ID, Tenant ID और App Password प्रदान करें ताकि बॉट आपके लिए पंजीकृत किया जा सके।
  1. EKB में, Super Admin पृष्ठ पर जाएँ और बाईं ओर Teams Bots चुनें।
  2. Register Bot पर क्लिक करें।
  3. चरण 6–7 में एकत्र किया गया App ID, Tenant ID और Password दर्ज करें। Register Bot पर क्लिक करें।

5. Teams Dev Portal में App बनाएँ​

  1. Teams Developer Portal पर जाएँ।
  2. New App पर क्लिक करें।
  3. ऐप जानकारी भरें:
    • Short Description — आवश्यक, रिक्त नहीं हो सकता।
    • Long Description — आवश्यक, रिक्त नहीं हो सकता।
  4. App ID फ़ील्ड को Azure से बॉट के App ID से भरें।

6. Bot सुविधाएँ कॉन्फ़िगर करें​

  1. App Features पर जाएँ और बॉट जोड़ें, Azure से App ID प्रदान करें।
  2. बॉट क्षमताओं को निम्नानुसार कॉन्फ़िगर करें:
    Teams Bot क्षमताएँ

7. तैनात करें​

  1. अपने संगठन की नई Teams एप्लिकेशन तैनात करने के लिए मानक नीति के अनुसार पैकेज तैनात करें।
  2. बॉट को किसी प्रोजेक्ट से कनेक्ट करने के लिए, पहले संदेश के रूप में उसे !setupme (सिर्फ़ आपके लिए) या !setup (बातचीत में सभी के लिए) भेजें। देखें बॉट को प्रोजेक्ट से कनेक्ट करना।

अनुशंसित तैनाती विधि​

  1. संगठन को प्रकाशित करें

    Microsoft Teams Developer Dashboard में ऐप पेज पर, बाएँ साइडबार के नीचे तक स्क्रॉल करें। Publish के अंतर्गत, Publish to org चुनें।
    संगठन को प्रकाशित करें

  2. एडमिन सहमति प्रदान करें

    ऐप आपके Teams इंस्टेंस में पोस्ट किया जाएगा और उसे व्यवस्थापक सहमति की आवश्यकता हो सकती है। सहमति Microsoft Teams Admin Center से प्रदान की जा सकती है।

  3. प्रसार की प्रतीक्षा करें

    सहमति प्रदान करने के बाद, बॉट उपयोग योग्य होने से पहले अनुमतियों के प्रसार के लिए कुछ घंटे प्रतीक्षा करें। यह विलंब Microsoft की कस्टम एप्लिकेशन की आंतरिक समीक्षा प्रक्रिया के कारण होता है, भले ही वे केवल एक संगठन तक सीमित हों।

बॉट को प्रोजेक्ट से कनेक्ट करना​

बॉट किसी Odin प्रोजेक्ट से उत्तर देता है और उस पर काम करने के लिए API key और secret का उपयोग करता है। प्रोजेक्ट कनेक्ट करने के दो तरीके हैं, और दोनों Teams में एक छोटा फ़ॉर्म खोलते हैं। चैनलों और ग्रुप चैट में कमांड भेजते समय बॉट को @mention करें, उदाहरण के लिए @Odin !setup।

साझा कनेक्शन (!setup)​

!setup बातचीत में सभी के लिए एक प्रोजेक्ट कनेक्ट करता है, जिसमें प्रोजेक्ट ID के साथ ऐसी API key और secret का उपयोग होता है जिनकी उस प्रोजेक्ट तक पहुँच हो।

डिफ़ॉल्ट रूप से, साझा कनेक्शन की ग्रैन्युलैरिटी प्रति बॉट, प्रति Teams इंस्टेंस होती है: यह पूरे Teams इंस्टेंस पर लागू होता है, जिसमें सभी चैनल, ग्रुप और डायरेक्ट मैसेज शामिल हैं।

व्यक्तिगत कनेक्शन (!setupme)​

!setupme आपका अपना Odin खाता कनेक्ट करता है। अपनी खाता सेटिंग्स से API key और secret दर्ज करें (प्रोजेक्ट-स्तर की key स्वीकार नहीं की जाती) और, वैकल्पिक रूप से, किसी ऐसे प्रोजेक्ट की ID जिस तक आपकी पहुँच हो। अपने व्यक्तिगत Autopilot प्रोजेक्ट का उपयोग करने के लिए प्रोजेक्ट ID खाली छोड़ दें।

व्यक्तिगत कनेक्शन सिर्फ़ आपको उत्तर देता है, और हमेशा साझा कनेक्शन से ऊपर प्राथमिकता रखता है। !resetme इसे हटा देता है, जिसके बाद बॉट आपको फिर से साझा कनेक्शन से उत्तर देता है।

प्रति-चैनल सेटिंग्स (केवल ऑन-प्रिमाइस)​

अधिक ग्रैन्युलैरिटी के लिए — जैसे चैनल, ग्रुप या उपयोगकर्ता के अनुसार एक ही बॉट को कई प्रोजेक्ट के साथ उपयोग करना — निम्न बैकएंड environment variable सेट करें:

TEAMS_USE_PER_CHANNEL_SETTINGS=TRUE

इसके सेट होने पर, !setup हर चैनल के लिए (और डायरेक्ट मैसेज में हर व्यक्ति के लिए) एक प्रोजेक्ट कनेक्ट करता है, और किसी चैनल में !setupme से बनाया गया व्यक्तिगत कनेक्शन केवल उसी चैनल पर लागू होता है। डायरेक्ट मैसेज में बनाया गया व्यक्तिगत कनेक्शन बॉट के साथ आपके डायरेक्ट मैसेज पर लागू होता है।

जानकारी

यह सेटिंग केवल ऑन-प्रिमाइस ग्राहकों के लिए उपलब्ध है। क्लाउड-होस्टेड डिप्लॉयमेंट के लिए यह समर्थित नहीं है।

एजेंट का चयन​

बॉट प्रोजेक्ट के वर्तमान डिफ़ॉल्ट एजेंट से उत्तर देता है। बिना Project ID वाला व्यक्तिगत कनेक्शन आपके Autopilot प्रोजेक्ट का उपयोग करता है, जो Odin के Autopilot एजेंट के रूप में उत्तर देता है।

अगर प्रोजेक्ट अपनी Teams App सेटिंग्स में एजेंट चुनने की अनुमति दें चालू करता है, तो व्यक्तिगत कनेक्शन (!setupme) वाला कोई भी व्यक्ति अपने लिए दूसरा एजेंट चुन सकता है: !agent टाइप करें, या होम कार्ड पर Change agent दबाएँ, और उन एजेंटों में से चुनें जिनका उपयोग आपकी भूमिका Odin की वेब चैट में कर सकती है, Autopilot सहित। Project default हमेशा उसी एजेंट का पालन करता है जो प्रोजेक्ट में सेट है, भले ही वह बाद में बदल जाए।

आपका चुनाव सिर्फ़ आपके अपने कनेक्शन पर लागू होता है। उसी प्रोजेक्ट के लिए !setupme दोबारा चलाने पर यह बना रहता है, कोई दूसरा प्रोजेक्ट कनेक्ट करने पर हट जाता है, और एजेंट बदलने पर बातचीत का इतिहास बना रहता है। साझा कनेक्शन (!setup) हमेशा प्रोजेक्ट के डिफ़ॉल्ट एजेंट से उत्तर देते हैं। अगर आपका चुना हुआ एजेंट हटा दिया जाता है, या आपकी भूमिका की उस तक पहुँच खत्म हो जाती है, तो बॉट आपको एक बार बताता है और प्रोजेक्ट के डिफ़ॉल्ट एजेंट पर लौट आता है। सेटिंग बंद करने पर सभी डिफ़ॉल्ट एजेंट पर लौट आते हैं।

बॉट का उपयोग​

होम कार्ड​

यह देखने के लिए !home टाइप करें कि बॉट किस प्रोजेक्ट से कनेक्ट है, वह क्या कर सकता है, और आज़माने के लिए कुछ सुझाए गए प्रश्न। कार्ड में प्रोजेक्ट बदलने और प्रोजेक्ट के इंटीग्रेशन देखने के बटन होते हैं। व्यक्तिगत चैट में पहली बार इंस्टॉल होने पर भी बॉट इसे दिखाता है। जब आपका कनेक्शन अपना एजेंट चुन सकता है, तो कार्ड यह भी दिखाता है कि कौन सा एजेंट आपको उत्तर दे रहा है, साथ में एक Change agent बटन।

लाइव स्टेटस​

जब एजेंट काम कर रहा होता है, तो उत्तर आने से पहले बॉट दिखाता है कि वह क्या कर रहा है — Thinking..., या वह टूल जिसका वह उपयोग कर रहा है। व्यक्तिगत चैट में यह एक लाइव स्टेटस लाइन के रूप में दिखता है; चैनलों और ग्रुप चैट में बॉट का संदेश उसी जगह अपडेट होता है। बातचीत में केवल अंतिम उत्तर ही रहता है। इसे Teams ऐप सेटिंग्स में लाइव स्टेटस टॉगल से बंद किया जा सकता है।

इंटीग्रेशन कनेक्ट करना​

जब एजेंट को ऐसे इंटीग्रेशन की ज़रूरत होती है जो अभी कनेक्ट नहीं है, तो बॉट एक कार्ड पोस्ट करता है:

  • OAuth से साइन इन करने वाली सेवाओं (जैसे Gmail या Notion) के लिए, Connect चुनें, अपने ब्राउज़र में साइन इन पूरा करें, फिर Continue चुनें।
  • API key या token का उपयोग करने वाली सेवाओं के लिए, Connect चुनें और खुलने वाले फ़ॉर्म में क्रेडेंशियल दर्ज करें।

!integrations प्रोजेक्ट द्वारा कनेक्ट किए गए इंटीग्रेशन और जिन्हें वह कनेक्ट कर सकता है, उनकी सूची दिखाता है। इंटीग्रेशन को कनेक्ट और डिस्कनेक्ट करने का काम Odin में होता है।

अनुमोदन और प्रश्न​

अगर एजेंट कोई ऐसी कार्रवाई चलाना चाहता है जिसके लिए आपकी अनुमति चाहिए, तो बॉट उस कार्रवाई का विवरण Allow और Deny बटनों के साथ दिखाता है। अगर उसे और जानकारी चाहिए, तो वह एक छोटे फ़ॉर्म से पूछता है जिसका उत्तर आप सीधे Teams में दे सकते हैं।

बॉट द्वारा स्वीकार किए जाने वाले सभी कमांड के लिए उपलब्ध कमांड देखें।