مخطط وكيل الإعداد

مهم

يجب أن تكون جزءًا من برنامج الإصدار الأولي Frontier للحصول على وصول مبكر إلى Microsoft Agent 365. يربطك Frontier مباشرةً بأحدث ابتكارات الذكاء الاصطناعي في Microsoft. تخضع الإصدارات الأولية في Frontier لشروط الإصدار الأولي الحالية لاتفاقيات العملاء. نظرًا لأن هذه الميزات لا تزال قيد التطوير، فقد يتغير توفرها وقدراتها بمرور الوقت.

يحدد مخطط الوكيل هوية وكيلك وأذوناتك ومتطلبات البنية التحتية. كل حالة وكيل يتم إنشاؤها من هذا المخطط الوكيل.

يمكنك معرفة المزيد عن هوية العميل 365 هنا: هوية العميل 365

المتطلبات

قبل أن تبدأ، تأكد من أن لديك الإعداد التالي:

1. Agent 365 CLI - راجع تثبيت Agent 365 CLI

2. الأذونات المطلوبة:

   • مستخدم مستأجر صالح بأحد الأدوار التالية:
     • مسؤول عام
     • مسؤول معرف الوكيل
     • مطور معرف الوكيل
   • الوصول إلى اشتراك Azure مع أذونات لإنشاء موارد

3. ملف صالح a365.config.json في مجلد العمل الخاص بك، تم إعداده عبر هذه الخطوة: إعداد إعدادات Agent 365

إنشاء مخطط وكيل

ينشئ a365 setup الأمر موارد Azure ويسجل مخطط الوكيل الخاص بك. يحدد المخطط هوية العامل والأذونات ومتطلبات البنية الأساسية. تؤسس هذه الخطوة الأساس لنشر عاملك وتشغيله في Azure.

إعداد التشغيل

تنفيذ أمر الإعداد:

a365 setup -h

سيظهر لك ذلك خيارات مختلفة يمكنك من خلالها إكمال الإعداد بالكامل في أمر واحد ( a365 setup all) أو اختيار خيارات أكثر تفصيلا.

تقوم عملية الإعداد بأكملها بتنفيذ هذه العمليات:

1. إنشاء بنية أساسية لـ Azure (إذا لم تكن موجودة بالفعل):

   • مجموعة الموارد
   • خطة خدمة التطبيقات مع SKU محدد
   • Azure Web App مع تمكين الهوية المُدارة

2. يسجل مخطط العامل:

   • إنشاء مخطط العامل في مستأجر Microsoft Entra
   • إنشاء تسجيلات تطبيق Microsoft Entra
   • تكوين هوية العامل بالأذونات المطلوبة

3. تكوين أذونات API:

   • إعداد نطاقات Microsoft Graph API
   • تكوين أذونات Messaging Bot API
   • تطبيق الأذونات القابلة للتوريث لمثيلات العامل

4. تحديث ملفات التكوين:

   • يحفظ المعرفات والنقاط النهائية المولدة لملف جديد في دليل العمل الخاص بك يسمى a365.generated.config.json
   • سجلات الهوية المُدارة ومعلومات الموارد

إشعار

أثناء الإعداد، سيتم فتح نوافذ المستعرض للحصول على موافقة المسؤول. أكمل تدفقات الموافقة هذه للمتابعة. يستغرق الإعداد عادةً من 3 إلى 5 دقائق ويحفظ التكوين تلقائيًا في a365.generated.config.json.

التحقق من الإعداد

بعد اكتمال الإعداد بنجاح، يجب أن تشاهد ملخصًا يوضح جميع الخطوات المكتملة. تحقق من الموارد التي تم إنشاؤها:

1. عرض التكوين الذي تم إنشاؤه:

   a365 config display -g
   

   تأكد من وجود هذه القيم:

   • agentBlueprintId - مُعرف تطبيق مخطط العامل
   • agentBlueprintObjectId - هُوِيَّة Microsoft Entra لِلخُطَّة
   • managedIdentityPrincipalId - معرف الهوية المُدارة المعين من قبل النظام

2. مراجعة موارد Azure في مدخل Azure:

   تحقق من إنشاء الموارد التالية:

   • مجموعة الموارد:

     • انتقل إلى مجموعات الموارد→ حدد مجموعة الموارد الخَاصة بك.
     • تحقق من احتوائه على خطة App Service وتطبيق الويب

   • خطة خدمة تطبيق:

     • انتقل إلى خدمات التطبيق>خطط خدمة التطبيق
     • ابحث عن خطتك وتحقق من تطابق مستوى التسعير مع تكوين SKU

   • تطبيق الويب:

     • انتقل إلى خدمات التطبيق>تطبيقات الويب
     • ابحث عن تطبيق الويب الخاص بك، ثم انتقل إلى الإعدادات>الهوية>النظام المُعين
     • التحقق من أن الحالة قيد التشغيل
     • لاحظ تطابق معرف الكائن (الأساسي) managedIdentityPrincipalId

3. تحقق من تطبيقات Microsoft Entra في مدخل Microsoft Azure:

   انتقل إلى Azure Active Directory>تسجيلات التطبيق>جميع التطبيقات:

   • ابحث عن مخطط العامل الخاص بك بواسطة agentBlueprintId
   • افتح التطبيق وحدد أذونات API
   • تحقق من منح الأذونات باستخدام علامات الاختيار الخضراء:
     • Microsoft Graph (التفويض وأذونات التطبيق)
     • أذونات Messaging Bot API
   • يجب أن تظهر جميع الأذونات "تم منحها لـ [المستأجر الخاص بك]"

الخطوات التالية

• نشر كود الوكيل الخاص بك على السحابة:

  • أسمانجوني
  • خدمات أمازون ويب (AWS)
  • منصة جوجل السحابية (GCP)

• وكيل النشر إلى مركز إدارة مايكروسوفت