कस्टम सह-पायलट के साथ क्रियाओं का उपयोग करें (पूर्वावलोकन)
आप एक या अधिक क्रियाएं जोड़कर अपने सह-पायलट की क्षमताओं का विस्तार कर सकते हैं। क्रियाओं का उपयोग आपके सह-पायलट द्वारा उपयोगकर्ताओं को स्वचालित रूप से प्रतिक्रिया देने के लिए किया जाता है, जनरेटिव क्रियाओं का उपयोग करके, या आप उन्हें विषय के भीतर से स्पष्ट रूप से कॉल कर सकते हैं।
[यह आलेख रिलीज़-पूर्व दस्तावेज़ है और परिवर्तन के अधीन है.]
मुख्य क्रिया प्रकार
यदि आप जेनरेटिव मोड चालू करते हैं, तो आपका सह-पायलट रनटाइम पर उपयोगकर्ता को प्रतिक्रिया देने के लिए स्वचालित रूप से सबसे उपयुक्त कार्रवाई या विषय का चयन कर सकता है।
क्लासिक मोड में, सह-पायलट केवल उपयोगकर्ता को जवाब देने के लिए विषयों का उपयोग कर सकता है। हालाँकि, आप अभी भी अपने सह-पायलट को विषयों के भीतर से स्पष्ट रूप से क्रियाएँ बुलाने के लिए डिज़ाइन कर सकते हैं।
क्रियाएँ निम्नलिखित मुख्य क्रिया प्रकारों में से एक पर आधारित हैं:
- पूर्वनिर्मित कनेक्टर क्रिया
- कस्टम कनेक्टर क्रिया
- Power Automate क्लाउड फ़्लो
- AI Builder संकेतों
- Bot Framework स्किल
महत्त्वपूर्ण
आप में बनाई गई वार्तालाप क्रियाओं को Copilot Studio कस्टम सह-पायलट वाली क्रियाओं के रूप में उपयोग नहीं कर सकते।
प्रत्येक मुख्य क्रिया में अतिरिक्त जानकारी होती है जो उसके उद्देश्य का वर्णन करती है, जिससे सह-पायलट को प्रश्न उत्पन्न करने के लिए जनरेटिव एआई का उपयोग करने की अनुमति मिलती है। ये प्रश्न कार्रवाई करने के लिए आवश्यक इनपुट भरने के लिए आवश्यक हैं। इसलिए, आपको सभी आवश्यक इनपुट, जैसे कि किसी प्रवाह पर इनपुट, एकत्र करने के लिए मैन्युअल रूप से प्रश्न नोड्स लिखने की आवश्यकता नहीं है। रनटाइम के दौरान आपके लिए इनपुट प्रबंधित किए जाते हैं।
क्रियाएँ, क्रिया के परिणामों का उपयोग करके, उपयोगकर्ता की क्वेरी के लिए एक प्रासंगिक प्रत्युत्तर उत्पन्न कर सकती हैं। वैकल्पिक रूप से, आप कार्रवाई के लिए स्पष्ट रूप से प्रत्युत्तर लिख सकते हैं।
टिप
किसी कार्रवाई से उत्पन्न प्रश्नों का उपयोग करते समय, अपने उपयोगकर्ताओं को सूचित करें कि कुछ वार्तालाप AI द्वारा उत्पन्न किया गया है।
उदाहरण के लिए, वार्तालाप प्रारंभसिस्टम विषय में एक अतिरिक्त संदेश जोड़ें। यह विषय यह निर्धारित करता है कि नया वार्तालाप शुरू होने पर आपके उपयोगकर्ताओं को कौन सा संदेश दिखाया जाएगा.
कोई क्रिया जोड़ें
बाएँ हाथ के नेविगेशन फलक में सह-पायलट चुनकर और सूची से अपने सह-पायलट का चयन करके अपना कस्टम सह-पायलट खोलें।
सह-पायलट के लिए क्रियाएँ देखने के लिए क्रियाएँ चुनें.
+ एक क्रिया जोड़ें चुनें.
एक क्रिया चुनें (पूर्वावलोकन) विज़ार्ड में, वह क्रिया खोजें जिसे आप उपयोग करना चाहते हैं और उसे चुनें।
दिखाई गई डिफ़ॉल्ट सूची में Power Automate आपके परिवेश में उपलब्ध प्रवाह और कस्टम कनेक्टर हैं. इस सूची में सामान्यतः प्रयुक्त प्रीबिल्ट कनेक्टर और Bot Framework कौशल शामिल हैं जो आपके सह-पायलट के साथ पंजीकृत हैं।
महत्त्वपूर्ण
AI प्लगइन्स से बनाई गई कुछ क्रियाएँ, जैसे कि डायनेमिक प्रॉम्प्ट्स और Dataverse APIs पर आधारित, के लिए प्रमाणीकरण की आवश्यकता होती है.
कार्रवाई के आधार पर, आपका कनेक्शन स्वचालित रूप से कॉन्फ़िगर हो जाता है, जैसा कि उदाहरण में दिखाया गया है। वैकल्पिक रूप से, यदि विज़ार्ड में निर्देश दिए गए हैं तो आपको कनेक्शन को कॉन्फ़िगर करना होगा। जब आपका कनेक्शन सफलतापूर्वक कॉन्फ़िगर हो जाए, तो अगला चुनें।
समीक्षा करें और यदि आवश्यक हो तो अपने प्लगइन क्रिया कॉन्फ़िगरेशन में परिवर्तन करें। अपने सह-पायलट में कार्रवाई जोड़ने के लिए समाप्त करें का चयन करें।
अगला चुनें.
एक कार्रवाई को कॉल करें
यदि आपने जनरेटिव क्रियाएँ सक्षम की हैं, तो आपकी क्रिया प्रत्युत्तर में प्रासंगिक उपयोगकर्ता क्वेरी के लिए स्वचालित रूप से कॉल की जाती है।
वैकल्पिक रूप से, आप विषय के भीतर से स्पष्ट रूप से एक क्रिया को कॉल कर सकते हैं।
अपनी क्रिया का परीक्षण करें
किसी कार्रवाई का आह्वान करना
आपका सह-पायलट नाम और विवरण के आधार पर आपकी कार्रवाई का चयन करता है और उसे चलाता है। आप समर्पित ट्रेसिंग मोड का उपयोग करके उच्च गुणवत्ता वाले विवरण लिख सकते हैं, यह देखने के लिए कि आपके सह-पायलट ने जनरेटिव क्रियाएँ पृष्ठ से कौन सी क्रियाएँ चुनी हैं।
वैकल्पिक रूप से, यदि आपने किसी विषय में जोड़ा है, तो आप उस विषय के लिए ट्रिगर वाक्यांशों में से किसी एक के समान संदेश दर्ज करके इसका परीक्षण कर सकते हैं।
आप इस स्क्रीनशॉट में मौसम की क्रिया का परीक्षण होते हुए देख सकते हैं:
वैकल्पिक रूप से, यदि आपने विषय में कोई क्रिया जोड़ी है, तो आप अपने विषय को उपयुक्त ट्रिगर फ़्रेज़ के साथ ट्रिगर करके परीक्षण कर सकते हैं।
किसी कार्रवाई के लिए इनपुट और आउटपुट कॉन्फ़िगर करना
अपनी क्रिया कॉन्फ़िगरेशन में परिवर्तन करें
अपनी कार्रवाई को कॉन्फ़िगर करने के कई तरीके हैं। एक्शन विज़ार्ड के अंतिम चरण पर, जिसे समीक्षा और समाप्त कहा जाता है, आप उपयुक्त अनुभाग के आगे संपादित करें पर क्लिक करके अपनी कार्रवाई के कॉन्फ़िगरेशन में परिवर्तन कर सकते हैं।
क्रिया विवरण
यहां आप अपनी कार्रवाई के बारे में विवरण कॉन्फ़िगर कर सकते हैं, जिसमें आपकी कार्रवाई के लिए मॉडल प्रदर्शन नाम और मॉडल विवरण शामिल हैं। आमतौर पर, आपके द्वारा चयनित कार्रवाई के आधार पर नाम और विवरण आपके लिए पहले से ही भर दिए जाते हैं।
प्रत्येक इनपुट के लिए प्रदर्शन नाम और विवरण गुण सह-पायलट को इनपुट के उद्देश्य को समझने, उपयोगकर्ता के लिए उपयुक्त प्रश्न उत्पन्न करने और उपयोगकर्ता के प्रत्युत्तर में सही मान को पहचानने में सहायता करते हैं। उदाहरण के लिए, MSN मौसम कनेक्टर के लिए स्थान इनपुट पैरामीटर का डिफ़ॉल्ट नाम और विवरण निम्नलिखित है।
- नाम: स्थान
- विवरण: स्थान क्वेरी खोजें. मान्य इनपुट हैं शहर, क्षेत्र, राज्य, देश, लैंडमार्क, पिन कोड, अक्षांश और देशांतर
उपयोगकर्ता से स्थान पूछते समय, सह-पायलट कुछ इस तरह का प्रश्न पूछता है, आप किस स्थान का मौसम जानना चाहते हैं? आप शहर, क्षेत्र, राज्य, देश, लैंडमार्क या पिन कोड दर्ज कर सकते हैं।
आप एकत्रित किए जा रहे इनपुट के आधार पर इस रूप में पहचानें विकल्प को एक विशिष्ट इकाई प्रकार में बदल सकते हैं, जो सह-पायलट को उपयोगकर्ता के प्रत्युत्तर से सटीक रूप से मान निकालने में मदद कर सकता है।
डिफ़ॉल्ट रूप से, प्रत्येक इनपुट को सर्वोत्तम विकल्प के साथ गतिशील रूप से भरने के लिए सेट किया जाता है। सह-पायलट उपलब्ध संदर्भ से मान भरने का प्रयास करता है, जैसे कि उपयोगकर्ता के संदेश से मान निकालना। यदि कोई उपयुक्त मान नहीं मिलता है, तो यह उपयोगकर्ता से मान पूछने के लिए एक प्रश्न उत्पन्न करता है। आप उपयोगकर्ता से पूछने के बजाय इनपुट को मान से ओवरराइड कर सकते हैं। ओवरराइड करने के लिए, सह-पायलट इस इनपुट को कैसे भरेगा? ड्रॉपडाउन को मान के रूप में सेट करें में बदलें, फिर मान दर्ज करें। यह मान एक शाब्दिक मान, एक मौजूदा चर या एक सूत्र हो सकता है। Power Fx
मूल्य पूछते समय या उपयोगकर्ता के उत्तर को मान्य करते समय अपने सह-पायलट के व्यवहार को नियंत्रित करने के लिए, आप इनपुट के लिए अतिरिक्त सेटिंग्स कॉन्फ़िगर कर सकते हैं।
आउटपुट
डिफ़ॉल्ट रूप से, आपकी क्रिया उपयोगकर्ता के लिए उनकी क्वेरी और क्रिया के परिणाम के आधार पर स्वचालित रूप से एक प्रासंगिक प्रत्युत्तर उत्पन्न करने के लिए कॉन्फ़िगर की गई है। उदाहरण के लिए, यदि कोई उपयोगकर्ता पूछता है, "लंदन में वर्तमान तापमान क्या है?", तो GPT का उपयोग करके एक प्रासंगिक उत्तर तैयार किया जाता है, जैसे "लंदन में वर्तमान तापमान 9 डिग्री सेल्सियस है।"
वैकल्पिक रूप से, आप अपनी कार्रवाई को वापस करने के लिए एक विशिष्ट प्रत्युत्तर लिखना चुन सकते हैं। पुष्टि संपादक की तरह, आप चर चयनकर्ता का उपयोग करके क्रिया से आउटपुट चरों के संदर्भ सम्मिलित कर सकते हैं, जैसा कि इस उदाहरण में दिखाया गया है।
विषय के भीतर से कार्रवाई को कॉल करें
आप विषय के भीतर से स्पष्ट रूप से एक क्रिया को कॉल कर सकते हैं, जैसे कि Power Automate Flows जैसे अन्य क्रिया प्रकारों को कॉल करना। आपके उपयोग के मामले के आधार पर, आप अपने प्रवाह को व्यापक विषय के भाग के रूप में उपयोग कर सकते हैं, जो अधिक नोड्स का उपयोग करता है। या, मौसम के उदाहरण की तरह, विषय में एक एकल क्रिया नोड जोड़ना ही आपकी ज़रूरत हो सकती है।
विषय के भीतर से कोई क्रिया बुलाने के लिए:
Copilot Studioमें, उस सह-पायलट के विषय पृष्ठ पर जाएँ जिसे आप संपादित करना चाहते हैं।
एक नया विषय बनाएं, और उसका नाम मौसम प्राप्त करें रखें.
निम्नलिखित ट्रिगर वाक्यांश जोड़ें:
- क्या बारिश होगी
- आज का पूर्वानुमान
- मौसम की जानकारी लें
- क्या मौसम है
नोड जोड़ें (+) का चयन करें और फिर कार्रवाई कॉल करें का चयन करें. प्लगइन क्रियाएँ (पूर्वावलोकन) टैब पर जाएँ और फिर पहले बनाई गई क्रिया का चयन करें, मौसम पूर्वानुमान प्राप्त करें।
आपका प्लग-इन एक्शन (पूर्वावलोकन) नोड अब आपके विषय में जोड़ दिया गया है।
सहेजें चुनें.
विषय से कोई क्रिया कॉल करते समय इनपुट ओवरराइड करें
डिफ़ॉल्ट रूप से, जब आपकी कार्रवाई चलती है, तो आपका सह-पायलट उपयोगकर्ता के लिए आवश्यक इनपुट भरने हेतु प्रश्न तैयार करता है। हालाँकि, आप एक या अधिक इनपुट को ओवरराइड करना चाह सकते हैं और उपयोगकर्ता से पूछने के बजाय एक स्पष्ट मान प्रदान कर सकते हैं। आप इनपुट्स अनुभाग के अंतर्गत प्लग-इन एक्शन कॉन्फ़िगरेशन को ओवरराइड कर सकते हैं। या, आप मानों को केवल तभी ओवरराइड कर सकते हैं जब आपकी क्रिया किसी विशिष्ट विषय से उपयोग की जाती है:
नोड पर सेट वैल्यू का चयन करें और वह इनपुट चुनें जिसे आप ओवरराइड करना चाहते हैं।
इनपुट के लिए मान टाइप करके, चर चुनकर या सूत्र का उपयोग करके मान दर्ज करें।
अब चूंकि यह इनपुट ओवरराइड हो गया है, इसलिए सह-पायलट उपयोगकर्ता से कोई मान नहीं पूछता।
AI क्रियाओं के लिए प्रमाणीकरण सक्षम करें
कुछ क्रियाएं, जब AI क्रियाओं के आधार पर बनाई जाती हैं, तो उन्हें सही ढंग से काम करने के लिए प्रमाणीकरण की आवश्यकता होती है, जैसे कि डायनेमिक प्रॉम्प्ट या अन्य जो API को कॉल करते हैं। Dataverse
क्रियाएँ हमेशा अंतिम-उपयोगकर्ता संदर्भ में रनटाइम में चलाई जाती हैं और प्रमाणीकरण सक्षम होने तक नहीं चलाई जा सकतीं। Microsoft Copilot दो प्रकार की प्रमाणीकरण विधियाँ समर्थित हैं:
कनेक्टर क्रिया गुण पर जाएँ.
अंतिम उपयोगकर्ता प्रमाणीकरण के अंतर्गत, सह-पायलट लेखक प्रमाणीकरण का चयन करें.
सह-पायलट परीक्षण फलक में या किसी वांछित चैनल में अनुभव को प्रकाशित करें और उसका परीक्षण करें.
अंतिम-उपयोगकर्ता क्रेडेंशियल के साथ प्रवाह क्रियाओं का उपयोग करें
प्रवाह क्रियाएँ हो सकती हैं अंतिम-उपयोगकर्ता क्रेडेंशियल्स का उपयोग करने के लिए कॉन्फ़िगर किया गया. यदि आप समर्थित चैनल में प्रवाह का उपयोग करते हैं, तो इसके लिए आपके सह-पायलट संवाद में किसी विशेष कॉन्फ़िगरेशन की आवश्यकता नहीं होती है, और अंतिम उपयोगकर्ता सक्षम होते हैं अपने कनेक्शन प्रबंधित करें किसी दिए गए अनुभव में किसी दिए गए प्रवाह के लिए।
आपकी लाइब्रेरी में प्लगइन्स के आधार पर कार्यों के लिए प्रमाणीकरण
जब AI प्लगइन्स के आधार पर बनाया जाता है, तो क्रियाओं को सही ढंग से काम करने के लिए प्रमाणीकरण की आवश्यकता होती है। यह आमतौर पर प्रॉम्प्ट या अन्य API पर आधारित क्रियाओं के साथ देखा जाता है जो Dataverse API को कॉल करते हैं। प्लगइन्स पर आधारित क्रियाएं हमेशा अंतिम-उपयोगकर्ता संदर्भ में चलाई जाती हैं और प्रमाणीकरण सक्षम किए बिना नहीं चलाई जा सकतीं। दो प्रकार की प्रमाणीकरण विधियाँ समर्थित हैं:
एकीकृत प्रमाणीकरण (टीम्स और Power Apps): यदि आप अपने सह-पायलट को टीम्स चैनल पर प्रकाशित करना चाहते हैं, तो आप इस प्रमाणीकरण विधि का उपयोग कर सकते हैं। यह विधि किसी भी ऐप में एम्बेड किए गए सह-पायलट के लिए भी काम करती है जो PPAPI मानक के साथ निर्मित टोकन का उपयोग करता है। Power Platform
मैनुअल प्रमाणीकरण (तृतीय-पक्ष सह-पायलट): इस प्रमाणीकरण विधि में एक Microsoft Entra आईडी कनेक्शन की स्थापना शामिल है।
मैन्युअल प्रमाणीकरण कनेक्शन बनाने के लिए:
एक Microsoft Entra आईडी ऐप सेट करें।
अपने सह-पायलट के लिए मैन्युअल प्रमाणीकरण सेट अप करें। Copilot Studio
अपने ऐप को उपयोगकर्ता की ओर से टोकन प्राप्त करने के लिए प्रतिनिधित्व का उपयोग करने की अनुमति दें. किसी भी आवश्यक स्कोप को जोड़ना सुनिश्चित करें।
