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

कस्टम एजेंटों में उपकरण जोड़ें

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

  • Office 365 Outlook कनेक्टर का उपयोग करके ईमेल भेजना
  • वर्तमान मौसम की स्थिति और पूर्वानुमान की जाँच करें
  • Dataverse से डेटा पढ़ें और लिखें
  • टीमों को संदेश पढ़ें और पोस्ट करें

उपकरण जोड़ने के लिए तंत्र

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

जनरेटिव ऑर्केस्ट्रेशन (डिफ़ॉल्ट रूप से सक्रिय) के साथ, आपका एजेंट उपयोगकर्ता को जवाब देने के लिए स्वचालित रूप से सबसे उपयुक्त उपकरण या विषय का चयन कर सकता है, या ज्ञान में खोज कर सकता है। यह ऑर्केस्ट्रेशन मोड एक अधिक गतिशील और बुद्धिमान वार्तालाप अनुभव बनाता है।

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

आपके एजेंट में उपकरण जोड़ने के लिए आपके लिए कई तंत्र उपलब्ध हैं:

  • प्रीबिल्ट कनेक्टर: Microsoft और गैर-Microsoft सेवाओं से हजारों लोकप्रिय API के लिए प्रीसेट कनेक्शन के चयन में से चुनें.
  • कस्टम कनेक्टर: Power Platform कनेक्टर का उपयोग करके कस्टम टूल विकल्पों को सक्षम करने के लिए कस्टम सेवा या सिस्टम से कनेक्शन परिभाषित करें.
  • एजेंट प्रवाह: एजेंट प्रवाह को परिभाषित करें, जिसमें एक या अधिक क्रियाएं शामिल हैं।
  • प्रॉम्प्ट: सिंगल टर्न मॉडल आधारित प्रॉम्प्ट जो आपके द्वारा प्रदान किए गए ज्ञान का संदर्भ दे सकता है।
  • REST API कनेक्शन: REST API से कनेक्शन परिभाषित करें और टूल के रूप में जोड़ने के लिए एक या अधिक API एंडपॉइंट और विधियों का चयन करें.
  • मॉडल संदर्भ प्रोटोकॉल (MCP) उपकरण: उपकरण तक पहुँचने के लिए MCP सर्वर से कनेक्ट करें।
  • कंप्यूटर उपयोग (पूर्वावलोकन) एजेंट: आपके एजेंट को किसी भी सिस्टम के साथ इंटरैक्ट करने देता है जिसमें ग्राफिकल यूजर इंटरफेस है, वेबसाइटों और डेस्कटॉप ऐप के लिए, बटन चुनना, मेनू चुनना और स्क्रीन पर फ़ील्ड में टेक्स्ट दर्ज करना।

जब हम इस लेख और प्रलेखन के इस खंड में उपकरणों के बारे में बात करते हैं, तो हमारा मतलब इस समूह के तंत्रों में से एक है। इन टूल प्रकारों को आपके एजेंट में जोड़ा जा सकता है और समान तरीकों से कॉन्फ़िगर किया जा सकता है।

दो अन्य तंत्र हैं जिनका उपयोग आप अपने एजेंट को उपकरण जैसा व्यवहार जोड़ने के लिए कर सकते हैं:

  • कौशल: संबंधित उपकरणों के एक सेट के लिए कंटेनर.
  • क्लाइंट उपकरण: क्लाइंट को एक ईवेंट गतिविधि भेजें ताकि क्लाइंट एक क्रिया करे और एक प्रतिक्रिया लौटाए।

कौशल और क्लाइंट उपकरणों के बारे में अधिक जानकारी के लिए, संबंधित सामग्री अनुभाग में लिंक्स देखें.

एजेंट स्तर पर एक नया टूल बनाएं और जोड़ें

Copilot Studio भित्र नयाँ उपकरणहरू सिर्जना विकास प्रक्रिया सुव्यवस्थित गर्दछ र तपाईंको एजेन्टसँग उचित एकीकरण सुनिश्चित गर्दछ। एक एजेंट में जोड़े गए उपकरण आपके एजेंट की बातचीत के दौरान स्वचालित ऑर्केस्ट्रेशन के लिए उपलब्ध हैं।

  1. बाएँ हाथ के नेविगेशन फलक में एजेंट चुनकर और सूची से अपने एजेंट का चयन करके अपना एजेंट खोलें।

  2. एजेंट के लिए टूल पेज पर जाएं।

  3. टूल जोड़ें चुनें.

  4. उपकरण जोड़ें फलक में, नया उपकरण का चयन करें.

  5. दिखाई देने वाली सूची से उस टूल के प्रकार का चयन करें जिसे आप जोड़ना चाहते हैं:

    • प्रॉम्प्ट: एआई-समर्थित टेक्स्ट जनरेशन और विश्लेषण उपकरण बनाएं
    • एजेंट प्रवाह: सशर्त तर्क के साथ बहु-चरण प्रक्रियाएं बनाएं
    • कंप्यूटर का उपयोग: लीगेसी सिस्टम के लिए GUI स्वचालन सक्षम करें
    • कस्टम कनेक्टर: मालिकाना एपीआई और सेवाओं से कनेक्ट करें
    • आरईएसटी एपीआई: वेब सेवाओं के साथ प्रत्यक्ष एकीकरण

  6. आपके द्वारा चयनित टूल के प्रकार के लिए विशिष्ट कॉन्फ़िगरेशन चरण निष्पादित करें. उदाहरण के लिए, यदि आप संकेत का चयन करें, तो आपको निम्न चरणों का पालन करना होगा:

    • प्रॉम्प्ट टेम्प्लेट और निर्देशों को परिभाषित करें
    • इनपुट पैरामीटर निर्दिष्ट करें
    • ज्ञान स्रोतों को कॉन्फ़िगर करें
    • प्रतिक्रिया स्वरूप और बाधाएं सेट करें

  7. पूर्वावलोकन पैनल का उपयोग करके अपने टूल कॉन्फ़िगरेशन का परीक्षण करके यह सुनिश्चित करें कि यह अपेक्षा के अनुरूप काम करता है।

  8. नया टूल बनाने के लिए सेव करें चुनें.

  9. अपने एजेंट में टूल जोड़ने के लिए एजेंट में जोड़ें चुनें। आप एजेंट के लिए टूल पेज पर नया टूल देख सकते हैं।

अपने टूल कॉन्फ़िगरेशन को देखें और उसमें बदलाव करें

आप किसी भी समय अपने टूल के कॉन्फ़िगरेशन को देख और संपादित कर सकते हैं: अपने एजेंट के टूल पेज पर जाएं, और टूल की सूची से टूल चुनें।

टूल विवरण पृष्ठ खुलता है, जो आपके टूल का कॉन्फ़िगरेशन दिखाता है। विवरण तीन खंडों में प्रदर्शित होते हैं:

  • विवरण
  • इनपुट
  • समाप्ति (MCP कनेक्टर्स के लिए उपकरण)

विवरण

विवरण अनुभाग आपको अपने टूल के बारे में बुनियादी विवरण कॉन्फ़िगर करने देता है।

यहां, आप देख और अपडेट कर सकते हैं:

  • नाम: उपकरण का नाम. यह नाम आपके एजेंट के लिए उपकरणों की सूची में दिखाई देता है। ऐसा नाम चुनें जो टूल के फ़ंक्शन को स्पष्ट रूप से इंगित करता हो।

  • वर्णन: उपकरण का विवरण। जनरेटिव ऑर्केस्ट्रेशन इस विवरण पर निर्भर करता है ताकि यह निर्धारित किया जा सके कि आपके एजेंट को उपकरण का उपयोग कब करना चाहिए। स्पष्ट, विशिष्ट विवरण लिखें जिसमें उपकरण क्या करता है और इसका उपयोग कब किया जाना चाहिए।

  • अतिरिक्त विवरण:

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

इनपुट

यहां, आप अपने टूल के लिए इनपुट देख और कॉन्फ़िगर कर सकते हैं। इनपुट का उपयोग टूल के लिए आवश्यक इनपुट भरने के लिए उपयोगकर्ता से जानकारी एकत्र करने के लिए किया जाता है। जानकारी एक तालिका के रूप में प्रदर्शित होती है, प्रत्येक इनपुट के लिए एक पंक्ति।

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

  • प्रदर्शन नाम और विवरण: उपयोगकर्ता को इनपुट कैसे दिखाई देता है।
  • इस रूप में पहचानें: उपयोगकर्ता की प्रतिक्रिया की व्याख्या कैसे की जाती है, उदाहरण के लिए पाठ की स्ट्रिंग के रूप में या किसी पूर्वनिर्धारित इकाई के साथ मैप की गई.
  • तर्क पुनः प्रयास करें: यदि एजेंट उपयोगकर्ता के कथन में किसी इकाई की पहचान नहीं करता है, तो वह फिर से प्रश्न पूछ सकता है।
  • इनपुट सत्यापन: निकाय प्रकार के लिए डिफ़ॉल्ट से परे उपयोगकर्ता के इनपुट पर अतिरिक्त सत्यापन व्यवहार कॉन्फ़िगर करें.

आप एजेंट को इसे निकालने देने के बजाय एक स्पष्ट मूल्य के साथ इनपुट को ओवरराइड करना भी चुन सकते हैं। ओवरराइड सेट करने के लिए, भरण को कस्टम मान पर सेट करें और कोई मान दर्ज करें, कोई चर चुनें या Power Fx सूत्र का उपयोग करें. यदि कोई इनपुट ओवरराइड किया जाता है, तो एजेंट उपयोगकर्ता से मूल्य नहीं मांगता है।

समापन

यहां, आप चुन सकते हैं कि टूल चलने पर आप क्या करना चाहते हैं।

आप एजेंट को स्वचालित रूप से उपयोगकर्ता के लिए उनकी क्वेरी और टूल के परिणाम के आधार पर एक प्रासंगिक प्रतिक्रिया उत्पन्न कर सकते हैं।

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

चलने के बाद के अंतर्गत, उपकरण चलने के बाद उपकरण को उपयोगकर्ता को कैसे प्रतिक्रिया देनी चाहिए, इसके लिए कुछ भिन्न विकल्पों में से एक का चयन करें:

  • प्रतिक्रिया न दें (डिफ़ॉल्ट): एजेंट टूल आउटपुट को अपनी प्रतिक्रिया में शामिल करता है
  • जनरेटिव एआई के साथ प्रतिक्रिया लिखें: एआई को टूल आउटपुट का उपयोग करके एक प्रासंगिक प्रतिक्रिया तैयार करने दें
  • विशिष्ट प्रतिसाद भेजें: वैरिएबल इंसर्शन के साथ एक टेम्पलेटेड प्रतिक्रिया लिखें
  • अनुकूली कार्ड भेजें: बटन और कार्रवाइयों के साथ समृद्ध, इंटरैक्टिव प्रतिक्रियाएं बनाएं

आप यह भी कॉन्फ़िगर कर सकते हैं कि एजेंट और अन्य उपकरणों को कौन से आउटपुट चर उपलब्ध कराने हैं।

उपकरण चयन और इनपुट संग्रह

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

उपकरण चयन निर्धारित करने के लिए एजेंट कई कारकों का उपयोग करता है:

  • टूल का नाम और विवरण
  • वर्तमान वार्तालाप संदर्भ
  • उपयोगकर्ता का इरादा उनके संदेश से प्राप्त होता है
  • उपलब्ध इनपुट और आउटपुट
  • बातचीत में पिछला टूल उपयोग

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

टिप

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

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

किसी विषय के भीतर से किसी मौजूदा टूल को कॉल करें

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

किसी विषय के भीतर से किसी टूल को कॉल करने के लिए:

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

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

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

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

  4. Add node (+) का चयन करें और फिर एक उपकरण जोड़ें का चयन करें। उपलब्ध उपकरणों में से उपकरण का चयन करें। विभिन्न प्रकार के टूल दिखाने वाले तीन टैब हैं:

    • बुनियादी उपकरण
    • कनेक्टर
    • उपकरण

    आपका एक्शन नोड अब आपके विषय में जोड़ा गया है।

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

उपकरण (केवल MCP कनेक्टर)

उपकरण के अंतर्गत, आप MCP कनेक्टर के लिए उपलब्ध उपकरणों के नाम और वर्णन देख सकते हैं. उपकरण एक तालिका में प्रदर्शित होते हैं, प्रत्येक उपकरण के लिए एक पंक्ति। प्रत्येक उपकरण के लिए, आप देख सकते हैं:

  • उपकरण का नाम और संस्करण
  • इनपुट और आउटपुट पैरामीटर
  • अनुमानित निष्पादन समय
  • उपयोग के आँकड़े

उपकरणों के लिए प्रमाणीकरण विचार

कुछ उपकरणों को सही ढंग से काम करने के लिए प्रमाणीकरण की आवश्यकता होती है, जैसे डायनामिक प्रॉम्प्ट या अन्य जो Dataverse API को कॉल करते हैं। उचित प्रमाणीकरण कॉन्फ़िगरेशन एक सहज उपयोगकर्ता अनुभव बनाए रखते हुए सुरक्षा सुनिश्चित करता है।

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

  • उपयोगकर्ता प्रमाणीकरण: एजेंट सेवा के साथ प्रमाणित करने के लिए उपयोगकर्ता के क्रेडेंशियल्स का उपयोग करता है। यह विधि सुनिश्चित करती है कि उपयोगकर्ता केवल उस डेटा तक पहुंचें जिसे वे देखने के लिए अधिकृत हैं।
  • Copilot लेखक प्रमाणीकरण: एजेंट सेवा के साथ प्रमाणित करने के लिए अपने लेखक के क्रेडेंशियल्स का उपयोग करता है। इस प्रमाणीकरण मोड का उपयोग साझा संसाधनों के लिए करें या जब उपयोगकर्ताओं को व्यक्तिगत पहुँच की आवश्यकता न हो.

अपने टूल का परीक्षण करें

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

वैकल्पिक रूप से, आप किसी विषय के भीतर से किसी मौजूदा टूल को कॉल कर सकते हैं।

संबंधित सामग्री