HTTP अनुरोध करें

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

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

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

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

1. नोड जोड़ें आइकन का चयन करें नोड के नीचे जिसके बाद आप बाहरी API को कॉल करना चाहते हैं, उन्नत पर जाएँ, और HTTP अनुरोध भेजें का चयन करें।

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

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

   

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

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

   

   आप जिस API को कॉल कर रहे हैं, उसके लिए प्रमाणीकरण टोकन, सामग्री प्रकार या कोई अन्य आवश्यक हेडर पास करने के लिए आप हेडर सेक्शन का उपयोग कर सकते हैं. उदाहरण के लिए, आप अनुरोध को प्रमाणित करने के लिए एक Authorization: Bearer <your_token> हेडर जोड़ सकते हैं।

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 में परिवर्तित कर दिया जाता है।

     

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

     

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

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

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

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

किसी HTTP अनुरोध नोड के त्रुटि प्रबंधन व्यवहार को कॉन्फ़िगर करने के लिए:

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

2. त्रुटि प्रबंधन के अंतर्गत, इच्छित व्यवहार का चयन करें: त्रुटि उठाएं, या त्रुटि पर जारी रखें.

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

   

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

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

HTTP अनुरोध गुण पैनल में, आप मिलीसेकंड में अनुरोध टाइमआउट गुण भी सेट कर सकते हैं। मूल मान तीस सेकंड है।