العمل مع المتغيرات العمومية

تخزن المتغيرات ردود عملائك على الأسئلة الواردة من وكيلك. على سبيل المثال، يمكنك حفظ اسم العميل في متغير يسمى UserName. يمكن للوكيل بعد ذلك مخاطبة العميل بالاسم أثناء استمرار المحادثة.

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

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

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

إنشاء متغير عمومي

يمكنك إنشاء متغير عمومي عن طريق تغيير نطاق متغير موضوع.

Note

يجب أن يكون اسم المتغير العمومي فريدا عبر جميع الموضوعات.

تطبيق الويب
كلاسيكي / الفرق

إنشاء متغير أو استخدام لوحة المتغيرات لفتح متغير موجود.
في لوحة خصائص المتغير ، حدد عمومي (أي موضوع يمكن الوصول إليه) .

يتم إعطاء اسم المتغير البادئة Global. لتمييزه عن المتغيرات على مستوى الموضوع. على سبيل المثال، يتم عرض المتغير UserName ك Global.UserName.
احفظ الموضوع.

حدد المتغير المطلوب.
في لوحة خصائص المتغير ، ضمن Usage، حدد Bot (أي موضوع يمكن الوصول إليه) .
يتم وضع علامة على اسم المتغير ببادئة bot.، لتمييزه عن المتغيرات على مستوى الموضوع. على سبيل المثال، يظهر المتغير UserEmail الآن ك bot.UserEmail.

عند إنشاء رسالة في عقدة رسالة أو عقدة سؤال ، حدد رمز {x} لعرض المتغيرات المتوفرة للموضوع. تظهر المتغيرات العمومية في علامة التبويب مخصص مع أي متغيرات موضوع. يتم سرد المتغيرات بترتيب أبجدي.

عند إنشاء رسالة في عقدة رسالة أو عقدة سؤال ، حدد رمز {x} لعرض المتغيرات المتوفرة للموضوع. يتم سرد المتغيرات بترتيب أبجدي، وتظهر جميع المتغيرات العمومية معا لأنها تبدأ جميعا ب bot..

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

البحث عن جميع الموضوعات باستخدام متغير عمومي

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

تطبيق الويب
كلاسيكي / الفرق

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

حذف المتغيرات العمومية

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

تشير العقد التي تحتوي على مراجع إلى متغير عمومي محذوف إلى أنها تحتوي على متغير غير معروف.

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

دورة حياة المتغيرات العمومية

تطبيق الويب
كلاسيكي / الفرق

بشكل افتراضي، تستمر قيمة متغير عمومي حتى تنتهي جلسة العمل . تقوم عقدة مسح قيم المتغير بإعادة تعيين قيم المتغيرات العمومية ويتم استخدامها في موضوع إعادة تعيين نظام المحادثة . عندما يؤدي إعادة التوجيه إلى تشغيل هذا الموضوع (أو عندما يدخل المستخدم عبارة مثل "البدء من جديد")، تتم إعادة تعيين جميع المتغيرات العمومية.

يمكن الوصول إلى المتغيرات العمومية من أي موضوع، وتستمر قيمتها طوال جلسة العمل.

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

تهيئة المتغير العمومي

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

على سبيل المثال، يبدأ العميل المحادثة حول موضوع "حجز الموعد"، حيث يتم استخدام متغير bot.UserName عمومي. ومع ذلك، bot.UserName يتم تعريف المتغير أولا في موضوع "Welcome".

عندما تأتي المحادثة إلى النقطة في موضوع "حجز الموعد" حيث bot.UserName تتم الإشارة إليها، يقوم الوكيل بالتمحور بسلاسة إلى عقدة السؤال حيث bot.UserName يتم تعريفها لأول مرة.

بعد أن يجيب العميل على السؤال، يستأنف الوكيل موضوع "حجز الموعد".

سلوك المتغير العمومي عند تنفيذ الإجراءات عبر تدفقات Power Automate أو المهارات

في بعض الأحيان، قد تستخدم تدفقاً أو مهارة لتهيئة متغير أو ملئه.

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

في هذه الحالة، تستمر العملية أو الأداء في العمل وتملأ المتغير، مستبدلة كل ما تم تخزينه مسبقًا فيه.

تعيين متغيرات عمومية من مصادر خارجية

تطبيق الويب
كلاسيكي / الفرق

للتأكد من أن العامل يبدأ محادثة مع بعض السياق، يمكنك استخدام متغير عمومي وتعيين قيمته من مصدر خارجي. لنفترض أن موقعك يتطلب من المستخدمين تسجيل الدخول. إذا قمت بتخزين اسم مستخدم في متغير عمومي وتمريره إلى وكيلك، يمكن للعامل الترحيب بالعملاء بالاسم قبل البدء في كتابة سؤالهم الأول. سيناريو آخر مثال هو تمرير السياق من Dynamics 365 Customer Service إلى وكيل حتى يتمكن من بدء المحادثة مع معرفة ما يريد العميل تحقيقه.

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

Note

لا تدعم البرامج التي يتم نشرها إلى قناة الاتصال Dynamics 365 Contact Center لحالات استخدام IVR قيم المهلة المُعدة للمتغيرات العمومية التي يتم تعيينها بواسطة مصادر خارجية.

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

بالنسبة للمتغيرات القادمة من قناة متعددة الاتجاهات لخدمة العملاء، نقترح قيمة 10 ثوان (10000 مللي ثانية) كحد أقصى لوقت الانتظار.
في عقدة Set variable value ، أدخل القيمة الافتراضية لاستخدامها إذا تم الوصول إلى المهلة. في وقت التشغيل، يتوقع وكيلك قيما بنفس نوع البيانات. إذا كنت تريد أن تكون هذه القيمة الافتراضية سلسلة فارغة، فاستخدمها Text("") كصيغة.
لأي قيم أخرى تتوقع أن تأتي من نظام خارجي، أضف المزيد من عقد تعيين قيمة المتغير إلى الموضوع المخصص، وقم بتكوين المتغيرات العمومية المطلوبة بنفس الطريقة.

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

Important

أثناء التدفق العادي للمحادثة، إذا قام وكيلك بتعيين متغير قد يأتي لقيمة خارجية، فستسود القيمة التي تم تعيينها من داخل الوكيل الخاص بك. يتم تجاهل أي قيمة تم تمريرها في السياق. تمنع هذه القاعدة الوكيل من استبدال القيم التي تم تعيينها عمداً في المحادثات.

تعيين المتغيرات العمومية في عامل مضمن

تطبيق الويب
كلاسيكي / الفرق

إذا كنت تقوم بتضمين عاملك في صفحة ويب بسيطة، يمكنك إلحاق المتغيرات وتعريفاتها بعنوان URL الخاص بالعامل. أو، إذا كنت ترغب في مزيد من التحكم، يمكنك استخدام كتلة التعليمات البرمجية <script> لاستدعاء المتغيرات واستخدامها برمجيا.

يجب أن يتطابق اسم المتغير في سلسلة الاستعلام الخاصة بعنوان URL مع اسم المتغير العمومي بدون البادئة Global. . على سبيل المثال، سيشار إلى متغير Global.UserName عمومي كما هو الحال UserName في الاستعلام.

تستخدم الأمثلة التالية إعلانا أساسيا للمتغيرات. في سيناريو الإنتاج، قد تمرر كمعلمة الاستعلام أو تعريف متغير متغيرًا آخر يخزن بالفعل اسم المستخدم (على سبيل المثال، إذا كان لديك اسم المستخدم من برنامج نصي لتسجيل الدخول).

ألحق المتغيرات وتعريفاتها بعنوان URL الخاص بالعامل كمعلمات سلسلة استعلام بالتنسيق botURL?variableName1=variableDefinition1&variableName2=variableDefinition2.

على سبيل المثال:

لديك متغير عمومي يسمى Global.UserName.
عنوان URL الخاص بوكيلك هو https://web.powerva.microsoft.com/webchat/bots/12345.
لتمرير اسم المستخدم عند بدء محادثة عامل على موقع الويب الخاص بك، قم بإرفاق UserName= سلسلة الاستعلام على النحو التالي: https://web.powerva.microsoft.com/webchat/bots/12345?UserName=Ana.

اسم المعلمة غير حساس لحالة الأحرف. username=Ana ستعمل أيضا في هذا المثال.

يمكنك إلحاق المتغيرات وتعريفاتها إذا كنت تقوم ببساطة بتضمين عاملك في صفحة ويب بسيطة، أو يمكنك استخدام كتلة تعليمات برمجية <script> لاستدعاء المتغيرات واستخدامها برمجيا.

Note

يجب أن يتطابق اسم المتغير في سلسلة الاستعلام مع اسم المتغير العمومي، دون البادئة bot. . على سبيل المثال، يجب أن يظهر المتغير bot.UserEmail العمومي ك UserEmail=.

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

أضف المتغيرات وتعريفاتها إلى عنوان URL الخاص بالوكيل كما معلمات سلسلة الاستعلام (بتنسيق botURL?variableName1=variableDefinition1&variableName2=variableDefinition2) على سبيل المثال:
- لديك متغير عمومي يسمى bot.UserEmail.
- عنوان URL الخاص بوكيلك هو https://web.powerva.microsoft.com/webchat/bots/12345.
- لتمرير اسم المستخدم عند بدء محادثة عامل على موقع ويب، يمكنك إرفاق UserEmail= سلسلة الاستعلام على النحو التالي: https://web.powerva.microsoft.com/webchat/bots/12345?UserEmail=Ana@contoso.com.
اسم المعلمة غير حساس لحالة الأحرف. وهذا يعني useremail=Ana@contoso.com أنه سيعمل أيضا في هذا المثال.

إضافة متغيرات عمومية إلى لوحة مخصصة

يمكنك أيضا إضافة المتغير إلى لوحة مخصصة.

تطبيق الويب
كلاسيكي / الفرق

في <script> القسم الموجود في الصفحة حيث توجد الوكيل، قم بتحديد المتغيرات كالتالي: استبدل variableName1 باسم المتغير بدون البادئة Global. واستبدل variableDefinition1 بالتعريف. فصل متغيرات متعددة بفواصل (,).

   const store = WebChat.createStore({}, ({ dispatch }) => next => action => {
     if (action.type === 'DIRECT_LINE/CONNECT_FULFILLED') {
       dispatch({
          type: "WEB_CHAT/SEND_EVENT",
          payload: {
            name: "pvaSetContext",
            value: {
               "variableName1": "variableDefinition1",
               "variableName2": "variableDefinition2"
            }
          },
        });
      }
        return next(action);
    });

في القسم الخاص بك <script>، قم بالاتصال بـ store عند تضمين الوكيل الخاص بك، كما هو موضح في المثال التالي حيث يتم استدعاء store مباشرة قبل استدعاء styleOptions (يجب عليك استبدال BOT_ID بمعرف الوكيل الخاص بك):

const BOT_ID = "12345-5678";
const theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;

fetch(theURL)
    .then(response => response.json())
    .then(conversationInfo => {
        window.WebChat.renderWebChat(
            {
                directLine: window.WebChat.createDirectLine({
                    token: conversationInfo.token,
                }),
                store,
                styleOptions
            },
            document.getElementById('webchat')
        );
    })
    .catch(err => console.error("An error occurred: " + err));

في <script> القسم الموجود في الصفحة حيث يوجد الوكيل، قم بتحديد المتغيرات كالتالي: استبدل variableName1 باسم المتغير بدون البادئة bot. واستبدل variableDefinition1 بالتعريف. فصل متغيرات متعددة بفواصل ,.

   const store = WebChat.createStore({}, ({ dispatch }) => next => action => {
     if (action.type === 'DIRECT_LINE/CONNECT_FULFILLED') {
       dispatch({
          type: "WEB_CHAT/SEND_EVENT",
          payload: {
            name: "pvaSetContext",
            value: {
               "variableName1": "variableDefinition1",
               "variableName2": "variableDefinition2"
            }
          },
        });
      }
        return next(action);
    });

ضمن القسم <script> الخاص بك، قم باستدعاء store عند تضمين الوكيل الخاص بك، كما هو موضح في المثال التالي حيث يتم استدعاء store مباشرة قبل استدعاء styleOptions (يجب استبدال BOT_ID بمعرفك).

const BOT_ID = "12345-5678";
const theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;

fetch(theURL)
    .then(response => response.json())
    .then(conversationInfo => {
        window.WebChat.renderWebChat(
            {
                directLine: window.WebChat.createDirectLine({
                    token: conversationInfo.token,
                }),
                store,
                styleOptions
            },
            document.getElementById('webchat')
        );
    })
    .catch(err => console.error("An error occurred: " + err));

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

الملاحظات

هل كانت هذه الصفحة مفيدة؟

Last updated on 2026-04-22

العمل مع المتغيرات العمومية

إنشاء متغير عمومي

استخدام المتغيرات العمومية

البحث عن جميع الموضوعات باستخدام متغير عمومي

حذف المتغيرات العمومية

دورة حياة المتغيرات العمومية

تعيين متغيرات عمومية من مصادر خارجية

تعيين المتغيرات العمومية في عامل مضمن

إضافة متغيرات عمومية إلى لوحة مخصصة

المتغيرات العمومية المتعلقة بالمصادقة

المحتوى ذو الصلة

الملاحظات

الموارد الإضافية