Power Platform API के साथ गैर-अनुपालन एजेंटों को क्वारंटाइन करें

Microsoft Copilot Studio प्रशासकों को बॉट एजेंट सिक्योरिटी और कम्प्लायंस को मैनेज करने के लिए मज़बूत टूल्स देता है, जिसमें Power Platform API के ज़रिए एजेंट्स के लिए क्वारंटाइन एक्शन भी शामिल हैं।

एजेंटों को क्वारंटाइन करना Copilot Studio के व्यापक सुरक्षा ढांचे का हिस्सा है, और Copilot Studio में आपके समग्र सुरक्षा दृष्टिकोण के साथ मिलकर काम करता है।

उदाहरण के लिए, डेटा नीतियों का उल्लंघन करने वाले या अनुपालन दस्तावेज़ों की कमी वाले एजेंट को ऑडिट, रनटाइम सुरक्षा या अन्य व्यवस्थापक रिपोर्ट या सूचनाओं के भाग के रूप में फ़्लैग किया जा सकता है. इसके बाद एडमिन, सिक्योरिटी और कम्प्लायंस से जुड़ी समस्याओं की जांच और उन्हें ठीक करते हुए, नॉन-कम्प्लायंस एजेंट्स को अलग करने के लिए क्वारंटाइन APIs का इस्तेमाल कर सकते हैं।

एजेंट उपयोगकर्ता और निर्माता Copilot Studio में अब भी क्वारंटाइन किए हुए एजेंट दिखाई दे सकते हैं. टेस्टिंग के दौरान मेकर्स, एजेंट्स के साथ बातचीत कर सकते हैं, लेकिन वे किसी अन्य चैनल में क्वारंटाइन किए हुए एजेंट्स के साथ इंटरैक्ट नहीं कर सकते.

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

powervirtualgents नेमस्पेस अब इस्तेमाल में नहीं है। अपनी API कॉल में copilotstudio नेमस्पेस का इस्तेमाल करें।

आवश्यकताएँ

  • आपके पास लक्ष्य एजेंट के लिए बॉट ID और पर्यावरण ID है.
  • आपको Microsoft Entra ID OAuth2 द्वारा जारी किया गया यूज़र एक्सेस टोकन प्राप्त करना होगा। टोकन पाने के लिए, प्रमाणीकरण देखें।
    • टोकन से जुड़े यूज़र के पास इनमें से कोई एक एडमिन रोल होना चाहिए:
      • ग्लोबल टेनेंट एडमिनिस्ट्रेटर
      • AI एडमिनिस्ट्रेटर
      • Power Platform प्रशासक
    • आपको एक्सेस टोकन प्राप्त करना होगा, जिसमें उस ऐप रजिस्ट्रेशन का क्लाइंट आईडी उपयोग किया गया हो, जिसे CopilotStudio.AdminActions.Invoke स्कोप Power Platform API के तहत प्रदान किया गया हो।

एजेंट क्वारंटाइन प्रबंधन के लिए API संचालन

Copilot Studio Power Platform API के हिस्से के रूप में एजेंट क्वारंटाइन के प्रबंधन के लिए तीन प्रमुख REST API संचालन का समर्थन करता है।

नोट

SetAsQuarantined और SetAsUnquarantined एपीआईज़ क्लासिक चैटबॉट का समर्थन नहीं करते हैं। एपीआई तब वापस आ जाता 405 Method Not Allowed है जब आप किसी क्लासिक चैटबॉट को क्वारंटाइन या अनक्वारंटाइन करने का प्रयास करते हैं।

Power Platform API का उपयोग कैसे और कब करें, इस बारे में अधिक जानकारी के लिए, देखें:

एजेंट क्वारंटाइन स्थिति प्राप्त करें

  • एंडपॉइंट: GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine?api-version=1
  • उद्देश्य: एक एजेंट की वर्तमान क्वारंटाइन स्थिति को पुनः प्राप्त करें
  • प्रत्युत्तर: एक बूलियन isBotQuarantined और lastUpdateTimeUtc लौटाता है

अधिक जानकारी के लिए बॉट क्वारंटाइन API संदर्भ दस्तावेज़ प्राप्त गर्नुहोस्।

एजेंट को क्वारंटाइन के रूप में सेट करें

  • एंडपॉइंट: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1
  • उद्देश्य: एक एजेंट को क्वारंटाइन के रूप में चिह्नित करें, इसकी उपलब्धता और बातचीत को प्रतिबंधित करें
  • प्रत्युत्तर: क्वारंटाइन स्थिति अद्यतन की पुष्टि करता है

अधिक जानकारी के लिए Set बॉट As Quarantined API संदर्भ दस्तावेज़ देखें।

एजेंट को क्वारंटाइन के रूप में सेट न करें

  • एंडपॉइंट: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1
  • उद्देश्य: जोखिम मूल्यांकन और उपचार के बाद एक एजेंट को क्वारंटाइन से हटा दें
  • प्रत्युत्तर: क्वारंटाइन स्थिति अद्यतन की पुष्टि करता है

अधिक जानकारी के लिए Set बॉट As Unquarantined API संदर्भ दस्तावेज़ देखें।

  • पिछली बार को अपडेट किया गया