نشر عامل إلى مركز إدارة Microsoft

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

المتطلبات الأساسية

قبل أن تبدأ، تأكد من أن لديك العناصر التالية.

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

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

  • المسؤول العام

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

• A365 CLI تم التثبيت (Agent 365 CLI)

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

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

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

أمر النشر

نفِّذ الأمرa365 publish:

a365 publish

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

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

الرفع إلى مركز الإدارة

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

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

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

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

استخدم القائمة التالية للتحقق من نشر وكيلك بنجاح:

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

إخراج CLI

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

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

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

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

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

ملفات البيان

يمكنك اختبار الملفات التالية في 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

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

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

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

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

راجع أيضًا

• مخطط وكيل التثبيت
• العميل لا يظهر في Teams

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

بعد نشر وكيلك، أنشئ نسخة لتتمكن من تكوينها واستخدامها في المستأجر الخاص بك.

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

المشاكل الشائعة عند نشر وكلاء إلى مركز إدارة Microsoft 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.