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


HTTP अनुरोध करें

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

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

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

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

    उन्नत मेनू में HTTP अनुरोध भेजें विकल्प का स्क्रीनशॉट.

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

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

    पूर्ण API URL और विधि ड्रॉपडाउन का स्क्रीनशॉट

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

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

    HTTP नोड के लिए हेडर कुंजी मान जोड़ी सूची का स्क्रीनशॉट।

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

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

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

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

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

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

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

    मुख्य सामग्री विकल्प ड्रॉपडाउन का स्क्रीनशॉट

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

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

      बॉडी सामग्री प्रकार के लिए चयनित JSON सामग्री का स्क्रीनशॉट.

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

      बॉडी सामग्री प्रकार के लिए चयनित RAW सामग्री का स्क्रीनशॉट.

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

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

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

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

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

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

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

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

    स्थिति कोड और त्रुटि प्रतिक्रिया निकाय के लिए निर्दिष्ट चरों के साथ त्रुटि पर जारी रखने के लिए कॉन्फ़िगर किए गए त्रुटि प्रबंधन का स्क्रीनशॉट।

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

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

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