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


Copilot Studio (पूर्वावलोकन) में प्लगइन क्रियाओं का उपयोग करें

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

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

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

आप एक या अधिक प्लगइन क्रियाएँ जोड़कर अपने सह-पायलट की क्षमताओं को बढ़ा सकते हैं। प्लगइन क्रियाओं का उपयोग आपके सह-पायलट द्वारा उपयोगकर्ताओं को स्वचालित रूप से प्रतिक्रिया देने के लिए किया जाता है, जनरेटिव क्रियाओं का उपयोग करके, या आप उन्हें विषय के भीतर से स्पष्ट रूप से कॉल कर सकते हैं।

[यह आलेख रिलीज़-पूर्व दस्तावेज़ है और परिवर्तन के अधीन है.]

कोर प्लगइन क्रिया प्रकार

प्लगइन क्रियाएँ निम्नलिखित मुख्य क्रिया प्रकारों में से एक पर आधारित होती हैं:

  • पूर्वनिर्मित कनेक्टर क्रिया
  • कस्टम कनेक्टर क्रिया
  • Power Automate बादल प्रवाह
  • Bot Framework कौशल

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

आप में बनाए गए संवादात्मक प्लगइन्स को Copilot Studio प्लगइन क्रियाओं के रूप में उपयोग नहीं कर सकते।

प्रत्येक मुख्य क्रिया में अतिरिक्त जानकारी होती है जो उसके उद्देश्य का वर्णन करती है, जिससे सह-पायलट को प्रश्न उत्पन्न करने के लिए जीपीटी का उपयोग करने की अनुमति मिलती है। कार्रवाई करने के लिए आवश्यक इनपुट भरने के लिए ये प्रश्न आवश्यक हैं। इसलिए, आपको सभी आवश्यक इनपुट, जैसे कि किसी प्रवाह पर इनपुट, एकत्र करने के लिए मैन्युअल रूप से प्रश्न नोड्स लिखने की आवश्यकता नहीं है। रनटाइम के दौरान आपके लिए इनपुट प्रबंधित किए जाते हैं।

प्लगइन क्रियाएं, क्रिया के परिणामों का उपयोग करके, उपयोगकर्ता की क्वेरी के लिए प्रासंगिक प्रतिक्रिया उत्पन्न कर सकती हैं। वैकल्पिक रूप से, आप प्लगइन कार्रवाई के लिए स्पष्ट रूप से प्रतिक्रिया लिख ​​सकते हैं।

टिप

प्लगइन कार्रवाई से उत्पन्न प्रश्नों का उपयोग करते समय, अपने उपयोगकर्ताओं को सूचित करें कि कुछ बातचीत एआई द्वारा उत्पन्न होती है।

उदाहरण के लिए, वार्तालाप प्रारंभसिस्टम विषय में एक अतिरिक्त संदेश जोड़ें। यह विषय एक नया वार्तालाप शुरू होने पर आपके उपयोगकर्ताओं को दिखाए जाने वाले संदेश को निर्धारित करता है।

एक प्लगइन क्रिया जोड़ें

  1. अपना सह-पायलट खोलें और नेविगेशन फलक में विषय और प्लगइन्स का चयन करें।

  2. + बनाएं चुनें.

  3. प्लगइन क्रिया (पूर्वावलोकन) का चयन करें.

     Copilot Studio नेविगेशन फलक का स्क्रीनशॉट जिसमें विषय और प्लगइन एक्शन बटन हाइलाइट किया गया है।

  4. एक क्रिया जोड़ें (पूर्वावलोकन) विज़ार्ड में, उस प्लगइन क्रिया को खोजें जिसका आप उपयोग करना चाहते हैं और उसे चुनें।

    दिखाई गई डिफ़ॉल्ट सूची में Power Automate आपके परिवेश में उपलब्ध प्रवाह और कस्टम कनेक्टर हैं. इस सूची में आमतौर पर उपयोग किए जाने वाले प्रीबिल्ट कनेक्टर और Bot Framework कौशल शामिल हैं जो आपके सह-पायलट के साथ पंजीकृत हैं। अधिक जानकारी के लिए, के लिए AI प्लगइन्स बनाएँ Microsoft Copilot (पूर्वावलोकन) देखें।

    प्लगइन एक्शन विज़ार्ड में एक्शन प्रकार फ़िल्टर खुला होने के साथ पहले पृष्ठ का स्क्रीनशॉट।

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

    एआई प्लगइन्स से निर्मित कुछ प्लगइन क्रियाएं, जैसे डायनामिक प्रॉम्प्ट और Dataverse एपीआई पर आधारित, के लिए प्रमाणीकरण की आवश्यकता होती है।

  5. कार्रवाई के लिए कनेक्शन कॉन्फ़िगर करें.

    प्लगइन के आधार पर, आपका कनेक्शन स्वचालित रूप से कॉन्फ़िगर हो जाता है, जैसा कि उदाहरण में दिखाया गया है। वैकल्पिक रूप से, यदि विज़ार्ड में निर्देश दिए गए हैं तो आपको कनेक्शन कॉन्फ़िगर करना होगा। जब आपका कनेक्शन सफलतापूर्वक कॉन्फ़िगर हो जाए, तो अगला चुनें।

    कनेक्शन पृष्ठ पर प्लगइन एक्शन विज़ार्ड के पहले पृष्ठ का स्क्रीनशॉट।

  6. समीक्षा करें और यदि आवश्यक हो तो अपने प्लगइन एक्शन कॉन्फ़िगरेशन में बदलाव करें । अपने सहपायलट में प्लगइन क्रिया जोड़ने के लिए समाप्त चुनें।

    विज़ार्ड के भीतर समीक्षा और समाप्ति पॉपअप का स्क्रीनशॉट।

प्लगइन क्रिया को कॉल करें

यदि आपने जनरेटिव क्रियाएँ सक्षम की हैं, तो आपकी प्लगइन क्रिया प्रासंगिक उपयोगकर्ता क्वेरी के जवाब में स्वचालित रूप से कॉल की जाती है।

वैकल्पिक रूप से, आप विषय के भीतर से स्पष्ट रूप से एक प्लगइन कार्रवाई को कॉल कर सकते हैं।

अपनी प्लगइन क्रिया का परीक्षण करें

परीक्षण चैट का उपयोग करके अपने सह-पायलट से एक प्रासंगिक प्रश्न पूछें। आप नेविगेशन मेनू के नीचे चैट पैन के दृश्य को टॉगल (दिखाना या छिपाना) कर सकते हैं।

आपका सह-पायलट नाम और विवरण के आधार पर आपके प्लगइन क्रिया का चयन करता है और उसे चलाता है। आप समर्पित ट्रेसिंग मोड का उपयोग करके उच्च गुणवत्ता वाले विवरण लिख सकते हैं, यह देखने के लिए कि आपके सह-पायलट ने जनरेटिव एक्शन पेज से कौन से प्लगइन कार्यों का चयन किया है।

वैकल्पिक रूप से, यदि आपने ने विषय में एक प्लगइन क्रिया जोड़ी है, तो आप उस विषय के लिए ट्रिगर वाक्यांशों में से एक के समान एक संदेश दर्ज करके इसका परीक्षण कर सकते हैं।

आप इस स्क्रीनशॉट में मौसम प्लगइन क्रिया का परीक्षण होते हुए देख सकते हैं:

परीक्षण किए जा रहे प्लगइन क्रिया का स्क्रीनशॉट।

जीपीटी-संचालित वार्तालाप पारंपरिक रूप से लिखे गए प्रश्नों की तुलना में अधिक प्रवाहपूर्ण हो सकते हैं। उपयोगकर्ता एक ही बार में एक से अधिक प्रश्नों का उत्तर दे सकते हैं या पहले दर्ज किए गए मानों को ठीक कर सकते हैं।

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

अपने प्लगइन एक्शन कॉन्फ़िगरेशन में परिवर्तन करें

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

क्रिया विवरण

यहां आप अपने एक्शन के बारे में विवरण कॉन्फ़िगर कर सकते हैं, जिसमें आपके प्लगइन एक्शन के लिए मॉडल प्रदर्शन नाम और मॉडल विवरण शामिल हैं। आमतौर पर, आपके द्वारा चुनी गई कार्रवाई के आधार पर नाम और विवरण आपके लिए पहले से तैयार कर दिया जाता है।

इस पृष्ठ पर, आप इस क्रिया को चलाने से पहले उपयोगकर्ता से पूछें चेकबॉक्स का चयन कर सकते हैं, जो उन कार्यों के लिए उपयोगी है जो उपयोगकर्ता के लिए परिवर्तन करते हैं, जैसे रिकॉर्ड डालना या अपडेट करना एक टेबल में.

इनपुट

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

एकत्र किए जा रहे इनपुट के आधार पर, आप इस रूप में पहचानें विकल्प को एक विशिष्ट इकाई प्रकार में बदल सकते हैं, जो सह-पायलट को उपयोगकर्ता की प्रतिक्रिया से सटीक रूप से मूल्य निकालने में मदद कर सकता है।

डिफ़ॉल्ट रूप से, प्रत्येक इनपुट को सर्वोत्तम विकल्प के साथ गतिशील रूप से भरें पर सेट किया जाता है। सह-पायलट उपलब्ध संदर्भ से मान भरने का प्रयास करता है, जैसे कि उपयोगकर्ता के संदेश से मान निकालना। यदि कोई उपयुक्त मान नहीं मिलता है, तो यह उपयोगकर्ता से मान पूछने के लिए एक प्रश्न उत्पन्न करता है। आप उपयोगकर्ता से पूछने के बजाय इनपुट को मान से ओवरराइड कर सकते हैं। ओवरराइड करने के लिए, कोपायलट इस इनपुट को कैसे भरेगा? ड्रॉपडाउन को मान के रूप में सेट करें में बदलें, फिर दर्ज करें एक कीमत। यह मान एक शाब्दिक मान, एक मौजूदा चर या एक सूत्र हो सकता है। Power Fx

प्लगइन एक्शन कॉन्फ़िगरेशन के लिए इनपुट अनुभाग का स्क्रीनशॉट।

आउटपुट

डिफ़ॉल्ट रूप से, आपकी प्लगइन कार्रवाई किसी उपयोगकर्ता के लिए उनकी क्वेरी और कार्रवाई के परिणाम के आधार पर स्वचालित रूप से एक प्रासंगिक प्रतिक्रिया उत्पन्न करने के लिए कॉन्फ़िगर की गई है। उदाहरण के लिए, यदि कोई उपयोगकर्ता पूछता है, "लंदन में वर्तमान तापमान क्या है?", तो GPT का उपयोग करके एक प्रासंगिक उत्तर तैयार किया जाता है, जैसे "लंदन में वर्तमान तापमान 9 डिग्री सेल्सियस है।"

वैकल्पिक रूप से, आप अपनी प्लगइन कार्रवाई को वापस लाने के लिए एक विशिष्ट प्रतिक्रिया लिखना चुन सकते हैं। पुष्टिकरण संपादक की तरह, आप वेरिएबल पिकर का उपयोग करके कार्रवाई से आउटपुट वेरिएबल के संदर्भ सम्मिलित कर सकते हैं, जैसा कि इस उदाहरण में दिखाया गया है।

वेरिएबल पिकर ओपन के साथ आउटपुट रिस्पांस एडिटर का स्क्रीनशॉट।

विषय के भीतर से एक प्लगइन क्रिया को कॉल करें

आप किसी प्लगइन क्रिया को विषय के भीतर से स्पष्ट रूप से कॉल कर सकते हैं, अन्य क्रिया प्रकारों जैसे Power Automate फ़्लो को कॉल करने के समान। आपके उपयोग के मामले के आधार पर, आप अपने फ्लो का उपयोग व्यापक विषय के हिस्से के रूप में कर सकते हैं, जो अधिक नोड्स का उपयोग करता है। या, मौसम के उदाहरण की तरह, विषय में एक एकल प्लगइन एक्शन नोड जोड़ना ही आपकी ज़रूरत हो सकती है।

विषय के भीतर से एक प्लगइन क्रिया को कॉल करने के लिए:

  1. Microsoft Copilot Studioमें, जिस सह-पायलट को आप संपादित करना चाहते हैं, उसके लिए विषय पृष्ठ पर जाएं।

  2. एक नया विषय बनाएं, और उसका नाम मौसम प्राप्त करें रखें.

  3. निम्नलिखित जोड़ें ट्रिगर वाक्यांश:

    • क्या बारिश होगी
    • आज का पूर्वानुमान
    • मौसम प्राप्त करें
    • क्या मौसम है

    नए विषय में ट्रिगर वाक्यांशों का स्क्रीनशॉट।

  4. नोड जोड़ें (+) चुनें और फिर किसी क्रिया को कॉल करें चुनें। प्लगइन क्रियाएँ (पूर्वावलोकन) टैब पर जाएँ और फिर पहले बनाई गई प्लगइन क्रिया का चयन करें, मौसम पूर्वानुमान प्राप्त करें

    नए नोड मेनू का स्क्रीनशॉट खुला और मौसम प्लगइन क्रिया चयनित।

  5. आपका प्लगइन क्रिया (पूर्वावलोकन) नोड अब आपके विषय में जोड़ दिया गया है।

    विषय में नए प्लगइन एक्शन नोड का स्क्रीनशॉट।

  6. सहेजें चुनें.

विषय से प्लगइन क्रिया को कॉल करते समय इनपुट को ओवरराइड करें

डिफ़ॉल्ट रूप से, जब आपकी प्लगइन क्रिया चलती है, तो आपका सह-पायलट उपयोगकर्ता के लिए आवश्यक इनपुट भरने हेतु प्रश्न उत्पन्न करता है। हालाँकि, हो सकता है कि आप एक या अधिक इनपुट को ओवरराइड करना चाहें और उपयोगकर्ता से पूछने के बजाय एक स्पष्ट मूल्य प्रदान करना चाहें। आप प्लगइन क्रिया कॉन्फ़िगरेशन में इनपुट अनुभाग के भीतर ओवरराइड कर सकते हैं। या, आप केवल तभी मानों को ओवरराइड कर सकते हैं जब आपकी प्लगइन क्रिया किसी विशिष्ट विषय से उपयोग की जाती है:

  1. नोड पर सेट वैल्यू चुनें और वह इनपुट चुनें जिसे आप ओवरराइड करना चाहते हैं।

    ओवरराइड किए जाने के लिए उपलब्ध इनपुट की सूची का स्क्रीनशॉट।

  2. एक मान टाइप करके, एक वेरिएबल का चयन करके, या एक सूत्र का उपयोग करके इनपुट के लिए मान दर्ज करें।

    यूनिट इनपुट को ओवरराइड किए जाने का स्क्रीनशॉट।

अब जब यह इनपुट ओवरराइड हो गया है, तो सह-पायलट उपयोगकर्ता से कोई मूल्य नहीं पूछता है।

एआई प्लगइन्स के लिए प्रमाणीकरण सक्षम करें

कुछ प्लगइन क्रियाएं, जब AI प्लगइन्स के आधार पर बनाई जाती हैं, तो उन्हें सही ढंग से काम करने के लिए प्रमाणीकरण की आवश्यकता होती है, जैसे कि डायनेमिक प्रॉम्प्ट या अन्य जो API को कॉल करते हैं। Dataverse

प्लगइन्स हमेशा अंतिम-उपयोगकर्ता संदर्भ में Microsoft Copilot रनटाइम में चलाए जाते हैं और प्रमाणीकरण सक्षम होने तक नहीं चलाए जा सकते। दो प्रकार की प्रमाणीकरण विधियाँ समर्थित हैं:

AI प्रमाणीकरण सक्षम करें

  • एकीकृत प्रमाणीकरण (टीम और Power Apps) यदि आपका सह-पायलट टीम्स चैनल में है तो यह प्रमाणीकरण सेटअप नियोजित किया जा सकता है। यह सेटअप किसी भी एम्बेडेड सह-पायलट के साथ भी काम करता है Power Platform ऐप जो PPAPI मानक के साथ निर्मित टोकन का उपयोग करता है।

  • मैन्युअल प्रमाणीकरण (तृतीय-पक्ष सह-पायलट): इस प्रमाणीकरण विधि में एंट्रा आईडी कनेक्शन का सेटअप शामिल है।

मैन्युअल प्रमाणीकरण कनेक्शन बनाने के लिए:

  1. एक एंट्रा आईडी ऐप सेट करें।

  2. अपने सह-पायलट पर मैन्युअल प्रमाणीकरण सेट अप करें। Copilot Studio

  3. अपने ऐप को उपयोगकर्ता की ओर से टोकन प्राप्त करने के लिए डेलिगेशन का उपयोग करने की अनुमति दें। किसी भी आवश्यक स्कोप को जोड़ना सुनिश्चित करें।

प्रमाणीकरण सेट अप