توزيع العوامل في Microsoft Teams

يقدم Microsoft Teams تحديات توزيع فريدة لوكلاء Copilot Studio بسبب بيئة المحادثة المستمرة الخاصة به. على عكس عمليات النشر القائمة على الويب التي تتم فيها إعادة تعيين الجلسات تلقائيًا، يحتفظ نظام Teams بسلاسل المحادثة لمدة غير محددة، مما قد يؤدي إلى سياق قديم، وانتهاء صلاحية الرموز المميزة، وتخزين محتوى مؤقت قديم.

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

الاعتبارات الرئيسية المشمولة:

• إدارة دورة حياة الجلسة ومعالجة عدم النشاط
• تقنيات تصحيح الأخطاء للمحادثات المستمرة
• التحكم في الإصدار وتحديث استراتيجيات النشر
• أنماط التنفيذ الخاصة بـ Teams

اتبع هذه الممارسات لإنشاء عوامل قوية تعمل باستمرار في بيئة Teams مع تقديم ملاحظات واضحة للمستخدمين حول تغييرات الحالة وسلوك النظام.

لماذا يختلف نشر Teams

تستمر محادثات Teams عبر الأيام دون إعادة تعيين تلقائي. على عكس جلسات Web Chat، يتم تشغيل الحدث ConversationStart فقط في المرة الأولى التي تتم فيها إضافة عامل. لا يؤدي إعادة تثبيت التطبيق إلى إعادة تشغيل هذا الحدث.

يؤدي استمرار Teams إلى العديد من المخاطر:

• السياق القديم: تظل محفوظات المحادثات ما لم يتم مسحها.
• انتهاء صلاحية الرمز المميز: يمكن أن تنتهي صلاحية الموصلات أثناء جلسات العمل الطويلة.
• حدود السياق: يمكن أن تتجاوز الرسائل المتراكمة حدود النموذج.
• تحديث التخزين المؤقت: قد يستمر المستخدمون في التفاعل مع منطق قديم.

تعد الإدارة الاستباقية للحالة وتوجيه المستخدم الواضح أمرين أساسيين.

إدارة دورة حياة الجلسة

إدارة دورة حياة الجلسة مع التعامل مع حالات عدم النشاط.

تنفيذ عمليات إعادة تعيين عدم الْنشاط

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

1. أضف مشغل عدم النشاط وقم بتعيين مهلة (على سبيل المثال، 15 دقيقة).
2. أضف عقدة واحدة أو أكثر مِنْ عقد قيم الْمتغيرات الْواضحة لإزالْة متغيرات الْجلسة ومحفوظات الْمحادثات لمنع تجاوز الْسياق.
3. إنهاء المحادثة ووضع علامة على جلسة العمل على أنها تم حلها.

يمنع هذا الأسلوب تجاوز السياق ويضمن سلوكا يمكن التنبؤ به عند إرجاع المستخدم.

توفير إرشادات بعد إعادة التعيين

بعد مسح الحالة، أرسل رسالة تشرح ما حدث. على سبيل الْمثالْ: "يبدو أن محادثتنا أصبحت خاملة، لذا سأقوم بمسح الْسياق الْسابق للسلامة. قل 'hello' لإعادة التشغيل."

لأنه ConversationStart يتم إطلاقه مرة واحدة فقط، في المرة الأولى التي تتم فيها إضافة عامل، يصبح موضوع الترحيب نقطة التهيئة الفعالة الخاصة بك. يضمن مطالبة المستخدم بقول "hello" تشغيل منطق بدء التشغيل بشكل صحيح.

إتاحة أمر إعادة تعيين ذاتي

أضف المراسلة التي تعلم المستخدمين بأنه يمكنهم كتابة أمر معين: "إذا كان هناك شيء ما يبدو خاطئا، فحاول الكتابة /debug clearstate لتحديث حالتي."

يفرض هذا الأمر إعادة تعيين محادثة كاملة:

• مسح حالة المحادثة
• إزالة معلومات الموصل المخزنة مؤقتا
• إعادة المصادقة على الموصلات
• تشغيل أحدث إصدار مِنْ الْوكيل

استخدم هذا الأمر عندما:

• يبدو أن الروبوت "عالق" مع معلومات قديمة
• انتهت صلاحية الْتوثيق الْخاصة بالْموصل
• بعد تحديثات منطق الروبوت
• عندما يبدو السلوك غير متناسق

زيادة الشفافية وتحسين تصحيح الأخطاء

لزيادة الشفافية وتحسين تصحيح الأخطاء للوكلاء الموزعين في منصة Teams، استخدم OnKnowledgeRequested المحفز.

استخدام OnKnowledgeRequested للكشف عن الاستعلامات المعاد كتابتها

يقوم Copilot Studio بإعادة صياغة أسئلة المستخدم قبل إجراء الاسترداد. إذا قمت بتفعيل OnKnowledgeRequested المشغل، يمكنك:

• تشخيص عدم تطابق الهدف
• فهم كيفية إعادة كتابة الاستعلامات
• زيادة ثقة المستخدم أثناء تصحيح الأخطاء

ملاحظة

يمكنك إعداد المشغل OnKnowledgeRequested فقط في طريقة عرض التعليمات البرمجية باستخدام YAML. لا يوجد دعم للمصمم المرئي.

أضف رسالة تعرض كلا من الكلمة الأساسية والاستعلامات الدلالية التي تم إنشاؤها. على سبيل المثال:

kind: AdaptiveDialog
beginDialog:
  kind: OnKnowledgeRequested
  id: main
  actions:
    - kind: SendActivity
      id: sendActivity_debug
      activity: |-    
        **Debug**: sending this lexical query "{System.KnowledgeSearchQuery}"
        **Debug**: sending this semantic query "{System.SearchQuery}"
inputType: {}
outputType: {}

يوفر هذا الاستعلام وصولا للقراءة فقط إلى استعلام البحث المكرر (إعادة كتابة الاستعلام) الذي أنشأه المنسق من سؤال المستخدم.

المزايا:

• يساعد على تصحيح عدم التطابق في الهدف.
• يعرض للمستخدمين ما يبحثه العامل.
• بناء الثقة في تصرفات الوكيل.
• يساعد المصنعين أثناء الاختبار.

التحكم في الإصدار وتحديث الموثوقية

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

Surface إصدار الْروبوت فِي تحية أو موضوع مخصص

قم بتضمين معرف إصدار باستخدام موضوع الترحيب أو موضوع إصدار مخصص:

Contoso Helpdesk Bot – Version 1.3 (Nov 2025)

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

تمكين "فرض الإصدار الأحدث" عند النشر

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

اعتبارات الْتنفيذ الْخاصة ب Teams

لدى Teams سلوكيات فريدة تتطلب اهتماما خاصا.

تعامل مع موضوع الترحيب على أنه منطق بدء التشغيل

نظرا إلى ConversationStart أنه يتم إطلاق الْنار مرة واحدة فقط، فِي الْمرة الْأولى الْتي تتم فيها إضافة عامل:

• ضع منطق التهيئة في الترحيب.
• أضف إرشادات واضحة في وصف تطبيق Teams.
• تذكير المستخدمين: "بعد انتهاء المهلة، اكتب 'hello' لبدء محادثة جديدة."

تحسين الْمشغلات والْإجراءات الْاحتياطية

يتفاعل مستخدمو Teams بشكل طبيعي وغير متوقع. تأكد من أن الروبوت الخاص بك:

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

التحقق من صحة سلوك مصادقة الموصل

عند استخدام الموصلات (ServiceNow، Outlook، وغيرها)، اختبر:

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

Tip

قد لا تقوم الموصلات بتحديث الرموز المميزة أثناء الجلسات الممتدة. استخدم عمليات إعادة تعيين عدم النشاط أو /debug clearstate لإعادة تشغيل OAuth عند الحاجة. قم بتوصيل هذا الأمر لدعم الفرق والمستخدمين لاستكشاف الأخطاء وإصلاحها بسرعة.

اختبار في ظل ظروف حقيقية

نظرا لأن Teams يحتفظ بالحالة عبر الجلسات، يجب أن يعكس اختبارك تجربة المستخدم الحقيقية:

1. النشر باستخدام إظهار لي فقط.
2. اختبار السيناريوهات طويلة الأمد (العودة بعد ساعات).
3. نشر الْتحديثات وتأكيد تبديل الْعامل للإصدارات.
4. التحقق من صحة عرض البطاقة التكيفية عبر سطح المكتب والهاتف المحمول.
5. اختبار الإجراءات في سياقات محادثة متنوعة.

قائمة التحقق من التوزيع

منجز؟	المهمة
✓	تم تكوين مشغل عدم النشاط لمسح محفوظات المحادثات
✓	توضح رسائل المستخدم عمليات إعادة التعيين وتوجه عملية إعادة التشغيل.
✓	/debug clearstate موثق للمستخدمين
✓	OnKnowledgeRequested تمكين الشفافية أثناء التطوير
✓	معرف الإصدار المضمن في الاستجابات
✓	فرض تمكين أحدث إصدار حسب الاقتضاء
✓	يتضمن موضوع الترحيب منطق التهيئة
✓	السلوك الاسترجاعي سهل الاستخدام
✓	تم اختبار مصادقة الْموصل لانتهاء وتجديد الْصلاحية
✓	اكتمل الاختبار في Teams في ظل الظروف الحقيقية

المآخذ الرئيسية

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

معلومات ذات صلة

• اتصل وقم بتكوين عامل من أجل فرق Microsoft و Microsoft 365
• المفاهيم الرئيسية - نشر واستخدام العامل الخاص بك