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

مهم

أصبحت إمكانيات وميزات Power Virtual Agents الآن جزءًا من Microsoft Copilot Studio بعد الاستثمارات الكبيرة في الذكاء الاصطناعي التوليدي وعمليات التكامل المحسنة عبر Microsoft Copilot.

قد تشير بعض المقالات ولقطات الشاشة إلى Power Virtual Agents أثناء قيامنا بتحديث الوثائق ومحتوى التدريب.

‏‫ملاحظة

معلومات توفر الميزة هي كما يلي.

Dynamics 365 Contact Center—مضمن	Dynamics 365 Contact Center—مستقل	Dynamics 365 Customer Service
لا.	نعم	نعم

تسرد هذه المقالة متغيرات السياق التي يمكنك تكوينها لروبوتات Azure أو Copilot Studio في القناة متعددة الاتجاهات لـ Customer Service. لفهم كيفية إنشاء متغيرات سياق، راجع إدارة متغيرات السياق.

متغيرات السياق لروبوتات Azure

يسرد الجدول التالي قائمة متغيرات السياق في القناة متعددة الاتجاهات لـ Customer Service. التي يمكنك استخدامها لتكوين روبوتات Azure.

نوع متغير السياق	اسم متغير السياق	الوصف	كيفية إنشاء الخرائط في Azure
استطلاع قبل المحادثة	استخدم اسم سؤال استطلاع ما قبل المحادثة الذي تقوم إنشاؤه في الميكنة ل خدمة العملاء.	يخزن النظام الردود من استطلاع ما قبل المحادثة كمتغيرات سياق.	استخدم المعلومات التالية لتعيين اسم السؤال في القناة متعددة الاتجاهات لخدمة العملاء بنوع المتغير في Azure: سطر واحد سلسلة أسطر متعددة: سلسلة مجموعة خيارات: سلسلة موافقة المستخدم: منطقية
سياق مخصص	استخدم اسم المتغير الذي تقوم بإنشائه في القناة متعددة الاتجاهات لـ Customer Service أو تمريره باستخدام واجهة برمجة التطبيقات‬ لـ SETContextProvider.	يمكن تمرير متغيرات السياق المخصصة التي تقوم بإنشائها من خلال SDK للدردشة المباشرة.	تعيين استجابة المستخدم كـ JSON لاستخدام متغير سياق مخصص في القناة متعددة الاتجاهات لـ Customer Service.
المحادثة	msdyn_ConversationId	استخدم متغير السياق الذي يحتوي على معرف المحادثة للمحادثة المستمرة ويمكنه إحضار العمليات وتنفيذها على السجل في Microsoft Dataverse.	السلسلة: سلسلة
جهة الاتصال	msdyn_contact_msdyn_ocliveworkitem_Customer	استخدم متغير السياق هذا الذي يحتوي على معرف السجل لسجل العميل (جهة الاتصال) المرتبط بالمحادثة.	تحليل JSON لاستخراج معرف السجل.
الحساب	msdyn_account_msdyn_ocliveworkitem_Customer	استخدم متغير السياق هذا الذي يحتوي على معرف السجل لسجل الحساب المرتبط بالمحادثة.	تحليل JSON لاستخراج معرف السجل.
حالة	msdyn_incident_msdyn_ocliveworkitem	استخدم متغير السياق هذا الذي يحتوي على معرف السجل لسجل الحالة المرتبط بالمحادثة.	تحليل JSON لاستخراج معرف السجل.

‏‫ملاحظة‬

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

متغيرات السياق لروبوتات Copilot Studio

يحتوي الجدول التالي على قائمة متغيرات السياق المتوفرة في القناة متعددة الاتجاهات لـ Customer Service. التي يمكنك استخدامها لتكوين روبوتات Copilot Studio.

مهم

لاستخدام متغيرات المراسلة والصوت، تأكد من تثبيت حلول الملحق أولاً.

نوع متغير السياق	اسم متغير السياق	الوصف	كيفية إنشاء الخرائط في Copilot Studio
استطلاع قبل المحادثة	استخدم اسم سؤال استطلاع ما قبل المحادثة الذي تقوم إنشاؤه في الميكنة ل خدمة العملاء.	يخزن النظام الردود من استطلاع ما قبل المحادثة كمتغيرات سياق.	استخدم المعلومات التالية لتعيين اسم السؤال في القناة متعددة الاتجاهات لخدمة العملاء مع نوع المتغير الموجود Copilot Studio: سطر واحد: الرد الكامل للمستخدم أسطر متعددة: الرد الكامل للمستخدم مجموعة خيارات الرد الكامل للمستخدم موافقة المستخدم: منطقية
سياق مخصص	استخدم اسم المتغير الذي تقوم بإنشائه في القناة متعددة الاتجاهات لـ Customer Service أو تمريره باستخدام setContextProvider API.	يمكن تمرير متغيرات السياق المخصصة التي تقوم بإنشائها من خلال SDK للدردشة المباشرة.	استخدم المعلومات التالية لتعيين متغير السياق المخصص في القناة متعددة الاتجاهات لـ Customer Service مع نوع المتغير في Copilot Studio: سلسلة: الرد الكامل للمستخدم منطقي: منطقي رقم، رقم عائم: رقم
المحادثة	msdyn_ConversationId	استخدم متغير السياق الذي يحتوي على معرف المحادثة للمحادثة المستمرة ويمكنه إحضار العمليات وتنفيذها على السجل في Microsoft Dataverse.	سلسلة: الرد الكامل للمستخدم.
متغيرات الصوت والمراسلة	msdyn_CustomerType	استخدم متغير السياق هذا الذي يحتوي على نوع العميل لسجل الحساب أو جهة الاتصال المرتبط بالمحادثة.	حدد متغير حل ملحق القناة متعددة الاتجاهات لـ Customer Service
	msdyn_CustomerName	استخدم متغير السياق هذا الذي يحتوي على اسم العميل لسجل الحساب أو جهة الاتصال المرتبط بالمحادثة.	حدد متغير حل ملحق القناة متعددة الاتجاهات لـ Customer Service
	msdyn_CustomerId	استخدم متغير السياق هذا الذي يحتوي على معرف العميل لسجل الحساب أو جهة الاتصال المرتبط بالمحادثة.	حدد متغير حل ملحق القناة متعددة الاتجاهات لـ Customer Service
	msdyn_CaseId	استخدم متغير السياق هذا الذي يحتوي على معرف سجل الحالة المرتبط بالمحادثة.	حدد متغير حل ملحق القناة متعددة الاتجاهات لـ Customer Service
	msdyn_CaseTitle	استخدم متغير السياق هذا الذي يحتوي على عنوان سجل الحالة المرتبط بالمحادثة.	حدد متغير حل ملحق القناة متعددة الاتجاهات لـ Customer Service
متغيرات الصوت فقط	رقم هاتف العميل	استخدم متغير السياق هذا لرقم هاتف العميل في نشاط الاتصال الهاتفي.	حدد متغير حل ملحق القناة متعددة الاتجاهات لـ Customer Service
	OrganizationPhoneNumber	استخدم متغير السياق هذا لرقم هاتف المؤسسة في نشاط الاتصال الهاتفي.	حدد متغير حل ملحق القناة متعددة الاتجاهات لـ Customer Service
اسم أسلوب الملحق	va_SurveyConsent	استخدم مربع الحوار هذا لتحديد ما إذا كان العميل قد وافق على المشاركة في الاستطلاعات أثناء المحادثة.	استخدم هذا الأسلوب لتصعيد تفاصيل المحادثة إلى القناة متعددة الاتجاهات لـ Customer Service.
	va_CustomerLocale	استخدم مربع الحوار هذا لنقل المستخدم الذي يتحدث حاليًا إلى الروبوت إلى روبوت آخر يمكنه التحدث بلغة مختلفة.	قم بتعيين الكود عن طريق تحديد متغير الإدخال واستخدام كود الإعدادات المحلية الصحيحة.

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

لكي تكون متغيرات Copilot Studio سياق القراءة الخاصة بك قد تم تحويلها إلى الكمبيوتر المستعرض في الوقت الحالي من في الوقت الحالي، فتابع الخطوات التالية:

1. في صفحة الموضوعات حدد اضافة موضوع و من فارغ.

2. أدخل اسما موضوع الخاص بك (على سبيل المثال، "تعيين متغيرات السياق") واحفظه.

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

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

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

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

7. في جزء الاستخدامحدد عالمي (يمكن الوصول إلى أي موضوع) و يمكن للمصادر الخارجية تحديد القيم. Copilot Studio يقبل بيانات من فيرمر. أغلق جزء خصائص المتغير.

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

   

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

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

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

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

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

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

• متغير سياق القناة متعددة الاتجاهات لـ Customer Service، مثل 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>"
}

(راجع أيضًا)

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