انشر العامل في Microsoft Admin Center.

استخدم الأمر a365 publish لتجميع عاملك، ثم رفع الحزمة إلى مركز مسؤولي Microsoft 365. بعد النشر، يمكنك إنشاء مثيلات للعامل داخل مؤسستك وإدارته.

المتطلبات

قبل أن تبدأ، تأكد من أن لديك البنود التالية.

الحسابات والأذونات المطلوبة

• مستأجر Microsoft 365 بأحد الأدوار التالية (مطلوب لخطوة تحميل مركز المسؤولين):

  • مسؤول عام

الأَدَوَات المطلوبة

• A365 CLI مثبت (Agent 365 CLI)

خطوات الإعداد المطلوبة

قبل النشر، أكمل الخطوات التالية:

1. إنشاء مخطط عامل - اتبع خطوة إعداد لإنشاء مخطط عامل.
2. اختبار العامل محليا - تحقق من عمل وكيلك بشكل صحيح مع ملعب العاملين (راجع وكلاء الاختبار محليا)
3. إعداد ملفات التكوين - تأكد من تحديث a365.config.jsona365.generated.config.json

الأمر "نشر"

تشغيل a365 publishأمر :

a365 publish

إشعار

عند تشغيل a365 publish -h تظهر جميع الخيارات التي يدعمها هذا الأمر.

ما يفعله هذا الأمر:

1. تَحْدِيثُ المِلَفّ التَّعْرِيفِيّ -يُحَدِّثُ manifest.json المِلَفّ manifest.json بِمُعَرِّفِ مُخَطَّطِ الوَكِيلِ الخَاصّ بِكَ
2. إنشاء حزمة - الحزم manifest.json والرموز إلى manifest.zip.
3. عرض التعليمات - يعرض تعليمات خطوة بخطوة للرفع عبر مركز مسؤولي Microsoft 365.

إشعار

يعمل أمر a365 publish لصالح كل من العاملين وزملاء الذكاء الاصطناعي. بالنسبة للعوامل التي يتم توفيرها باستخدام --agent-name (من دون ملف تكوين)، تأكد من وجود الملف ‎a365.generated.config.json في دليل العمل قبل تشغيل الأمر ‎a365 publish، إذ يقرأ الأمر معرف المخطط من هذا الملف.

تحميل إلى مركز مسؤول

بعد انتهاء a365 publish، اتبع التعليمات المطبوعة لتحميل عاملك:

1. الانتقال إلى مركز إدارة Microsoft 365.
2. انتقل إلى العاملين>جميع العاملين.
3. حدد تحميل عامل مخصص.
4. ارفع ملف manifest.zip من مجلد manifest في مشروعك.

لمزيد من المعلومات، راجع تحميل العوامل إلى مركز مسؤولي Microsoft 365.

تحقق من نجاح النشر

استخدم قائمة التحقق التالية للتأكد من أن عاملِك قد تم نشره بنجاح:

✅ نجحت عملية النشر بواسطة CLI
✅ manifest مجلد تم إنشاؤه مع manifest.json و manifest.zip
✅ يظهر عامل في مركز إدارة Microsoft

إخراج CLI

ترى هذه الرسائل عند نجاح أمر النشر:

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ تعليمات الرفع خطوة بخطوة مطبوعة

إذا فشل الأمر، راجع رسائل الخطأ وتأكد من أنك أكملت إعداد المخطط.

الأخطاء المحتملة:

‏‏خطأ	خطوة للحل
Agent blueprint ID not found	قم بتشغيل a365 setup لإكمال إعداد المخطط.
Permissions missing	إعداد إعادة التشغيل باستخدام a365 setup permissionsأمر .

اتبع هذه الخطوات عند فشل النشر.

ملفات البيان

يمكنك اختبار الملفات التالية في المجلد manifest باستخدام أمر Test-Path PowerShell.

# Check manifest folder and contents exists
Test-Path <deploymentProjectPath>/manifest/
Test-Path <deploymentProjectPath>/manifest/manifest.json
Test-Path <deploymentProjectPath>/manifest/manifest.zip
# All should return: True

إشعار

إذا لم تظهر هذه الملفات، حاول تشغيل a365 publish الأمر مرة أخرى.

ظهور عامل في مركز الإدارة

إشعار

بعد الرفع، قد يستغرق ظهور عاملك من 5-10دقائق في مركز الإدارة وTeams. هذا التأخير أمر طبيعي.

تأكد من وجود عامل باستخدام هذه الخطوات:

1. انتقل إلى مركز مسؤولي Microsoft 365.
2. انتقل إلى العاملين>جميع العاملين.
3. سيظهر عاملُك في القائمة.

يوضح الجدول التالي التفاصيل التي يمكنك العثور عليها:

الحقل	ما الذي يجب التحقق منه
الاسم	اسم عاملِك (من manifest.json)
إصدار	رقم الإصدار (على سبيل المثال، 1.0.0)
الناشر	اسم مؤسستك
التوفر	متاح لجميع المستخدمين

(راجع أيضاً )

• مخطط إعداد العامل
• لا يظهر عامل في Teams

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

بعد نشر عاملِك، أنشئ مثيلاً له حتى تتمكن من تكوينه واستخدامه في المستأجر الخاص بك.

انشاء مثيل من العامل

استكشاف الأخطاء وإصلاحها

المشكلات الشائعة عند نشر العوامل في مركز مسؤولي Microsoft 365.

تلميح

دليل استكشاف أخطاء Agent 365 يتضمن توصيات عالية المستوى لاستكشاف الأخطاء وحلها، وأفضل الممارسات، وروابط لمحتوى استكشاف الأخطاء لكل جزء من دورة تطوير Agent 365.

فشل نشر أمر

العلامات:

• خطأ أثناء a365 publish
• manifest.zip لم يتم إنشاؤه

السبب الجذري:

• الإعداد لم يكتمل بعد
• أخطاء التحقق من صحة ملف البيان
• ‏‏الأذونات غير كافية

الحل:

1. تحقق من اكتمال عملية الإعداد.

   Get-Content a365.generated.config.json | ConvertFrom-Json | Select-Object agentBlueprintId
   

2. شغّل أمر النشر واتبع الإرشادات الظاهرة.

فشل الرفع في مركز الإدارة

العلامات:

• خطأ عند رفع manifest.zip في مركز إدارة Microsoft 365
• العامل لا يظهر بعد الرفع

السبب الجذري:

• الأذونات غير الكافية في مركز الإدارة
• غير صالح أو قديم manifest.zip

الحل:

1. تأكد من أن لديك دور المدير العام.
2. شغّل a365 publish مرة أخرى لتوليد إصدار جديد من manifest.zip.
3. حاول الرفع مرة أخرى باتباع خطوات الرفع.

لمزيد من المساعدة، راجع تحميل العوامل إلى مركز مسؤولي Microsoft 365.