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

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

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

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

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

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

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

ملحوظة

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ملحوظة

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

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

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

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

مهم

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

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

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

إذا كنت تقوم بتضمين عاملك في صفحة ويب بسيطة، يمكنك إلحاق المتغيرات وتعريفاتها بعنوان 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> لاستدعاء المتغيرات واستخدامها برمجيا.

ملحوظة

يجب أن يتطابق اسم المتغير في سلسلة الاستعلام مع اسم المتغير العمومي، دون البادئة 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-05-15

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

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

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

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

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

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

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

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

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

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

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

الملاحظات

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