تكوين استوديو كوبيلاوت

الملخص

كوبيلاوت يتصل ببيئات استوديو كوبيلاوت عبر الوصول إلى API، مما يوفر لمديري النظام رؤية للوكلاء الذين تم إنشاؤهم في استوديو كوبيلاوت داخل المنظمة ونشاطهم.

المتطلبات السابقة

قبل أن تبدأ، تحقق من ما يلي:

• لديك حساب في Microsoft Entra ID (Azure AD) مع دور مشرف التطبيقات، مشرف التطبيقات السحابية، أو مشرف عام. هذا الدور يتيح لك منح موافقة عامة لتطبيق كاتو في الخطوة 1. تطبيق كاتو يطلب فقط إذن دخول بسيط، لذا يعد مشرف التطبيقات أو مشرف التطبيقات السحابية الخيار الأدنى للامتياز وكافٍ
• لديك وصول Power Platform Administrator أو Global Administrator على مستوى المستأجر. هذه صلاحية منفصلة خاصة بمنصة Power وليس تسجيل تطبيق Entra ID، وهي تتيح لك تسجيل تطبيق كاتو كتطبيق إدارة في الخطوة 2 وتمكين جلسات الوكيل في الخطوة 3
• لديك وصول إلى الاشتراك في Azure المرتبط باستوديو كوبيلاوت، لفتح جلسة Cloud Shell في الخطوة 2
• يمكنك تشغيل أوامر PowerShell في Azure Cloud Shell، لتشغيل برنامج التسجيل في الخطوة 2

إعداد هذا التكامل هو عملية من أربع خطوات، وغالباً ما يتم إكمال الخطوات من قبل أشخاص مختلفين. في الخطوة 1، يضيف مشرف Entra ID تطبيق كاتو إلى المستأجر. في الخطوات 2 و3، يقوم مشرف منصة Power بتسجيل تطبيق كاتو كتطبيق إدارة ويمكّن جلسات الوكيل. في الخطوة 4، يكمل مشرف كاتو التكامل في CMA.

الخطوة 1: ربط كاتو بـ Microsoft Entra ID

كاتو يسجل تطبيق متعدد المستأجرين في Microsoft Entra ID. لربط التكامل، يفتح مشرف Entra ID رابط موافقة مشرف شبكات كاتو، والذي يضيف التطبيق إلى مستأجرك كتطبيق مؤسسي ويمنحه الموافقة.

لربط كاتو بـ Microsoft Entra ID:

1. افتح رابط الموافقة الإدارية لشبكات كاتو. سجل الدخول باستخدام حساب المشرف الموضح في المتطلبات عند سؤالك. تعرض Microsoft شاشة موافقة لتطبيق تكامل أمن الذكاء الاصطناعي لشبكات كاتو.
2. انقر على قبول.

الخطوة 2: تسجيل كاتو كتطبيق إدارة في منصة Power

تسجل هذه الخطوة نفس تطبيق كاتو من الخطوة 1 كتطبيق إدارة مع منصة Power. عادةً ما يحتاج التطبيق إلى مستخدم تطبيق Dataverse مضاف في كل بيئة قبل أن يتمكن من قراءة البيانات هناك. تسجيله كتطبيق إدارة يمنحه القدرة على قراءة بيئات منصة Power وDataverse عبر المستأجر بالكامل، مما يتيح ل كاتو قراءة تكوينات الوكيل وجلسات الوكيل دون إعداد لكل بيئة. تسجل التطبيق باستخدام PowerShell في Azure Cloud Shell، ويتطلب برنامج التسجيل معرف مستأجر Microsoft Entra ID الخاص بك.

احصل على معرف المستأجر

للحصول على معرف مستأجر Microsoft Entra ID الخاص بك:

1. في بوابة Azure، انتقل إلى Microsoft Entra ID.
2. في صفحة نظرة عامة، تحت المعلومات الأساسية، انسخ معرف المستأجر. تستخدم هذه القيمة في برنامج التسجيل ولاحقاً لإنهاء التكامل في كاتو.

تشغيل برنامج التسجيل

لتسجيل تطبيق الإدارة:

1. في بوابة Azure، افتح Cloud Shell.
2. اختر PowerShell.
3. حدد الاشتراك المرتبط باستوديو كوبيلاوت وانقر على تطبيق.
4. قم بتشغيل الأوامر التالية، واستبدل <YOUR-TENANT-ID> بمعرف المستأجر الذي نسخته سابقًا:

$tenantId = "<YOUR-TENANT-ID>"

az login --scope "https://api.bap.microsoft.com/.default"
# أكمل عملية تسجيل الدخول باتباع الرابط وإدخال الرمز، واختر الاشتراك المناسب

$token = az account get-access-token `
  --scope "https://api.bap.microsoft.com/.default" `
  --tenant $tenantId `
  --query accessToken -o tsv

$headers = @{
    "Authorization" = "Bearer $token"
    "Content-Type"  = "application/json"
}

$body = "{}"

$uri =
      "https://api.bap.microsoft.com/providers/" +
      "Microsoft.BusinessAppPlatform/adminApplications/" +
      "0f5bb78b-ad8f-454a-a7bc-3c6bb5b1e6c8?api-version=2020-10-01"

Invoke-RestMethod -Method Put -Uri $uri -Headers $headers -Body $body

يُعيد أمر Invoke-RestMethod قيمة applicationId المسجلة، مما يؤكد أن تطبيق الإدارة تم تسجيله بنجاح:

applicationId
-------------
0f5bb78b-ad8f-454a-a7bc-3c6bb5b1e6c8

الخطوة 3: تمكين جلسات الوكيل

تمكين هذا الإعداد يسمح ل كاتو بعرض جلسات الوكيل لوكلاء استوديو كوبيلاوت في البيئة. قم بتمكينه لكل بيئة ذات صلة في المستأجر. لا يمكن أن تكون البيئة بيئة تطوير. تمكين هذا الإعداد يتطلب الوصول إلى Power Platform Administrator، أو دور الأمان System Administrator في تلك البيئة.

لتمكين جلسات الوكيل لبيئة:

1. في مركز إدارة منصة Power، اذهب إلى إدارة > البيئات واختر البيئة.
2. اختر الإعدادات.
3. وسّع المنتج واختر الميزات.
4. تحت وكلاء استوديو كوبيلاوت، فعّل السماح بحفظ نصوص المحادثة و البيانات الوصفية المرتبطة به في Dataverse (مطلوب للتقارير المحسنة).

الخطوة 4: إنهاء التكامل في CMA

لإنهاء التكامل، يدخل مشرف كاتو معرف مستأجر Microsoft Entra ID الذي نسخته سابقًا.

لإنهاء التكامل في CMA:

1. من قائمة التنقل، اختر أمن الذكاء الاصطناعي > التكاملات.
2. على لوحة استوديو كوبيلاوت، انقر فوق اتصال.
3. في حقل معرف مستأجر Azure AD، أدخل معرف المستأجر الذي نسخته.
4. انقر على اختبار الاتصال. يمكنك حفظ التكامل فقط بعد نجاح الاختبار.
5. انقر على حفظ.

تحديث البيانات

بعد أن تربط التكامل، يجلب كاتو البيانات من استوديو كوبيلاوت على الفور، ثم مرة أخرى كل ساعة. توقع تحديث البيانات في CMA حتى ساعة واحدة بعد التغيير في بيئتك.

مراجعة الأذونات المطلوبة