مشاركة عبر

إنشاء مثيلات وكيل

هام

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

بعد نشر وكيل وجعلك متاحا في مركز إدارة مايكروسوفت، يمكنك إنشاء مثيلات وكيل ومستخدمي وكلاء. تستخدم هذه الحالات والمستخدمون مخطط الوكيل وكود الوكيل الذي أنشأته.

تقسم هذه المقالة العملية إلى ثلاث خطوات رئيسية:

  1. تكوين الوكيل في بوابة مطوري Teams
  2. إنشاء نسخة وكيل
  3. اختبر وكيل النشر الخاص بك

إذا واجهت تحديات، راجع قسم استكشاف المشاكل .

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

1. تكوين الوكيل في بوابة مطوري Teams

بعد النشر، قم بتكوين مخطط الوكيل في بوابة مطوري Teams لربط وكيلك ببنية الرسائل Microsoft 365. بدون هذا التكوين، لن يتلقى وكيلك رسائل من Teams أو البريد الإلكتروني أو خدمات Microsoft 365 الأخرى.

  1. احصل على معرف المخطط الخاص بك

    شغل أمر عرض الإعدادات a365 -g لعرض إعدادك:

    a365 config display -g

    انسخ agentBlueprintId القيمة من المخرج.

  2. الانتقال إلى بوابة المطورين

    افتح متصفحك واذهب إلى صفحة الإعدادات:

    https://dev.teams.microsoft.com/tools/agent-blueprint/<your-blueprint-id>/configuration

    استبدلها <your-blueprint-id> بالقيمة agentBlueprintId التي نسختها.

    إشعار

    إذا لم يكن لديك وصول إلى بوابة المطورين، تواصل مع مسؤول المستأجرين لمنحك حق الوصول أو إكمال هذا التكوين نيابة عنك.

  3. تكوين الوكيل

    في بوابة المطورين:

    1. تعيين نوع الوكيلإلى البوت
    2. اضبط معرف البوت على قيمتك agentBlueprintId
    3. حدد حفظ.

    لقطة شاشة تظهر صفحة تكوين بوابة المطورين مع تعيين نوع الوكيل ليكون مبني على البوت وتم ملء حقل معرف البوت.

تحتاج إلى هذا التكوين قبل أن تتمكن من إنشاء مثيلات وكلاء في Teams.

تعرف أكثر على مخططات هوية الوكلاء وتكوين بوابة المطورين.

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

الآن يمكنك طلب نسخة من مخطط وكيلك من Teams. تعرف أكثر على كيفية اكتشاف وكيل العمل وإنشائه واعتماده.

عندما تطلب نسخة وكيل، يرسل Teams الطلب إلى مسؤول المستأجر الخاص بك للموافقة. يمكن للمسؤولين مراجعة والموافقة على الطلبات من صفحة الوكلاء المطلوبين في مركز إدارة مايكروسوفت .

بعد موافقة المسؤول على طلبك، يقوم Teams بإنشاء نسخة الوكيل الخاصة بك وجعلها متاحة في Teams.

3. اختبر عميلك المنشور

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

بعد النشر، ومع تفعيل إشعارات الوكيل في مجموعة تطوير الاتجاهات الخاصة بالوكيل 365، يتكامل وكيلك مع خدمات Microsoft 365. يعمل مع Teams للدردشات والقنوات والاجتماعات؛ مع البريد الإلكتروني والتقويم للإرسال والاستقبال والجدولة؛ ومع SharePoint وOneDrive للوصول إلى المستندات ومشاركة الملفات. كما يدعم ميزات التعاون مثل الحضور التنظيمي، ومهام المخطط، وتعليقات المستندات.

هام

تماما مثل المستخدمين العاديين، يحتاج مستخدمو الوكلاء أيضا إلى تراخيص Microsoft 365 المناسبة للوصول إلى الخدمات. تتضمن التراخيص الشائعة Microsoft 365 E5 وTeams Enterprise وMicrosoft 365 Copilot.

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

بعد أن تنشر وكيلك، يظهر في مركز إدارة مايكروسوفت للتوظيف. قد يستغرق الأمر بعض الوقت للانتشار.

اذهب إلى مركز إدارة Microsoft 365 - الوكلاء إلى:

  • عرض الوكيل المنشور
  • إدارة إعدادات العامل
  • مراقبة استخدام الوكيل
  • تكوين الأذونات

عامل الاختبار في Teams

بعد نشر ونشر وتكوين مخطط الوكيل الخاص بك، وإنشاء مستخدم وكيل، اختبر مستخدم الوكيل مباشرة في Microsoft Teams:

إشعار

تطلب فرونتير ما يلي: تأكد من تفعيل Microsoft Agent 365 Frontier لمستأجرك ويحتاج المسؤول لمنحك الوصول. يتطلب هذا الوصول لإنشاء مثيلات وكيل والتفاعل مع الوكلاء في Microsoft Teams أثناء وضع Agent 365 في مرحلة المعاينة. تعرف أكثر على فرونتير تواصل مع مدير المستأجر إذا لم يكن لديك صلاحية.

ابدأ الاختبار

  1. ابحث عن مستخدمك الجديد في Teams

    إشعار

    عملية إنشاء مستخدم الوكيل غير متزامنة وقد تستغرق من بضع دقائق إلى ساعات ليصبح مستخدم الوكيل قابلا للبحث بعد إنشاؤها.

  2. ابدأ محادثة جديدة مع نسخة الوكيل التي أنشأتها حديثا.

  3. أرسل رسائل اختبار للتحقق من وظيفة الوكيل.

مثال رسالة اختبار

إذا قمت بتكوين الوكيل بالبريد الإلكتروني، أرسل هذه الرسالة لاختبار وظيفة البريد الإلكتروني. قم بتحديث قيمة بريد المستلم recipient@contoso.com .

Send an email to <recipient@contoso.com> with subject "Hello from Teams" and message "This is a test message from my agent!"

يقوم الوكيل بمعالجة الطلب ويرسل البريد الإلكتروني دون الحاجة إلى تأكيد إضافي.

قائمة التحقق

بعد إنشاء نسخة الوكيل الخاصة بك، تحقق من أنه يعمل بشكل صحيح في Teams.

✅ تم حفظ تكوين بوابة المطورين
✅ يظهر الوكيل في بحث تطبيقات Teams
✅ يمكنك إنشاء وكيل مثيل للفرق
✅ تم إنشاء نسخة الوكيل
✅ يظهر مستخدم الوكيل في التنظيم
✅ الوكيل يستجيب للرسائل
✅ يمكن للوكيل تنفيذ الإجراءات
✅ سجلات التطبيقات لا تظهر أي أخطاء
✅ الملاحظة في مركز الإدارة

إذا لم يكن نموذج الوكيل الخاص بك يعمل كما هو متوقع، راجع قسم استكشاف الأخطاء للاطلاع على حلول مفصلة للمشاكل الشائعة.

تحقق من حفظ إعدادات بوابة المطورين

انتقل إلى: https://dev.teams.microsoft.com/tools/agent-blueprint/<your-blueprint-id>/configuration

✅ نوع الوكيل يظهر: يعتمد على الروبوتات
✅ معرف الروبوت يتطابق مع معرفك agentBlueprintId
✅تظهر رسالة تم الحفظ بنجاح

يظهر وكيل التحقق في Teams

  1. تطبيقات Teams > المفتوحة

  2. ابحث عن اسم وكيلك

    ✅ يظهر وكيل في نتائج البحث
    ✅ يظهر أيقونة وكيلك ووصفه

تحقق من إمكانية إنشاء وكيل مثيل للفرق

اختر وكيلك في تطبيقات Teams

✅زر طلب مثيل/إنشاء مثيلة مفعل
✅ يمكن طلب نسخة بدون أخطاء

تحقق من إنشاء نسخة الوكيل

بعد اختيار نسخة الطلب:

✅ تم إرسال الطلب بنجاح إلى المسؤول

التحقق من ظهور مستخدم الوكيل في المنظمة

في مركز إدارة Microsoft 365:

  1. انتقل إلى: https://admin.cloud.microsoft/#/agents/all
  2. انتقل إلى تبويب طلبات جميع الوكلاء

✅ طلب حالة الوكيل مدرج لدى الولاية كمراجعة معلقة
✅ يمكن للمسؤول الموافقة على استخدام نسخة الوكيل
✅ يمكن للمستخدم بعد ذلك إنشاء نسخة من Teams ومنحها اسما.

وكيل التحقق يستجيب للرسائل

في دردشة Teams مع وكيلك - أرسل رسالة اختبار: Hello!

✅ الوكيل يعرض مؤشر الطباعة
✅ يرد العميل خلال ثوان قليلة
✅ الرد متماسك وذو صلة

يمكن لوكيل التحقق من تنفيذ الإجراءات

إذا تم تكوين الأدوات، اختبر وظائف الأداة. على سبيل المثال، إذا أضفت خادم Mail MCP، أرسل بريدا إلكترونيا اختباريا لنفسك.

يجب على الوكيل:

✅ أكر الطلب
✅ تنفيذ استدعاء الأداة
✅ تأكيد الإكمال الناجح

يجب عليك التأكد من وصول البريد الإلكتروني إلى بريدك الإلكتروني.

التحقق من الوظائف

توفر القائمة التالية نهجا منهجيا للاختبار لوكيلك:

الوظائف الأساسية:

✅ يرد العميل على التحيات البسيطة.
✅ الوكيل يتولى المحادثات متعددة الخطوات.
✅ يقدم الوكيل إجابات ذات صلة.

وظائف الأداة:

يعتمد ذلك على تكوين خادم MCP

✅ يمكنني إرسال رسائل إلكترونية.
✅ يمكنك الوصول إلى التقويم.
✅ يمكنك البحث في المستندات.
✅ يمكنه تنفيذ إجراءات معدلة.

معالجة الأخطاء:

✅ يتعامل مع الطلبات غير الصحيحة برشاقة.
✅ يوفر رسائل خطأ مفيدة.
✅ لا يتعطل عند إدخال غير متوقع.

الأداء:

✅ يرد خلال ثوان قليلة.
✅ لا توجد أخطاء في المهلة.
✅ أوقات استجابة مستمرة.

تحقق من سجلات التطبيقات

لمعرفة ما يفعله وكيلك، تحقق من سجلات التطبيقات باستخدام أمر log tail الخاص ب az webapp .

# Real-time logs from Azure
az webapp log tail --name <your-web-app> --resource-group <your-resource-group>

ما الذي يجب البحث عنه في السجلات:

✅ الطلبات الواردة من Teams
✅ المصادقة الناجحة
✅ استدعاءات الأدوات التي يتم تنفيذها
✅ الردود المرسلة
❌ رسائل خطأ أو استثناءات

تحقق من الملاحظة في مركز الإدارة

بعد أن يبدأ وكيلك في العمل:

  1. انتقل إلى: https://admin.cloud.microsoft/#/agents/all

  2. اختر وكيلك وافتح تبويب النشاط .

    يجب أن ترى:

    ✅ الجلسات تظهر.
    ✅ كل جلسة تظهر المحفزات والأفعال.
    ✅ يتم تسجيل استدعاءات الأدوات مع طوابع زمنية.

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

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

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

  • عينات العميل 365: هل لديك بعض العملاء العينات الممتعة والممتعة؟ شارك كود وكيلك مع مجتمع المصادر المفتوحة هنا!
  • Node.js SDK: مجموعة تطوير العميل 365 في Node.js
  • حزمة تطوير بايثون: حزمة تطوير العامل 365 بلغة بايثون
  • .NET SDK: مجموعة تطوير العميل 365 بتقنية C# (.NET)
  • واجهة CLI لأدوات تطوير Agent 365: واجهة سيارية تساعدك خلال دورة تطوير Agent 365 بأكملها

Troubleshooting

يحتوي هذا القسم على المشاكل الشائعة عند إنشاء واختبار مثيلات الوكلاء.

Tip

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

العميل لا يظهر في Teams

عَرَض: يظهر الوكيل في مركز الإدارة لكنه لا يستطيع العثور عليه في تطبيقات Teams.

السبب الجذري: إعداد بوابة المطورين مفقود.

الحل:

  1. احصل على معرف المخطط الخاص بك:

    a365 config display -g
# Copy the agentBlueprintId value

  2. التكوين في بوابة المطورين:

    1. انتقل إلى: https://dev.teams.microsoft.com/tools/agent-blueprint/<your-blueprint-id>/configuration
    2. تعيين نوع الوكيلإلى البوت
    3. اضبط معرف البوت على agentBlueprintId
    4. حدد حفظ.

  3. انتظر من 5 إلى 10 دقائق حتى التكاثر.

التحقق:

  • افتح تطبيقات Teams > ابحث > عن وكيلك
  • يظهر وكيل ومتاح للإضافة

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

عَرَض: يظهر الوكيل في Teams لكنه لا يستطيع إضافة أو إنشاء نسخة؛ زر طلب النسخة لا يعمل.

السبب الجذري: Microsoft Agent 365 Frontier غير مفعل للمستأجر.

الحل: تواصل مع مسؤول المستأجر الخاص بك للتحقق من تفعيل Microsoft Agent 365 Frontier للمستأجر

تعرف أكثر على فرونتير

التحقق:

تظهر ميزات Frontier داخل تطبيقات Microsoft 365 Copilot وMicrosoft 365 بمجرد أن تسمح إعدادات الترخيص والمسؤول بذلك.

الوكيل لا يستجيب للرسائل

عَرَض: أنشأت نسخة وكيل لكنها لا تستجيب للرسائل؛ لا توجد سجلات في التطبيق.

السبب الجذري: أسباب متعددة محتملة - مشاكل في نقاط نهاية الرسائل، مشاكل في المصادقة، أو أخطاء التكوين.

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

  1. تحقق من تشغيل تطبيق الويب:

    az webapp show --name <your-app-name> --resource-group <your-resource-group> --query state
# Should be: "Running"

  2. تحقق من نقطة نهاية الرسالة:

    • يجب أن يكون: https://<your-app-root-url>/api/messages
    • تحقق من ذلك في a365.config.json و a365.generated.config.json

  3. اختبر نقطة النهاية مباشرة:

    curl https://<your-app-root-url>/api/messages
# Should not return 404

  4. تحقق من سجلات التقديم:

    az webapp log tail --name <your-app-name> --resource-group <your-resource-group>
# Look for incoming requests and errors

التشخيصات المتقدمة

  1. تحقق من المصادقة:

    • تحقق مما إذا كانت الرموز منتهية الصلاحية. جددها إذا لزم الأمر.
    • تحقق من بيانات الاعتماد في إعدادات تطبيق الويب.

  2. تحقق من إعدادات الأداة/MCP:

    • تحقق من أن خوادم MCP مضبوطة.
    • تمنح أصار التحقق.

  3. اختبر محليا:

    • شغل الوكيل محليا بنفس الإعدادات.
    • اختبر مع ملعب العميلات.
    • إذا كان يعمل محليا لكنه ليس في النشر السحابي > ، مشكلة

الحلول الشائعة

  • نقطة نهاية الرسائل غير صحيحة: تحديث في بوابة Azure وبوابة المطورين
  • توقف تطبيق الويب: ابدأه باستخدام Azure portal أو CLI
  • الرمز منتهية: تحديث الرموز في متغيرات بيئة تطبيق الويب
  • المتغيرات البيئية المفقودة: تحقق من إعدادات التطبيق في بوابة Azure
  • مشاكل خادم MCP: تحقق من أصل الخدمة والصلاحيات
  • أخطاء في الشيفرة: تحقق من سجلات التطبيقات بحثا عن الاستثناءات

التحقق من الصحة

أرسل رسالة إلى وكيلك في Teams وتحقق من سجلات الطلبات بحثا عن الطلبات الواردة.

قد ترغب أيضا في تجربة:

فشل استدعاءات الأدوات

عَرَض: الوكيل يرد على الرسائل لكن استدعاءات الأدوات تفشل. ترى أخطاء رفض الإذن أو انتهاء الوقت.

السبب الجذري: أما صلاحيات خادم MCP المفقودة، أو مبدأ الخدمة غير المهيأ، أو مشاكل في الاتصال بالشبكة، أو إعداد أداة غير صحيح.

Solutions

جرب الحلول التالية عندما تفشل استدعاءات الأدوات:

  • تحقق من الأدنوات في مركز الإدارة

    مراجعة وموافقة على صلاحيات خادم MCP المطلوبة:

    • انتقل إلى: https://admin.cloud.microsoft/#/agents/all
    • اختر أمنيات وكيلك >
    • تأكد من أن القائمة تتضمن وتوافق على خوادم MCP المطلوبة

  • تحقق من مبدأ الخدمة

    شغل سكريبت الإعداد لمرة واحدة إذا لم تكن قد شغلته من قبل:

    # Download and run:
# https://github.com/microsoft/Agent365-devTools/blob/main/scripts/cli/Auth/New-Agent365ToolsServicePrincipalProdPublic.ps1

  • تحقق من تكوين نقطة نهاية MCP

    تأكد من أنك تستخدم نقطة نهاية MCP الإنتاجية:

    # Should be production endpoint, not mock
MCP_PLATFORM_ENDPOINT=https://agent365.svc.cloud.microsoft

  • تحقق من الهوية المدارة

    تحقق من تفعيل الهوية المدارة على تطبيق الويب الخاص بك:

    # Verify managed identity is enabled
az webapp identity show --name <your-app-name> --resource-group <your-resource-group>

التحقق من الصحة

استدعاءات أدوات الاختبار عبر Teams وتحقق من السجلات للتحقق من نجاح التنفيذ.

قد ترغب أيضا في تجربة هذه الخطوات:

فشل تعيين الترخيص

عَرَض: لا يمكن تعيين ترخيص لمستخدم وكيل؛ أخطاء في الترخيص في مركز المسؤول.

السبب الجذري: تراخيص غير كافية متاحة، نوع ترخيص غير صحيح، أو مشكلة في الأصوات.

Solutions

جرب الحلول التالية عندما يفشل تعيين الترخيص:

  1. التحقق من توفر تراخيص المعلومات:

    • تحقق منتراخيصالفوترة> في مركز > إدارة مايكروسوفت 365
    • تأكد من تفعيل Microsoft Agent 365 Frontier للمستأجر

  2. تعيين الترخيص يدويا:

    • اذهب إلى مركز > إدارة Microsoft 365 مستخدمي
    • ابحث عن المستخدم الوكيل
    • تعيين الرخصة المناسبة

  3. التراخيص المطلوبة لكامل الوظائف:

    • مايكروسوفت 365 E5 (أو ما يعادله)
    • تيمز إنتربرايز
    • مايكروسوفت 365 كوبايلوت (لميزات كوبايلوت)

التحقق من الصحة

تحقق من ملف المستخدم في مركز الإدارة يظهر التراخيص المخصصة.

  • Last updated on