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

هام

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

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

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

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

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

• مستأجر في مايكروسوفت إنترا بأحد الأدوار التالية:

  • مسؤول العمومي
  • مدير هوية الوكيل
  • مطور معرف الوكيل

• اشتراك Azure مع وصول المساهم أو المالك

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

• تثبيت Azure CLI ومصادقته (تثبيت Azure CLI)
• A365 CLI تم التثبيت (Agent 365 CLI)

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

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

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

أمر النشر

شغل الأمرa365 publish:

a365 publish

إشعار

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

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

1. تحديث قائمة البيانات - التحديثات manifest.json ومعرف agenticUserTemplateManifest.json مخطط الوكيل الخاص بك
2. طلب التخصيص - يفتح محررك الافتراضي لتخصيص الإصدار، الأسماء، الوصف، والأيقونات
3. إنشاء حزمة - الحزم manifest.jsonوالرموز وقوالب المستخدم الوكيلي إلى manifest.zip
4. تكوين الأمنات - يضيف صلاحيات API المطلوبة إلى تطبيق العميل المخصص
5. خدمة الرفع إلى العناوين - نشر الحزمة في مركز إدارة Microsoft 365
6. تكوين الوصول إلى الملكية - إعداد الوصول لجميع المستخدمين في المستأجر الخاص بك
7. تكوين مصادقة المخطط - إعداد هوية عبء العمل والمصادقة أثناء التشغيل
8. منح أمنيات الرسم البياني - يطبق أذونات Microsoft Graph على مخطط الوكيل

تخصيص البيان

يتوقف CLI مؤقتا أثناء النشر للسماح لك بتخصيص بيان العامل الخاص بك:

=== MANIFEST UPDATED ===
Location: [path]\manifest\manifest.json

=== CUSTOMIZE YOUR AGENT MANIFEST ===
Please customize these fields before publishing:
  Version ('version')
    - Increment for republishing (e.g., 1.0.0 to 1.0.1)
    - REQUIRED: Must be higher than previously published version
  Agent Name ('name.short' and 'name.full')
    - Make it descriptive and user-friendly
    - Currently: [your-agent-name] Blueprint
    - IMPORTANT: 'name.short' must be 30 characters or less
  Descriptions ('description.short' and 'description.full')
    - Short: 1-2 sentences
    - Full: Detailed capabilities
  Developer Info ('developer.name', 'developer.websiteUrl', 'developer.privacyUrl')
    - Should reflect your organization details
  Icons
    - Replace 'color.png' and 'outline.png' with your custom branding

Open manifest in your default editor now? (Y/n):

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

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

✅ نجاح نشر✅ CLImanifest المجلد الذي تم إنشاؤه باستخدام manifest.json و manifest.zip
✅ يظهر الوكيل في سجل مركز إدارة مايكروسوفت
✅ توجد بيانات هوية اتحادية

إخراج CLI

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

✅ Upload succeeded مع operationId و titleId
✅ Title access configured for all users
✅ Microsoft Graph permissions granted successfully
✅ Agent blueprint configuration completed successfully
✅ Publish completed successfully!

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

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

Error	خطوة للحل
Agent already exists	رقم النسخة الإضافية وإعادة manifest.json نشر.
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. انتقل إلى: https://admin.cloud.microsoft/#/agents/all
2. يظهر وكيلك في تبويب السجل
3. تظهر التوفر ك جميع المستخدمين (علامة تحقق خضراء تشير إلى النجاح)

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

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

الهوية الفيدرالية التي تم إنشاؤها

يمكنك عرض سجل الهوية الفيدرالية (FIC) الذي تم إنشاؤه في Microsoft Entra.

1. اذهب إلى تطبيقات تسجيل وكيلك>
2. التنقل إلى الشهادات والأسرار>الاعتمادات الموحدة
3. ترى شخصيتين من الخيال العلمي

إذا لم تر هذه السجلات، تحقق من صلاحيات تطبيق Blueprint في بوابة Azure.

راجع أيضًا

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

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

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

إنشاء نسخة وكيل

Troubleshooting

مشاكل شائعة عند نشر الوكلاء إلى مركز إدارة مايكروسوفت.

Tip

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

أمر النشر يفشل

الأعراض:

• خطأ أثناء a365 publish
• الوكيل لا يظهر في مركز الإدارة

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

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

الحل:

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

   a365 config display -g
   # Check for: agentBlueprintId
   

2. شغل أمر النشر واتبع التعليمات.

3. عند طلب ذلك، قم بتخصيص البيان:

   • تحديث رقم الإصدار (يجب أن يكون فريدا عند إعادة النشر)
   • تعيين اسم الوكيل (30 حرفا أو أقل)
   • تحديث الوصف
   • تحقق من معلومات المطور

4. اكتب continue أو c للاستمرار بعد التخصيص.