इसके माध्यम से साझा किया गया

किसी कौशल को उपयोग के लिए कॉन्फ़िगर करें Bot Framework Copilot Studio

  • आलेख

महत्त्वपूर्ण

Power Virtual Agents जनरेटिव एआई और उन्नत एकीकरण में महत्वपूर्ण निवेश के बाद, अब इसकी क्षमताएं और विशेषताएं इसका हिस्सा बन गई हैं। Microsoft Copilot Studio Microsoft Copilot

कुछ लेख और स्क्रीनशॉट इस बात का संदर्भ दे सकते हैं कि Power Virtual Agents जब हम दस्तावेज़ और प्रशिक्षण सामग्री को अपडेट करते हैं।

Copilot Studio आपको Bot Framework कौशल का उपयोग करके अपने सह-पायलट का विस्तार करने देता है। यदि आपने पहले से ही अपने संगठन में विशिष्ट परिदृश्यों के लिए (SDK और प्रो-कोड टूल का उपयोग करके) बॉट बनाए और तैनात किए हैं, तो आप उन बॉट को एक कौशल में परिवर्तित कर सकते हैं और उस कौशल को एक कोपायलट में पंजीकृत कर सकते हैं। Bot Framework Copilot Studio

नोट

Copilot Studio ऐप के भीतर से कोई कौशल जोड़ने के लिए, आपके पास Microsoft Teamsस्टैंडअलोन सदस्यता Microsoft Copilot Studio होनी चाहिए।

यह आलेख उन सिस्टम प्रशासकों या आईटी पेशेवरों के लिए है जो Bot Framework कौशल से परिचित हैं। किसी कौशल को सह-पायलट के साथ पंजीकृत करने के बाद, लेखक बातचीत में कौशल क्रियाओं को सहजता से ट्रिगर कर सकते हैं। Copilot Studio

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

महत्त्वपूर्ण

Copilot Studio सह-पायलट केवल Bot Framework SDK संस्करण 4.12.0+ का उपयोग करके निर्मित कौशल का समर्थन करते हैं।

क्लासिक चैटबॉट केवल Bot Framework SDK संस्करण 4.7+ का उपयोग करके निर्मित कौशल का समर्थन करते हैं।

यदि आप Bot Framework कंपोजर का उपयोग कर रहे हैं तो यह दृढ़ता से अनुशंसित है कि आप कंपोजर 2.x का उपयोग करें। यदि आप किसी मौजूदा कंपोजर 1.x सह-पायलट का उपयोग करना चाहते हैं, तो उसे कौशल के रूप में उपयोग करने से पहले कंपोजर 2.x पर माइग्रेट करें।

किसी कौशल को कॉन्फ़िगर करने के लिए, आपके कौशल के लिए संबद्ध ऐप पंजीकरण इन Microsoft Entra आईडी को मल्टी-टेनेंट कॉन्फ़िगरेशन पर सेट किया जाना चाहिए।

प्रवाह क्रियाएँ और कौशल क्रियाएँ

निम्नलिखित तालिका यह निर्धारित करने में सहायक होगी कि वार्तालाप के लिए स्किल का उपयोग कब किया जाए.

प्रवाह क्रियाएँ कौशल क्रियाएँ
व्यक्तित्व सह-पायलट लेखक किसी भी सह-पायलट वार्तालाप में एम्बेड करने के लिए पुन: प्रयोज्य प्रवाह बना सकते हैं डेवलपर्स अपने स्वयं के परिवेश में कस्टम स्किल बना सकते हैं, परिनियोजित कर सकते हैं और होस्ट कर सकते हैं
बातचीत सरल, एकल-बारी संक्रियाओं के लिए प्रवाहों का उपयोग करें. उदाहरण के लिए, ऑर्डर दें या ऑर्डर की वस्तु-स्थिति प्राप्त करें. जटिल, बहु-बारी संक्रियाओं के लिए स्किल का उपयोग करें. उदाहरण के लिए, मीटिंग शेड्यूल करें या फ़्लाइट बुक करें.
प्रतिसाद सह-पायलट प्रतिक्रिया भेजने के लिए प्रवाह का उपयोग करें. उदाहरण के लिए, एक वैयक्तिकृत संदेश या इनलाइन तस्वीरें दिखाएँ. किसी भी समर्थित सह-पायलट प्रतिक्रिया को उत्सर्जित करने के लिए कौशल का उपयोग करें। उदाहरण के लिए, एक अनुकूली कार्ड दिखाएँ या यादृच्छिक प्रतिक्रियाएँ भेजें.
क्रियाएं सर्वर-साइड एकल-बारी क्रियाओं को ट्रिगर करने हेतु प्रवाहों का उपयोग करें. उदाहरण के लिए, HTTP API को कॉल करें या कस्टम कनेक्टर को ट्रिगर करें. सर्वर-साइड और क्लाइंट-साइड ईवेंट और क्रियाओं को ट्रिगर करने हेतु स्किल का उपयोग करें. उदाहरण के लिए, सह-पायलट प्रतिक्रिया पर किसी पृष्ठ पर नेविगेट करें।

एक कौशल कॉन्फ़िगर करें

सबसे पहले, एक सह-पायलट बनाएं और अपने संगठन में प्रो-कोड टूल का उपयोग करके एक कौशल बनाएं और तैनात करें। Copilot Studio...

कौशल को पंजीकृत करने से पहले, अपने कौशल डेवलपर को सह-पायलट की आईडी प्रदान करें ताकि सह-पायलट को कौशल में क्रियाएं करने के लिए अधिकृत किया जा सके। कौशल अनुमति सूची के बारे में अधिक जानें. आप अपने सह-पायलट की आईडी कौशल जोड़ें विंडो से प्राप्त कर सकते हैं।

अपने सह-पायलट में कोई कौशल जोड़ने के लिए:

  1. नेविगेशन फलक में, सेटिंग्स का विस्तार करें और कौशल का चयन करें.

  2. कौशल पृष्ठ के शीर्ष पर, कौशल जोड़ें का चयन करें।

  3. अपनी सह-पायलट आईडी की प्रतिलिपि बनाएँ और उसे अपने कौशल डेवलपर को उपलब्ध कराएँ।

    कौशल जोड़ें विंडो के किनारे सह-पायलट आईडी को हाइलाइट करने वाला स्क्रीनशॉट।

  4. स्किल मैनिफ़ेस्ट में URL दर्ज करें. किसी कौशल के मेनिफ़ेस्ट में वह जानकारी होती है जिसकी आपके सह-पायलट को किसी कौशल के अंतर्गत क्रियाएं प्रारंभ करने के लिए आवश्यकता होगी।

  5. सत्यापन प्रक्रिया शुरू करने के लिए अगलाचुनें। सत्यापन सफल होने पर, आपका कौशल आपके सह-पायलट में जोड़ दिया जाता है। अब आप अपने विषयों में इस कौशल का उपयोग कर सकते हैं।

अनुपालन के विचार

उपयोगकर्ता की गोपनीयता की सुरक्षा के लिए, हमें साइन-इन किए गए उपयोगकर्ता के Microsoft Entra आईडी टेनेंट में कौशल को ऐप के रूप में पंजीकृत करने की आवश्यकता होती है।

कौशल पंजीकरण के दौरान त्रुटियों का निवारण करें

URL के निमित्त सत्यापन जांच की एक श्रृंखला बनाई जाती है. ये जांच आपके सह-पायलट में जोड़े जा रहे कौशल के अनुपालन, प्रशासन और उपयोगिता को सुनिश्चित करती हैं। आपको स्किल पंजीकृत करने के पूर्व इन त्रुटियों को ठीक करने की आवश्यकता होगी.

त्रुटि संदेश त्रुटि निवारण / शमन
हमें कौशल मैनिफ़ेस्ट प्राप्त करने में समस्याएँ आईं.
(MANIFEST_FETCH_FAILED)		 वेब ब्राउज़र में अपना मैनिफ़ेस्ट URL खोलने का प्रयास करें. यदि URL 10 सेकंड के भीतर पृष्ठ को प्रस्तुत करता है, तो अपने स्किल को दोबारा पंजीकृत करें.
मैनिफ़ेस्ट असंगत है.
(MANIFEST_MALFORMED)		 (a) जाँचें कि क्या मैनिफ़ेस्ट एक वैध JSON फ़ाइल है।
(b) जाँचें कि क्या मैनिफ़ेस्ट में आवश्यक गुण हैं
उदाहरण के लिए, (name, msaAppId, एकल endpoint, activities/id, activities/description, activities/type (केवल event या message समर्थित)).
आपके एंडपॉइंट में कोई बेमेल है
(MANIFEST_ENDPOINT_ORIGIN_MISMATCH)		 जांचें कि क्या आपका कौशल एंडपॉइंट आपके आईडी आवेदन पंजीकरण के (पसंदीदा) या फ़ील्ड से मेल खाता है। Microsoft Entra Publisher domainHome page URL एंडपॉइंट्स के लिए होम पेज सेट करने के बारे में अधिक जानें.
कौशल जोड़ने के लिए, पहले उसे पंजीकृत होना चाहिए
(APPID_NOT_IN_TENANT)		 जाँचें कि क्या आपके कौशल की एप्लिकेशन आईडी आपके संगठन के Microsoft Entra आईडी टेनेंट में पंजीकृत है।
लिंक मान्य नहीं है; लिंक https://
(URL_MALFORMED, URL_NOT_HTTPS) से शुरू होना चाहिए		 लिंक को एक सुरक्षित URL के रूप में दोबारा दर्ज करें.
मैनिफ़ेस्ट बहुत बड़ा है;
(MANIFEST_TOO_LARGE)		 मैनिफ़ेस्ट का आकार जांचें. यह 500KB से कम या इसके बराबर होना चाहिए.
यह कौशल आपके सह-पायलट में पहले ही जोड़ दिया गया है।
(MANIFEST_ALREADY_IMPORTED)		 स्किल हटाएँ और फिर से पंजीकरण करने का प्रयास करें.
स्किल 100 क्रियाओं तक ही सीमित है.
(LIMITS_TOO_MANY_ACTIONS)		 स्किल मैनिफ़ेस्ट में बहुत सारे स्किल क्रियाओं को परिभाषित किया गया है. क्रियाएँ निकाल दें और फिर कोशिश करें.
क्रियाएँ 25 इनपुट तक ही सीमित हैं.
(LIMITS_TOO_MANY_INPUTS)		 बहुत अधिक स्किल कार्रवाई इनपुट मापदंड हैं. पैरामीटर निकाल दें और फिर कोशिश करें.
क्रियाएँ 25 आउटपुट तक ही सीमित हैं.
(LIMITS_TOO_MANY_OUTPUTS)		 बहुत अधिक स्किल क्रिया आउटपुट मापदंड हैं. पैरामीटर निकाल दें और फिर कोशिश करें.
आपके सह-पायलट के पास अधिकतम 100 कौशल हो सकते हैं।
(LIMITS_TOO_MANY_SKILLS)		 एक सह-पायलट में बहुत सारे कौशल शामिल होते हैं। किसी मौजूदा स्किल को हटाएँ और पुनः प्रयास करें.
ऐसा लगता है कि कुछ ग़लत हुआ है.
(AADERROR_OTHER)		 आपके स्किल का मान्यीकरण करते समय एक क्षणिक त्रुटि हुई थी. दोबारा कोशिश करें.
आपके स्किल को जाँचने के दौरान कुछ गलत हुआ.
(ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED)		 जाँचें कि क्या आपका स्किल समापन-बिंदु ऑनलाइन है और संदेशों का प्रत्युत्तर दे रहा है.
इस कौशल ने आपके सह-पायलट को अनुमति-सूची में शामिल नहीं किया है
(ENDPOINT_HEALTHCHECK_UNAUTHORIZED)		 जांचें कि क्या आपके सह-पायलट को कौशल अनुमति सूची में जोड़ा गया है।