إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
يوفر Copilot Studio للمسؤولين أدوات قوية لإدارة أمان وتوافق العوامل، بما في ذلك إجراءات العزل للعوامل من خلال Power Platform API.
يُعد عزل العوامل جزءًا من إطار الأمان الأوسع لـ Copilot Studio، ويعمل جنبًا إلى جنب مع نهج الأمان العام في Copilot Studio.
على سبيل المثال، يمكن وضع علامة على العوامل التي تنتهك سياسات البيانات أو تفتقر إلى وثائق التوافق كجزء من عمليات التدقيق أو حماية وقت التشغيل أو تقارير أو إعلامات المسؤول الأخرى. يمكن للمسؤولين بعد ذلك استخدام واجهات API للعزل لاستبعاد العوامل غير المتوافقة أثناء التحقيق في مشكلات الأمان والتوافق ومعالجتها.
سيظل العاملون الذين تم عزلهم مرئيين لمستخدمي العوامل ومنشئي العاملين في Copilot Studio، ولكن لا يمكنهم التفاعل مع العامل أو استخدامه.
مهم
مساحة الاسم powervirtualgents أصبحت مهملة. استخدم مساحة الأسماء copilotstudio فِي استدعاءات واجهة برمجة التطبيقات.
المتطلبات
- لديك معرف الروبوت ومعرف البيئة للعامل الهدف.
- يجب الحصول على رمز وصول مستخدم صادر عن Microsoft Entra ID OAuth2. للحصول على رمز، راجع المصادقة.
- يجب أن يكون لدى المستخدم المرتبط بالرمز أحد أدوار الإدارة التالية:
- مسؤول مستأجر Global
- مسؤول الذكاء الاصطناعي
- مسؤول Power Platform
- يجب عليك الحصول على الرمز المميز للوصول باستخدام معرف العميل لتسجيل التطبيق الذي يملك النطاق CopilotStudio.AdminActions.Invoke الممنوح بموجب Power Platform API.
- يجب أن يكون لدى المستخدم المرتبط بالرمز أحد أدوار الإدارة التالية:
عمليات API لإدارة عزل العامل
يدعم Copilot Studio ثلاث عمليات أساسية لواجهة لـ REST API لإدارة عزل العامل، كجزء من واجهة API في Power Platform.
إشعار
واجهتا برمجة التطبيقات SetAsQuarantined وSetAsUnquarantined لا تدعمان روبوتات الدردشة الكلاسيكية. ترجع واجهة برمجة الْتطبيقات 405 Method Not Allowed عند محاولة عزل روبوت دردشة كلاسيكي أو إخراجه مِنْ الْعزل.
لمزيد من المعلومات حول كيفية ووقت استخدام واجهة API في Power Platform، راجع:
- Power Platform API وحزم SDK: من UX-first إلى واجهة API أولاً (المدونة) (مدونة مطور Power Platform)
- نظرة عامة على قابلية البرمجة وقابلية التوسع (وثائق Power Platform)
- بدء استخدام واجهة API فِي Power Platform (وثائق Power Platform)
- وثائق مرجعية لعمليات واجهة برمجة تطبيقات Power Platform
الحصول على حالة عزل العامل
-
نقطة نهاية:
GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine?api-version=1 - الغرض: استرداد حالة العزل الحالية لعامل.
-
الاستجابة: إرجاع قيمة منطقية
isBotQuarantinedوlastUpdateTimeUtc
تعرف على الْمزيد فِي الحصول على وثائق مرجعية لواجهة برمجة التطبيقات لحالة عزل الروبوت.
تعيين العاملين كمعزول
-
نقطة نهاية:
POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1 - الغرض: وضع علامة على العامل على أنه معزول، مما يقيد توفره وتفاعلاته.
- رد: تأكيد تحديث حالة العزل.
تعرف على الْمزيد فِي تعيين Bot كوثائق مرجعية لواجهة برمجة الْتطبيقات الْمعزولة.
تعيين الْعاملين كغير معزولين
-
نقطة نهاية:
POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1 - الغرض: إزالة عامل من العزل بعد تقييم المخاطر والمعالجة.
- رد: تأكيد تحديث حالة العزل.
تعرف على الْمزيد فِي وثائق مرجعية لواجهة برمجة الْتطبيقات (API) الْخاصة بتعيين الْبوت كغير معزول.