HTTP अनुरोध करें

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

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

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

Copilot Studioमें, आप HTTP अनुरोध नोड का उपयोग करके बाहरी REST API को कॉल करके एक सह-पायलट की क्षमताओं का विस्तार कर सकते हैं। यह तब उपयोगी हो सकता है जब आपको किसी बाहरी सिस्टम से डेटा प्राप्त करना हो या उस सिस्टम पर डेटा में परिवर्तन करना हो।

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

• विषय बनाएं और संपादित करें

HTTP अनुरोध नोड का उपयोग करें

1. नोड जोड़ें (+) का चयन करें, उन्नत उप मेनू खोलें, और फिर HTTP अनुरोध भेजें का चयन करें.

   

2. URL बॉक्स में, उस API एंडपॉइंट का URL दर्ज करें जिसे आप कॉल करना चाहते हैं।

3. ड्रॉपडाउन से उचित अनुरोध विधि चुनें। GET, POST, PATCH, PUT और DELETE विधियाँ समर्थित हैं।

   

4. नोड पर शीर्षक और मुख्य भाग के अंतर्गत, संपादित करें बटन पर क्लिक करें। इससे HTTP अनुरोध गुण फलक खुल जाएगा।

5. आप वैकल्पिक रूप से HTTP अनुरोध में एक या अधिक हेडर जोड़ सकते हैं। प्रत्येक हेडर की कुंजी और मान जोड़ने के लिए जोड़ें बटन पर क्लिक करें।

   

6. डिफ़ॉल्ट रूप से, HTTP अनुरोध के मुख्य भाग में कोई सामग्री नहीं भेजी जाती है, लेकिन आप मुख्य भाग पर भेजे जाने वाली सामग्री निर्दिष्ट करते हैं।

7. नोड पर, उपलब्ध विकल्पों में से प्रतिक्रिया डेटा प्रकार चुनें।

   आप एक उदाहरण JSON प्रतिक्रिया प्रदान कर सकते हैं (जिसे आप आमतौर पर उस API के दस्तावेज़ में पा सकते हैं जिसे आप कॉल कर रहे हैं), जो एक दृढ़ता से टाइप किया गया Power FX वैरिएबल उत्पन्न करेगा, जिससे आप Power FX संपादक में इंटेलिसेंस समर्थन के साथ अपने संलेखन कैनवास में कहीं और इसका उपयोग कर सकेंगे। ऐसा करने के लिए, नमूना डेटा से चुनें और फिर नमूना JSON से स्कीमा प्राप्त करें पर क्लिक करें, अपने नमूना प्रतिक्रिया को दिखाए गए संपादक में चिपकाएं और पुष्टि करें चुनें।

   

8. प्रतिक्रिया को इस रूप में सहेजें के तहत चुनें कि आप HTTP अनुरोध प्रतिक्रिया को कहां संग्रहीत करना चाहते हैं, या तो एक नया वेरिएबल बनाना या मौजूदा वैरिएबल का चयन करना।

HTTP अनुरोध बॉडी में सामग्री भेजें

1. नोड पर शीर्षक और मुख्य भाग के अंतर्गत, संपादित करें बटन पर क्लिक करें। इससे HTTP अनुरोध गुण फलक खुल जाएगा।

2. बॉडी के अंतर्गत, उपयुक्त सामग्री प्रकार का चयन करें. डिफ़ॉल्ट रूप से इसे कोई सामग्री नहीं पर सेट किया जाता है, जहां अनुरोध निकाय के भीतर कोई सामग्री मौजूद नहीं होनी चाहिए, जिसका उपयोग आमतौर पर GET अनुरोध के साथ किया जाता है। मुख्य भाग में सामग्री जोड़ने के लिए उपलब्ध विकल्पों में से किसी एक का चयन करें।

   

   • JSON सामग्री: JSON सामग्री आपको अनुरोध निकाय में JSON ऑब्जेक्ट प्रदान करने की अनुमति देती है। इसका प्रयोग प्रायः POST या PUT अनुरोध करते समय किया जाता है। जब यह विकल्प चुना जाता है, तो आपके सामने एक संपादक प्रस्तुत किया जाता है, जहां आप अपनी JSON सामग्री दर्ज कर सकते हैं।

     आप पावर एफएक्स का उपयोग करके अपनी JSON सामग्री भी निर्दिष्ट कर सकते हैं, जिससे आप गतिशील मान और संदर्भ चर शामिल कर सकते हैं। ऐसा करने के लिए, JSON संपादित करें बटन का चयन करें, सूत्र चुनें और फिर एक पावर एफएक्स ऑब्जेक्ट दर्ज करें (कोई भी मौजूदा JSON जो पहले से दर्ज किया गया है, आपके लिए पावर एफएक्स ऑब्जेक्ट में परिवर्तित हो जाएगा), जिसे HTTP अनुरोध किए जाने पर JSON में परिवर्तित कर दिया जाएगा।

     

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

     

त्रुटि प्रबंधन और समय समाप्ति

HTTP अनुरोध नोड में उन स्थितियों से निपटने के लिए कई विकल्प होते हैं जहां HTTP अनुरोध विफल हो सकता है या त्रुटि लौटा सकता है।

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

हालांकि, आप त्रुटि हैंडलिंग को इस प्रकार कॉन्फ़िगर कर सकते हैं कि Error system विषय ट्रिगर न हो, तथा इसके स्थान पर, आपके द्वारा निर्दिष्ट चरों में HTTP स्थिति कोड तथा किसी भी त्रुटि प्रतिक्रिया निकाय को पॉप्युलेट कर दें, जिससे आप आवश्यकतानुसार इन चरों की जांच कर सकें तथा विषय का चलना जारी रहे। यह उन परिदृश्यों में उपयोगी है जहां आप चाहते हैं कि कोई विशेष HTTP अनुरोध विफल होने पर भी सह-पायलट संचालन जारी रखे।

त्रुटि प्रबंधन व्यवहार को कॉन्फ़िगर करने के लिए।

1. नोड पर शीर्षक और मुख्य भाग के अंतर्गत, संपादित करें बटन पर क्लिक करें। इससे HTTP अनुरोध गुण फलक खुल जाएगा।

2. त्रुटि प्रबंधन ड्रॉपडाउन से अपना इच्छित व्यवहार चुनें.

3. यदि आप त्रुटि पर जारी रखें चुनते हैं, तो स्थिति कोड और त्रुटि प्रतिक्रिया निकाय चर कॉन्फ़िगर करें, या तो नए चर बनाएं या पिकर से मौजूदा चर चुनें।

   

इस कोड नमूने में, यदि HTTP अनुरोध विफल हो जाता है, तो सह-पायलट HTTP स्थिति कोड को Topic.StatusCode वेरिएबल में और प्रतिक्रिया निकाय को Topic.ErrorResponse वेरिएबल में संग्रहीत करेगा। इसके बाद सह-पायलट विषय में अपने अगले चरणों पर आगे बढ़ेगा।

त्रुटि प्रतिक्रिया परिवर्तनीय प्रकार होगा कोई. आप इसे रिकॉर्ड में बदलने के लिए पार्स वैल्यू नोड Power Fx का उपयोग कर सकते हैं।

गुण फलक में अनुरोध समय समाप्ति गुण भी शामिल है, जो मिलीसेकंड में मान स्वीकार करता है। डिफ़ॉल्ट मान 30 सेकंड है, लेकिन यदि आवश्यक हो तो आप इस मान को बदल सकते हैं।