تكوين متغيرات السياق لعاملي الذكاء الاصطناعي

ينطبق على: Dynamics 365 Customer Service، وDynamics 365 Contact Center—بشكل مستقل فقط

ملاحظة

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

تسرد هذه المقالة متغيرات السياق لعوامل Azure و Copilot، وكيف يمكنك تكوينها في Dynamics 365 Contact Center. لفهم كيفية إنشاء متغيرات سياق، راجع إدارة متغيرات السياق.

متغيرات السياق لوكلاء Copilot

يحتوي الجدول التالي على قائمة متغيرات السياق المتوفرة في Dynamics 365 Contact Center التي يمكنك استخدامها لتكوين عوامل Copilot.

Important

  • يمكن الوصول إلى بعض المتغيرات بسهولة أكبر إذا قمت بتثبيت حلول الملحق.
  • يمكن أن يتلقى Copilot Studio المتغيرات بشكل غير متزامن أثناء المحادثة. يسمح هذا لعامل الذكاء الاصطناعي بتحية المستخدمين لديك مع زمن انتقال قصير، أثناء استخدام البيانات المخصصة التي يوفرها مركز الاتصال أثناء المحادثة. عند تصميم العامل الخاص بك، ضع في اعتبارك مصادر البيانات وأوقات الاسترداد لأن المعلومات من بيئات Dataverse قد تواجه تأخيرات. تكوين إعدادات المهلة في تعريف المتغير لإدارة البيانات المتأخرة بشكل صحيح. تعرف على المزيد في تعيين المتغيرات العمومية من مصادر خارجية.
نوع متغير السياق اسم متغير السياق الوصف كيفية رسم الخرائط في Copilot Studio
استطلاع قبل المحادثة استخدم اسم سؤال استطلاع ما قبل المحادثة الذي تقوم بإنشائه في Dynamics 365 Contact Center. يخزن النظام الردود من استطلاع ما قبل المحادثة كمتغيرات سياق. استخدم المعلومات التالية لتعيين اسم السؤال في Dynamics 365 Contact Center مع نوع المتغير في Copilot Studio:
  • سطر واحد: الرد الكامل للمستخدم
  • أسطر متعددة: الرد الكامل للمستخدم
  • مجموعة خيارات الرد الكامل للمستخدم
  • موافقة المستخدم: منطقية
سياق مخصص للدردشة استخدم اسم المتغير الذي تقوم بإنشائه في Dynamics 365 Contact Center أو مرر باستخدام setContextProvider API. يمكن تمرير متغيرات السياق المخصصة التي تقوم بإنشائها من خلال SDK للدردشة المباشرة. استخدم المعلومات التالية لتعيين متغير السياق المخصص في Dynamics 365 Contact Center مع نوع المتغير في Copilot Studio:
  • سلسلة: الرد الكامل للمستخدم
  • منطقي: منطقي
  • رقم، رقم عائم: رقم
سياق مخصص لـ Direct Line استخدم اسم المتغير الذي تقوم بإنشائه في Dynamics 365 Contact Center. يمكن تمرير متغيرات السياق المخصصة التي تقوم بإنشائها كأزواج قيم المفاتيح في Activity.ChannelData.ConversationContext عندما يبدأ عميل DirectLine محادثة. استخدم المعلومات التالية لتعيين متغير السياق المخصص في Dynamics 365 Contact Center مع نوع المتغير في Copilot Studio:
  • سلسلة: الرد الكامل للمستخدم
  • منطقي: منطقي
  • رقم، رقم عائم: رقم
المتغيرات التي تم تعيينها بواسطة قواعد تصنيف العمل استخدم اسم المتغير الذي قمت بإنشائه في مركز إدارة مركز الاتصالات. تتطلب المتغيرات المخصصة التي تم إنشاؤها كجزء من قواعد تصنيف العمل وقتًا إضافيًا للمعالجة لإنشاء السياق. تعيين مهلة لسياق تصنيف العمل في عامل الذكاء الاصطناعي. تعرف على المزيد في تعيين المتغيرات العمومية من مصادر خارجية. استخدم المعلومات التالية لتعيين متغير السياق المخصص في Dynamics 365 Contact Center مع نوع المتغير في Copilot Studio:
  • سلسلة: الرد الكامل للمستخدم
  • منطقي: منطقي
  • رقم، رقم عائم: رقم
حوار msdyn_ConversationId استخدم متغير السياق الذي يحتوي على معرف المحادثة للمحادثة المستمرة ويمكنه إحضار العمليات وتنفيذها على السجل في Microsoft Dataverse. سلسلة: الرد الكامل للمستخدم.
متغيرات المراسلة فقط msdyn_CustomerType 1 استخدم متغير السياق هذا الذي يحتوي على نوع العميل لسجل الحساب أو جهة الاتصال المرتبط بالمحادثة. حدد المتغير الخاص بحل امتداد القنوات المتعددة.
msdyn_CustomerName 1 استخدم متغير السياق هذا الذي يحتوي على اسم العميل لسجل الحساب أو جهة الاتصال المرتبط بالمحادثة. حدد المتغير الخاص بحل امتداد القنوات المتعددة.
msdyn_CustomerId 1 استخدم متغير السياق هذا الذي يحتوي على معرف العميل لسجل الحساب أو جهة الاتصال المرتبط بالمحادثة. حدد المتغير الخاص بحل امتداد القنوات المتعددة.
msdyn_CaseId 1 استخدم متغير السياق هذا الذي يحتوي على معرف سجل الحالة المرتبط بالمحادثة. يتم استرداد البيانات من بيئة Dataverse كجزء من تعريف العميل التلقائي. ومن ثم، قد يواجه وكيل الذكاء الاصطناعي زمن انتقال في تلقي البيانات. حدد المتغير الخاص بحل امتداد القنوات المتعددة.
msdyn_CaseTitle 1 استخدم متغير السياق هذا الذي يحتوي على عنوان سجل الحالة المرتبط بالمحادثة. حدد المتغير الخاص بحل امتداد القنوات المتعددة.
msdyn_ChannelInstanceId المعرف الفريد Dataverse لسجل مثيل القناة، على سبيل المثال، المعرف الفريد لنافذة الدردشة المكونة أو صفحة Facebook. سلسلة: الرد الكامل للمستخدم.
msdyn_WorkstreamId معرف Dataverse الفريد لتدفق العمل المقترن بمثيل القناة. سلسلة: الرد الكامل للمستخدم.
msdyn_Locale التعليمات البرمجية المحلية المكونة على مثيل القناة، على سبيل المثال، عنصر واجهة مستخدم الدردشة أو صفحة Facebook. يمكن استخدام هذا لسيناريوهات مثل وكلاء Copilot Studio متعدد اللغات. سلسلة: الرد الكامل للمستخدم.
msdyn_SocialProfileId يسجل Dataverse معرفًا فريدًا لملف التعريف الاجتماعي المقترن بالمحادثة. سلسلة: الرد الكامل للمستخدم.
msdyn_LineCustomerName اسم العميل من LINE API. سلسلة: الرد الكامل للمستخدم.
msdyn_TeamsCustomerName اسم العميل من Microsoft Teams. سلسلة: الرد الكامل للمستخدم.
msdyn_TeamsCustomerEmail عنوان البريد الإلكتروني (UPN) من Microsoft Teams. سلسلة: الرد الكامل للمستخدم.
msdyn_CapabilityList تسرد إمكانية Apple Messages for Business القيم كسلسلة محددة. سلسلة: الرد الكامل للمستخدم.
msdyn_AppleMessagesForBusinessGroupId معرف مجموعة Apple Messages for Business. سلسلة: الرد الكامل للمستخدم.
msdyn_AppleMessagesForBusinessIntentId معرف هدف Apple Messages for Business. سلسلة: الرد الكامل للمستخدم.
msdyn_AppleMessagesForBusinessLocale إعدادات محلية مقدمة من واجهة API لـ Apple Messages for Business. سلسلة: الرد الكامل للمستخدم.
msdyn_AppleBusinessId معرف العمل من حساب Apple Messages for Business. سلسلة: الرد الكامل للمستخدم.
msdyn_FacebookCustomerName اسم العميل من Facebook. سلسلة: الرد الكامل للمستخدم.
msdyn_FacebookLocale إعدادات المستخدم النهائي للعميل من Facebook. سلسلة: الرد الكامل للمستخدم.
msdyn_FacebookTimezone المنطقة الزمنية للعميل من Facebook. سلسلة: الرد الكامل للمستخدم.
msdyn_FacebookUserPageScopedId معرف المستخدم الخاص بصفحة العميل من Facebook. سلسلة: الرد الكامل للمستخدم.
msdyn_FacebookPageId PageID من صفحة Facebook الخاصة بك. سلسلة: الرد الكامل للمستخدم.
msdyn_CustomerPhoneNumber رقم الهاتف الذي يقوم العميل بإرسال الرسائل النصية منه عبر قنوات WhatsApp والرسائل النصية القصيرة. سلسلة: الرد الكامل للمستخدم.
msdyn_OrganizationPhoneNumber رقم الهاتف الذي يتلقى رسائل من العميل (رقم مؤسستك). لاحظ أن هذا لا يتم تمريره على WhatsApp عبر خدمات اتصالات Azure. سلسلة: الرد الكامل للمستخدم.
msdyn_WhatsAppCustomerFirstMessage إذا كنت تستخدم رسالة مملوءة مسبقًا في رابط WhatsApp العالمي الخاص بك، فسيتم تمرير هذه المعلومات في هذا المتغير. سلسلة: الرد الكامل للمستخدم.
متغيرات الصوت فقط 2 Activity.From.Name استخدم متغير السياق هذا لرقم هاتف العميل في نشاط الاتصال الهاتفي. قم بتعيين هذا المتغير إلى متغير عمومي في موضوع بدء المحادثة. تعرف على المزيد في تكوين متغيرات السياق لعامل Copilot Studio. حدد متغير النظام من Microsoft Copilot Studio.
Activity.Recipient.Name استخدم متغير السياق هذا لرقم هاتف المؤسسة في نشاط الاتصال الهاتفي. قم بتعيين هذا المتغير إلى متغير عمومي في موضوع بدء المحادثة. تعرف على المزيد في تكوين متغيرات السياق لعامل Copilot Studio. حدد متغير النظام من Microsoft Copilot Studio.
اسم أسلوب الملحق va_SurveyConsent استخدم مربع الحوار هذا لتحديد ما إذا كان العميل قد وافق على المشاركة في الاستطلاعات أثناء المحادثة. استخدم هذا الأسلوب لتصعيد تفاصيل المحادثة إلى Dynamics 365 Contact Center.
va_CustomerLocale استخدم مربع الحوار هذا لنقل المستخدم الذي يتحدث حاليًا إلى العامل إلى عامل آخر يمكنه التحدث بلغة مختلفة. قم بتعيين الكود عن طريق تحديد متغير الإدخال واستخدام كود الإعدادات المحلية الصحيحة.

1 لاستخدام متغيرات السياق الأخرى للصوت، يمكنك الحصول عليها من Copilot Studio. اعرف المزيد في العمل مع المتغيرات.

تكوين متغيرات السياق لعامل Copilot

لجعل عامل Copilot يقرأ متغيرات السياق من Dynamics 365 Contact Center، قم بالخطوات التالية:

  1. في الصفحة مواضيع، حدد إضافة موضوع>من فارغ. استخدم موضوعًا غير مطلوب أو موضوعًا موجودًا بالفعل، وإلا فلن يعمل متغير السياق.

  2. أدخل اسمًا لموضوعك، مثل تعيين متغيرات السياق، واحفظه.

  3. قم بإضافة عقدة جديدة إلى موضوع، وحدد "تعيين إدارة > المتغير" لقيمة متغيرة.

  4. في عقدتك الجديدة، ضمن تعيين متغير حدد إنشاء متغير جديد.

  5. افتح جزء خصائص المتغير عن طريق تحديد اسم المتغير الجديد. في الجزء، قم بتعيين اسم المتغير لمطابقة اسم متغير سياق قناة متعددة الاتجاهات تمامًا (إنه حساس لحالة الأحرف).

  6. في قسم المرجع ، حدد علامات الحذف العمودية، ثم حدد الحصول على قيمة من هذه العقدة إذا كانت فارغة. يسترد عامل Copilot Studio قيمة المتغير من هذه العقدة في وقت التشغيل.

  7. في قسم Usage، حدد Global (يمكن لأي موضوع الوصول إليه) المصادر الخارجية يمكنها تعيين القيم بحيث يقبل عامل Copilot Studio البيانات من قناة متعددة الاتجاهات ويمكن استخدام هذا المتغير في أي موضوع.

  8. إذا كنت تستخدم بيانات من قواعد تصنيف العمل في المتغير، فتأكد من تعيين طول مهلة في تعريف المتغير. تعرف على المزيد في تعيين المتغيرات العمومية من مصادر خارجية.

  9. أغلق جزء خصائص المتغير.

  10. في العقدة، أدخل قيمة في إلى القيمة التي تتطابق مع نوع البيانات الذي يتوقعه العامل.

    شاشة لمتغير سياق في موضوع في Copilot Studio.

  11. احفظ التغييرات وانشرها.

ملاحظة

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

أثناء المحادثة، يتم تعيين البيانات من متغير سياق مركز الاتصال في متغيرات Copilot Studio ويمكن استخدامها في منطق العامل.

بإمكان العامل أيضًا تعيين متغيرات سياق القناة متعددة الاتجاهات أثناء المحادثة. لتعيين متغير قناة متعددة الاتجاهات من منطق Copilot Studio الخاص بك، تأكد من أن العامل الخاص بك يستخدم اسم المتغير الصحيح وضبط القيمة في الخاصية "إلى قيمة" في عقدة إدارة المتغير. يقوم Copilot Studio بتسليم اًلْمتغير إلى اًلْقناة متعددة اًلْاتجاهات أثناء اًلْنقل إلى ممثل خدمة اًلْعملاء. يُستخدم هذا الأمر في أغلب الأحيان لربط المحادثة بحالة عندما يقوم العامل بتصعيد المحادثة إلى ممثل الخدمة. مزيد من المعلومات حول كيفية ربط السجلات في في الوقت الذي تم تسجيله فيه من هذه البيانات: ربط العميل والم حالة بحديث

يمكن تمرير المتغيرات العمومية التي تم إنشاؤها في Copilot Studio إلى Dynamics 365 Contact Center عند تصعيد محادثة. للحصول على القائمة الكاملة، راجع متغيرات السياق المتوفرة عند التسليم.

تحليل كائن JSON لاستخراج معرف السجل

تأكد من حصولك على التفاصيل التالية:

  • متغير سياق Dynamics 365 Contact Center، مثل msdyn_contact_msdyn_ocliveworkitem_Customer.
  • تفاصيل المخطط.

نسخة تفاصيل عينة المخطط هي كما يلي:

        Schema: 
        {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "RecordId": {
                        "type": "string"
                    },
                    "PrimaryDisplayValue": {
                        "type": "string"
                    }
                },
                "required": [
                    "RecordId",
                    "PrimaryDisplayValue"
                ]
            }
        }

PrimaryDisplayValue يحتوي على القيمة من السمة في كيانات Dataverse. تعيين سمات الكيان هو كما يلي:

  • الحالات: عنوان الحالة
  • جهات الاتصال: الاسم الكامل
  • الحسابات: الاسم

فيما يلي عينة سجل سياق.

{
    "msdyn_contact_msdyn_ocliveworkitem_Customer": [
        {
            "RecordId": "<GUID>",
            "PrimaryDisplayValue": "<FullName>"
        }
    ],
    "msdyn_liveworkitemid": "<GUID>"
}

متغيرات السياق لوكلاء Azure

يحتوي الجدول التالي على قائمة متغيرات السياق في Dynamics 365 Contact Center التي يمكنك استخدامها لتكوين عوامل Azure.

نوع متغير السياق اسم متغير السياق الوصف كيفية رسم خرائط في Azure
استطلاع قبل المحادثة استخدم اسم سؤال استطلاع ما قبل المحادثة الذي تقوم بإنشائه في Dynamics 365 Contact Center. يخزن النظام الردود من استطلاع ما قبل المحادثة كمتغيرات سياق. استخدم المعلومات التالية لتعيين اسم السؤال في Dynamics 365 Contact Center بنوع المتغير في Azure:
  • سطر واحد: سلسلة
  • أسطر متعددة: سلسلة
  • مجموعة خيارات: سلسلة
  • موافقة المستخدم: منطقية
سياق مخصص استخدم اسم المتغير الذي تقوم بإنشائه في Dynamics 365 Contact Center أو مرر باستخدام setContextProvider API. يمكن تمرير متغيرات السياق المخصصة التي تقوم بإنشائها من خلال SDK للدردشة المباشرة. تعيين استجابة المستخدم ك JSON لاستخدام متغير سياق مخصص في Dynamics 365 Contact Center.
سياق مخصص لـ Direct Line استخدم اسم المتغير الذي تقوم بإنشائه في Dynamics 365 Contact Center يمكن تمرير متغيرات السياق المخصصة التي تقوم بإنشائها كأزواج قيم المفاتيح في Activity.ChannelData.ConversationContext عندما يبدأ عميل DirectLine محادثة. استخدم المعلومات التالية لتعيين متغير السياق المخصص في Dynamics 365 Contact Center مع نوع المتغير في Copilot Studio:
  • سلسلة: الرد الكامل للمستخدم
    • منطقي: منطقي
  • رقم، رقم عائم: رقم
حوار msdyn_ConversationId استخدم متغير السياق الذي يحتوي على معرف المحادثة للمحادثة المستمرة ويمكنه إحضار العمليات وتنفيذها على السجل في Microsoft Dataverse. السلسلة: سلسلة
جهة الاتصال msdyn_contact_msdyn_ocliveworkitem_Customer استخدم متغير السياق هذا الذي يحتوي على معرف السجل لسجل العميل (جهة الاتصال) المرتبط بالمحادثة. تحليل JSON لاستخراج معرف السجل.
الحساب msdyn_account_msdyn_ocliveworkitem_Customer استخدم متغير السياق هذا الذي يحتوي على معرف السجل لسجل الحساب المرتبط بالمحادثة. تحليل JSON لاستخراج معرف السجل.
الحالة msdyn_incident_msdyn_ocliveworkitem استخدم متغير السياق هذا الذي يحتوي على معرف السجل لسجل الحالة المرتبط بالمحادثة. تحليل JSON لاستخراج معرف السجل.
مثيل القناة msdyn_ChannelInstanceId المعرف الفريد Dataverse لسجل مثيل القناة، على سبيل المثال، المعرف الفريد لنافذة الدردشة المكونة أو صفحة Facebook. سلسلة: الرد الكامل للمستخدم.
تدفق العمل msdyn_WorkstreamId معرف Dataverse الفريد لتدفق العمل المقترن بمثيل القناة. سلسلة: الرد الكامل للمستخدم.
الإعدادات المحلية للقناة msdyn_Locale التعليمات البرمجية المحلية المكونة على مثيل القناة. على سبيل المثال، عنصر واجهة مستخدم الدردشة أو صفحة Facebook. يمكن استخدام هذا لسيناريوهات مثل وكلاء Copilot Studio متعدد اللغات. سلسلة: الرد الكامل للمستخدم.
الملف الاجتماعي msdyn_SocialProfileId يسجل Dataverse معرفًا فريدًا لملف التعريف الاجتماعي المقترن بالمحادثة. سلسلة: الرد الكامل للمستخدم.
اسم عميل Line msdyn_LineCustomerName اسم العميل من LINE API. سلسلة: الرد الكامل للمستخدم.
اسم عميل Teams msdyn_TeamsCustomerName اسم العميل من Microsoft Teams. سلسلة: الرد الكامل للمستخدم.
البريد الإلكتروني لعميل Teams msdyn_TeamsCustomerEmail عنوان البريد الإلكتروني (UPN) من Microsoft Teams. سلسلة: الرد الكامل للمستخدم.
قائمة قدرات Apple msdyn_CapabilityList تسرد إمكانية Apple Messages for Business القيم كسلسلة محددة. سلسلة: الرد الكامل للمستخدم.
معرف مجموعة Apple msdyn_AppleMessagesForBusinessGroupId معرف مجموعة Apple Messages for Business. سلسلة: الرد الكامل للمستخدم.
معرف هدف Apple msdyn_AppleMessagesForBusinessIntentId معرف هدف Apple Messages for Business. سلسلة: الرد الكامل للمستخدم.
Apple Locale msdyn_AppleMessagesForBusinessLocale إعدادات محلية مقدمة من واجهة API لـ Apple Messages for Business. سلسلة: الرد الكامل للمستخدم.
معرف Apple Business msdyn_AppleBusinessId معرف العمل من حساب Apple Messages for Business. سلسلة: الرد الكامل للمستخدم.
اسم عميل Facebook msdyn_FacebookCustomerName اسم العميل من Facebook. سلسلة: الرد الكامل للمستخدم.
اللغة المحلية لعميل Facebook msdyn_FacebookLocale إعدادات المستخدم النهائي للعميل من Facebook. سلسلة: الرد الكامل للمستخدم.
المنطقة الزمنية لعميل Facebook msdyn_FacebookTimezone المنطقة الزمنية للعميل من Facebook. سلسلة: الرد الكامل للمستخدم.
معرف محدد لصفحة عميل Facebook msdyn_FacebookUserPageScopedId معرف المستخدم الخاص بصفحة العميل من Facebook. سلسلة: الرد الكامل للمستخدم.
معرف صفحة Facebook msdyn_FacebookPageId PageID من صفحة Facebook الخاصة بك. سلسلة: الرد الكامل للمستخدم.
رقم هاتف العميل msdyn_CustomerPhoneNumber رقم الهاتف الذي يقوم العميل بإرسال الرسائل النصية منه عبر قنوات WhatsApp والرسائل النصية القصيرة. سلسلة: الرد الكامل للمستخدم.
رقم هاتف المؤسسة msdyn_OrganizationPhoneNumber رقم الهاتف الذي يتلقى رسائل من العميل (رقم مؤسستك). لاحظ أن هذا لا يتم تمريره على WhatsApp عبر خدمات اتصالات Azure سلسلة: الرد الكامل للمستخدم.
رسالة ارتباط WhatsApp Universal msdyn_WhatsAppCustomerFirstMessage إذا كنت تستخدم رسالة مملوءة مسبقًا في رابط WhatsApp العالمي الخاص بك، يتم تمرير هذه المعلومات في هذا المتغير. سلسلة: الرد الكامل للمستخدم.

ملاحظة

استخدم أسماء متغيرات السياق كما هو محدد ولا تغيرها عند تأليف تدفقات في عوامل Azure أو Copilot Studio. تأكد أيضًا من استخدام المطابقة الدقيقة لتمرير القيمة إلى متغير السياق لأنه حساس لحالة الأحرف. إذا كان هناك عدم تطابق، فلن يتم تعريف السجل تلقائيًا. مزيد من المعلومات: تحديد السجلات تلقائيًا

دمج وكيل Copilot Studio
دمج وكيل Azure
تكوين العاملين لتصعيد وإنهاء المحادثات
مرجع SDK للدردشة الفورية

  • Last updated on