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

هام

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

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

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

• تم إعداد مخطط الوكيل بشكل صحيح وفقا لخطوة إعداد مخطط الوكيل.
• تم نشر تطبيق الوكيل بشكل صحيح حسب وكيل النشر إلى مركز إدارة مايكروسوفت

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

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

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

شغل الأمر التالي لعرض إعدادك:

a365 config display -g

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

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

افتح متصفحك وانتقل إلى صفحة الإعدادات:

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

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

إشعار

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

تكوين العامل

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

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

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

لمزيد من المعلومات حول مخططات هوية الوكيل وتكوين بوابة المطورين، راجع تكوين مخطط هوية الوكيل.

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

الآن، يمكنك طلب نسخ من مخطط وكيلك من Teams. يذهب هذا الطلب مرة أخرى إلى مسؤول المستأجر، الذي يجب عليه الموافقة من تبويب الطلبات في مركز إدارة Microsoft 365: مركز إدارة مايكروسوفت - الوكلاء المطلوبون. بمجرد الموافقة على ذلك، يمكنك إنشاء نسخة وكيل من 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. ابدأ الاختبار

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

2. مثال على رسالة اختبار

   إذا قمت بتكوين الوكيل باستخدام البريد الإلكتروني، أرسل هذه الرسالة لاختبار وظيفة البريد الإلكتروني (تحديث بريد المستلم حسب الحاجة):

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

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

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

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

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

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