العمل مع المتغيرات في عامل Copilot Studio الخاص بك

مكتمل

يسمح لك Microsoft Copilot Studio بتخزين المعلومات المهمة التي أدخلها العميل لاستخدامها لاحقاً باستخدام المتغيرات. علي سبيل المثَال، يمكنك حفظ اسم عميل فِي متغير يسمي varName. يمكن إدرَاج هَذا المتغير فِي عقد المحَادثة لإنشَاء تجربة عميل شخصية مخصصة بشكل أكبر، مثل إدرَاجه فِي عقدة الرسَالة، للسمَاح للعَامل بمخَاطبة العميل بالاسم مع استمرَار المحَادثة.

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

ترتبط العديد مِن أنواع المُتغيرَات بالكيَانَات الجَاهزة والمُخصَّصة المحدّدة فِي العَامل. للرجوع إليها، تتوفر قائمة كاملة من أنواع المتغيرات .

إنشَاء متغيرَات

يتمُّ إنشَاء المُتغيِّرَات تلقَائيًّا عِند إضَافَة عُقدة سؤالٍ إلى مَوضوع ويُمكن تحريرهَا ضِمِن قِسم حفظ ردّ المُستخدِم باسم. عند إدرَاج عقدة سؤال بشكل افترَاضي، يتم إنشَاؤهَا باستِخدَام خيَارَات الاختيَار مِن متعدد. ومع هَذَا، يمكن استخدَام أي كيَان تم إنشَاؤه مسبقًا أو كيَانًا مخصصًا مِن خلال تَحديده ضمِن التعريف.

إعادة تسمية متغير

عندمَا يتمُّ إنشَاء مُتغيرٍ تلقَائيًّا، يتمُّ إعطَاؤه اسمًا افترَاضيًّا مِثل Var1 وVar2 ومَا إلى هَذَا، وهُو غَير وَصفِي. ويمكنُك إعَادة تسمية متغير عن طريق تحديده ثم إدخَال اسم جَديد إذا رغبت فِي هَذَا فِي جزء خصَائص المتغير. هَذا يجعل مِن السهل التعرَّف عليه لاحقًا عند الحَاجة.

تمرير المتغيرات بين المواضيع

أحد الإجراءات الشائعة في عامل Microsoft Copilot Studio هو إعادة التوجيه من موضوع إلى آخر مثل إرسال شخص ما إلى موضوع Store Hours بعد الترحيب به. يمكنك تمرير القيم إلى متغيرَات فِي الموضوع الوجهة عند إعَادة التوجيه إلى موضوع آخر. يمكنك أيضًا إعَادة القيم إلى المُتغيرَات فِي الموضوع الأصلي.

عندما يكون لديك بالفعل معلومات يحتاجها الموضوع، يعد تمرير المتغيرات بين الموضوعات مفيداً بشكل خاص. سيقدر المستخدمون عدم الاضطرَار إلى الإجَابة عَلى الأسئلة مرة أخرى. عَلى سَبيل المِثَال، إذا قمتَ بالفِعل بتَسجِيل اسمِ المُستَخدِم فِي مَوضُوع Greeting، وكنتَ تَعلمُ أنَّ اسمَ المُستخدِم مُستَخدَمٌ فِي موضوع Store Hours الذي تعيدُ التَوجِيه إليه، فيمكنُك بسهولةٍ تَمرير اسمِ المُستَخدِم إلى موضوعِ Store Hours عِند إعَادةِ التَوجيهِ إلى المَوضُوع.

تلقي القيم من مواضيع أخرى

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

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

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

لمزيد من المعلومات والإرشادات خطوة بخطوة حول تلقي القيم من مواضيع أخرى، راجع تلقي قيم من مواضيع أخرى.

إرجاع القيم إلى الموضوعات الأصلية

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

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

لمَزيدٍ مِن المعلومَات والإرشَادَات خطوة بخطوة، رَاجع إرجَاع القيم إلى المواضيع الأصلية.

لمعرفة المزيد حول العمل مع المتغيرات، راجع العمل مع المتغيرات.

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

افترَاضيًا، لا يمكن استخدَام قيمة المتغير إلا فِي الموضوع الذي يتم فِيه إنشَاء المتغير. عَلى سَبِيل المِثَال، إذا قمت بإنشَاء UserCity متغير فِي موضوع Check Weather، فستتَمكن فقط مِن إدرَاجه فِي عنَاصر مثل عُقد الرسَائل ضمِن موضوع "التحقق مِن الطقس". يشار إليها باسم المتغيرات على مستوى الموضوع . ومع هَذَا، قد تكون هنَاك سينَاريوهَات عندمَا تريد استخدَام نفس القيمة عبر مواضيع متعددة. يمكن للعَاملين أن تتذكر السيَاق المتغير عندمَا تمتدُ المحَادثة عبر عدة مواضيع.

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

في Microsoft Copilot Studio، يشار إلى هذه المتغيرات باسم Global المتغيرات. يمكن الوصول إليهَا عن طريق أي موضوع فِي العَامل.

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

تعريف متغير عمومي

لتَعريفِ مُتغيِّر عَلى أنَّه عُمُومي، حدّد المٌتغير مباشرةً مِن عُقدةٍ أو فِي قَائمةِ المُتغيِّرَات دَاخِل شَريطِ القَائمَة العُلوي. عَادةً مَا تنتقلُ إلى عُقدَة السُؤالِ التي تشيرُ أولاً إلى المُتغيِّر الذي تريدُ العَمل مَعه.

فِي جزءِ خصَائص المتغير، الموجود ضمِن الاستخدَام، حدّد Global (يمكنُ الوصولُ إِلى أيِّ موضوع).

‏‫ملاحظة‬

يتم إعطَاء اسم المتغير سلسلة بَادئة مِن عمومي لتمييزه عن المُتغيرَات عَلى مستوى الموضوع.

عَلى سَبِيل المِثَال، يتم عرض المتغير UserName الآن عَلى أنه Global.UserName. عند تحويل موضوع إلى متغير عمومي، تأكد مِن أن اسم المتغير فريد فِي جميع الموضوعَات. تحتَاج إلى إعَادة تسمية المتغير قبل حفظ التغيير فِي حَالة مصَادفة تعَارض فِي الاسم.

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

بمجرد إنشَاء متغير عمومي، يكون المتغير متَاحًا لجميع الموضوعَات. أثناء العمل مع عقدة رسالة أو سؤال، حدد الزر {x} وانتقل إلى علامة التبويب مخصص . يعرض هذا قائمة بجميع المتغيرات المتوفرة في الموضوع الحالي. يتمُّ فَرز المٌتغيِّرَات بالتَرتِيب الأبجَدِي وتَجمِيعهَا حَسب نوع الخَاص بهَا الاستخدَام الخَاص بهَا، مثل Global وTopic.

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

إدَارة المتغيرَات العمومية

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

يوفِّرُ قسمُ المرَاجع خيَارَين رَئيسيَّين:

• المَرجع: إظهَار مكَان تَعريفِ المُتغيِّر حَاليًا.

• عَرض كُلِّ المرَاجِع: يسردُ جَميع المواضِيعِ والعُقد حيث يتمُّ استِخدَام المُتغيِّر، مَا يسمحُ لك بالانتقَال مُباشرةً إلى كل مَوضُوعٍ وعُقدةٍ مرجعيةٍ.

  

قم بتعيين قيمة متغير عمومي مِن مصَادر خَارجية

يمكنك تعيين متغير عمومي ليتم تهيئته بمصدر خَارجي. يتيح هَذا لعَامل بدء المحَادثة ببعض السيَاق.

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

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

لمزيد من المعلومات حول العمل مع المتغيرات العمومية، راجع العمل مع المتغيرات العمومية.

بعد ذلك، سنلقي نظرة على موضوعات النظام.