إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
توجد المُتَغَيِّرات على أربعة مستويات أو نطاقات:
- متغيرات الْمَوْضُوعُ التي يمكنك اِسْتِخْدامها فقط فِي الْمَوْضُوعُات التي تقوم بإنشائها. هذا النطاق هو الافتراضي للمتغيرات التي تقوم بإنشائها.
- المُتَغَيِّرات العمومية التي يمكنك اِسْتِخْدامها فِي جميع الْمَوْضُوعُات. يمكنك تغيير نطاق متغير موضوع لجعله متغيرا عموميا.
- متغيرات النِظَامٌ التي ينشئها Copilot Studio تلقائيا لعامل. وهي توفر المزيد من المعلومات السياقية حول المحادثة أو الْمُسْتَخْدِم. وهي متوفرة فِي جميع المواضيع.
- متغيرات البيئة التي تقوم بإنشائها فِي Power Platform. إنها للقراءة فقط في Copilot Studio. فهي تخزن مفاتيح وقيم المعلمات، والتي تعمل بعد ذلك كمدخلات لكائنات التطبيق الأخرى المختلفة، بما فِي ذلك Copilot Studio. ويتيح فصل المعلمات عن الكائنات المستهلكة إمكانية تغيير القيم داخل نفس البيئة أو عندما تقوم بترحيل حلول إلى بيئات أخرى. البَدِيل هو ترك قيم المعلمَات المضمِنة فِي التعليمَات البرمجية ضمِن المكونَات التي تستخدمهَا.
أنواع المتغيرات
يحتوي كل متغير على نوع أساسي. يحدد النوع القيم التي يمكن أن يحتفظ بها المتغير وعوامل التشغيل التي يمكنك اِسْتِخْدامها عند إنشاء تعبير منطقي معه.
| النوع | الوَصف |
|---|---|
| الوتر | تسلسل من الأحرف الْمُسْتَخْدِمة لتمثيل النص |
| منطقي | قيمة منطقية يمكن أن تكون true فقط أو false |
| الرقم | أي رقم حقيقي |
| جدول | قَائِمَة بالقيم، ولكن يجب أن تكون جميع القيم من نفس النوع |
| سجل | مجموعة من أزواج الاسم والقيم حيث يمكن أن تكون القيم من أي نوع |
| التاريخ والوقت | تاريخ أو وقت أو يوم من أيام الأسبوع أو شهر نسبة إلى نقطة زمنية |
| خيار | قَائِمَة بقيم السلسلة مَعَ المرادفات المقترنة |
| فراغ | عنصر نائب ل "بلا قيمة" أو "قيمة غير معروفة"؛ لمزيد من المعلومات، راجع Blank فِي وثائق Power Fx |
يمكنك تعيين نوع متغير فِي المرة الأولى التي تقوم فيها بتعيين قيمة إليه. بعد ذلك، يتم إصلاح النوع ولا يمكنك تعيين قيم من أي نوع آخر. على سبيل المثال، إذا قمت بتعيين قيمة 1 البداية إلى متغير، يمكنك تعيين نوعه إلى رقم. إذا حاولت بعد ذلك تعيين قيمة سلسلة مثل "apples"، فستحصل على خطأ.
عند اختبار عامل، قد يظهر متغير مؤقتا مَعَ النوع غير معروف. لا يحتوي المتغير غير المعروف على قيمة حَتَّى الآن.
يتم تحديد ترتيب المُتَغَيِّرات من أعلى إلى أسفل لوحة التأليف. يتم النظر فِي العقد الموجودة فِي أعلى لوحة التأليف قبل العقد فِي الأسفل.
عند إنشاء الفروع باستخدام عقد الشرط، يتم ترتيب الفروع من اليسار إلى اليمين. يتم النظر فِي العقد الموجودة فِي الفرع الموجود فِي أقصى اليسار قبل العقد فِي الفرع الموجود فِي أقصى اليمين.
الكيانات
يستخدم Copilot Studio الكيانات لتحديد أنواع معينة من المعلومات من استجابات الْمُسْتَخْدِم. يتم حفظ المعلومات المحددة فِي متغير من النوع المناسب للمعلومات. يسرد الجدول التالي نوع الأساس المتغير المقترن بالكيانات التي تم إنشاؤها مسبقا.
| الكيَان | نوع الأساس المتغير |
|---|---|
| خيارات الاختيار المتعدد | خيار |
| استجابة المستخدم بالكامل | الوتر |
| العمر | الرقم |
| بولياني | بولياني |
| المدينة | الوتر |
| اللون | الوتر |
| القارة | الوتر |
| البلد أو المنطقة | الوتر |
| التاريخ والوقت | التاريخ والوقت |
| البريد الإلكتروني | الوتر |
| حدث | الوتر |
| عدد صحيح | عدد صحيح |
| اللغة | الوتر |
| مال | الرقم |
| الرقم | الرقم |
| ترتيبي | الرقم |
| المنظمه | الوتر |
| النسبة المئوية | الرقم |
| اسم الشخص | الوتر |
| رقم الهاتف | الوتر |
| نقطة الاهتمام | الوتر |
| السرعة | الرقم |
| الدوله | الوتر |
| عنوان الشارع | الوتر |
| درجة الحرارة | الرقم |
| عنوان URL | الوتر |
| الوزن | الرقم |
| الرمز البريدي | الوتر |
| كيان مخصص | خيار |
متغيرات البيئة
متغيرات البيئة (Environment Variables) هي مفهوم في Power Platform. تتيح متغيرات البيئة سيناريو إدارة دورة حياة التطبيق الأساسية (ALM) لتحريك تطبيق بين Power Platform البيئات. في هذا السيناريو، يبقى التطبيق كما هو تماما باستثناء بعض المراجع الخارجية الرَّئِيسِيّة التي تختلف بين البيئة المصدر والبيئة الوجهة.
استخدم متغيرات البيئة بنفس طريقة اِسْتِخْدام متغيرات الْمَوْضُوعُ والعالمية والنِظَامٌ. أحد الاختلافات الملحوظة هو أن متغيرات البيئة للقراءة فقط فِي Copilot Studio. لا يمكن لمؤلفي الوكلاء تعديل متغيرات البيئة في استوديو Copilot. ومع ذلك، يمكن للمسؤولين تغيير قيمة متغيرات البيئة فِي Power Apps. في Copilot Studio، يمكنك اِسْتِخْدام لوحة المُتَغَيِّرات لمشاهدة معلومات حول متغير بيئة. تحتوي لوحة خصائص المتغير أيضًا على رابط إلى Power Apps، وهي منصة إنشاء وتحرير لمتغيرات البيئة.
يحتوي الإصدار المنشور من عامل يستخدم متغيرات البيئة على القيم التي تم تعيينها لهذه المُتَغَيِّرات عند نشر الْعامِلُ. كلما قام مسؤول بتحديث متغيرات البيئة، يجب إعادة نشر أي عوامل تستخدم هذه المُتَغَيِّرات، حَتَّى تكون التغييرات فعالة فِي وقت التشغيل. ومع ذلك، هناك استثناء واحد: لا تحتاج إلى إعادة نشر عواملك عندما تتغير قيمة متغير بيئة من نوع البيانات السرية . على عكس متغيرات البيئة الأخرى، يتم استرداد المُتَغَيِّرات السرية فِي وقت التشغيل.
يتم تعيين أنواع متغيرات البيئة في Copilot Studio إلى أنواع بيانات Power Apps كما يلي:
| اكتب فِي Copilot Studio | اكتب في Power Apps |
|---|---|
| رقم عشري | الرقم |
| JSON | التعرف على النوع بناءً على القيمة. إذا لم يكن JSON => غير محدد (خطأ فِي التحقق من الصحة) |
| Text | الوتر |
| نَعَم/لا | بولياني |
| مصدر البيانات | الوتر |
| بيانات سرية | الوتر |
ملحوظة
تظهر أخطاء متغير البيئة فِي دردشة الاختبار وعند النشر. ومع ذلك، لا تظهر هذه الأخطاء فِي قَائِمَة الْمَوْضُوعُ لأنها ليست متغيرات موضوع.
متغيرات النِظَامٌ
يأتي كل عامل مَعَ متغيرات النِظَامٌ المضمنة التي توفر معلومات إضافية حول محادثة.
ملحوظة
لمزيد من المعلومات حول متغيرات الْعامِلُ الممكنة للصوت، راجع اِسْتِخْدام المُتَغَيِّرات الصوتية.
لا يعرض Copilot Studio جميع متغيرات النِظَامٌ. للوصول إلى متغيرات النِظَامٌ المخفية، استخدم صيغة Power Fx.
لاِسْتِخْدام متغيرات النِظَامٌ فِي صيغة Power Fx، أضف System. قبل اسم المتغير. على سبيل المثال، لتضمين متغير User.DisplayName النِظَامٌ فِي صيغة، ارجع إليه باسم System.User.DisplayName.
| الاسم | النوع | تعريف |
|---|---|---|
| نشاط.المرفقات | table | مرفقات الملفات التي يوفرها الْمُسْتَخْدِم. |
| النشاط.القناة | اختيار | معرف القناة للمحادثة الحالية. |
| النشاط.بيانات القناة | any | كائن يحتوي على محتوى خاص بالقناة. |
| Activity.ChannelId | سلسلة نصية | معرف القناة للمحادثة الحالية، كسلسلة. |
| Activity.From.Id | سلسلة نصية | المعرف الفريد الخاص بالقناة للمرسل. |
| Activity.From.Name | سلسلة | الاسم السهل الاستخدام الخاص بالقناة للمرسل. |
| اسم النشاط | سلسلة نصية | اسم الحدث. |
| Activity.Recipient.Id | سلسلة نصية | خاصية النوع للنشاط الوارد. |
| Activity.Recipient.Name | سلسلة نصية | يمثل الاسم المعروض للعامل داخل القناة. في سياق القناة الهاتفية، قيمة هذا المتغير هي رقم الهاتف الذي يتم إرفاق الْعامِلُ به. |
| نص.النشاط | سلسلة نصية | أحدث رسالة أرسلها الْمُسْتَخْدِم. |
| نوع النشَاط | اختيار | نوع النشاط. |
| Activity.TypeId | سلسلة نصية | نوع النشاط، كسلسلة. |
| Activity.Value | any | قيمة غير محددة. |
| معرف_بيئة_الروبوت | سلسلة نصية | معرّف بيئة الْعامِلُ. |
| Bot.Id | سلسلة نصية | هوية الْعامِلُ. |
| اسم الروبوت | سلسلة نصية | اسم عاملك. |
| Bot.SchemaName | سلسلة نصية | اسم مخطط الْعامِلُ. |
| Bot.TenantId | سلسلة نصية | معرف المستأجر الخاص بالْعامِلُ. |
| ClientPluginActions | اختيار | مجموعة من إجراءات المكون الإضافي للعميل الديناميكي التي يجب مراعاتها للتنسيق التوليدي. |
| Conversation.Id | سلسلة نصية | المعرّف الفريد للمحادثة الحالية. |
| المحادثة.في_وضع_الاختبار | بولياني | علامة منطقية تمثل ما إذا كانت المحادثة تحدث فِي لوحة الاختبار. |
| Conversation.LocalTimeZone | سلسلة نصية | اسم المنطقة الزمنية التي سيستخدمها الْمُسْتَخْدِم فِي تنسيق قاعدة بيانات المنطقة الزمنية IANA. |
| Conversation.LocalTimeZoneOffset | التاريخ والوقت | الإزاحة الزمنية من التوقيت العالمي المتفق عليه للمنطقة الزمنية المحلية الحالية. |
| رمز الخطأ | سلسلة نصية | رمز الخطأ للخطأ الحالي. رسالة الخطأ الخاصة بالخطأ الحالي. |
| رسالة خطأ | سلسلة نصية | رسالة الخطأ الخاصة بالخطأ الحالي. ملاحظة: يتم دعم هذا المتغير فقط إذا كان المشغل هو On Error. |
| FallbackCount | الرقم | يحسب هذا المتغير الأوقات التي تعذر فيها مطابقة موضوع مَعَ إدخال الْمُسْتَخْدِم. ملاحظة: يتم دعم هذا المتغير فقط إذا كان المشغل هو On Unknown Intent. |
| InactivityTimer.Continue | منطقي | علامة منطقية تمثل ما إذا كان المؤقت بحاجة إلى المتابعة أو لا. ملاحظة: يتم دعم هذا المتغير فقط إذا كان المشغل هو Inactivity. |
| عداد_الزمن_لعدم_النشاط.Count | الرقم | عدد المرات التي تم فيها تشغيل مؤقت OnInactivity بسبب عدم نشاط الْمُسْتَخْدِم بعد الوقت الذي تم تكوينه. ملاحظة: يتم دعم هذا المتغير فقط إذا كان المشغل هو Inactivity. تعرف على المزيد في مشغل عدم النشاط حول تكوين مشغلات عدم النشاط واستخدام هذه المتغيرات. |
| LastMessage.Id | سلسلة نصية | معرف الرسالة السابقة المرسلة من قبل الْمُسْتَخْدِم. |
| نص.الرسالةالأخيرة | سلسلة | الرسالة السابقة التي أرسلها الْمُسْتَخْدِم. |
| Recognizer.ExtractedEntities | اختيار | يمثل الكيانات المستخرجة من رسالة التشغيل. ملاحظة: يتم دعم هذا المتغير فقط إذا كان المشغل هو On Select Intent. |
| Recognizer.IntentOptions | اختيار | يمثل خيارات الهدف عندما تقوم أداة التعرف بإرجاع نتائج غامضة. ملاحظة: يتم دعم هذا المتغير فقط إذا كان المشغل هو On Select Intent. |
| Recognizer.SelectedIntent | اختيار | يمثل الهدف المحدد من أداة التعرف. ملاحظة: يتم دعم هذا المتغير فقط إذا كان المشغل هو On Select Intent. |
| معرف رسالة التنبيه Recognizer | سلسلة | معرف رسالة الْمُسْتَخْدِم التي أدت إلى تشغيل الْمَوْضُوعُ الحالي. |
| Recognizer.TriggeringMessage.Text | سلسلة نصية | رسالة الْمُسْتَخْدِم التي أدت إلى ظهور الْمَوْضُوعُ الحالي. |
| Recognizer.MultipleTopicsMatchedReason | سلسلة | يستخدم لتحديد سبب مطابقة مواضيع متعددة. ملاحظة: يتم دعم هذا المتغير فقط إذا كان المشغل هو On Select Intent. |
| سبب تسجيل الدخول | اختيار | يستخدم لتحديد خيار تسجيل الدخول المطلوب عند تشغيل الْمَوْضُوعُ. ملاحظة: يتم دعم هذا المتغير فقط إذا كان المشغل هو On Sign In. |
| User.Language | اختيار | يستخدم هذا المتغير لتعيين الإعدادات المحلية للغة الْمُسْتَخْدِم لكل محادثة. |
متغيرات المصادقة المتكاملة (افتراضي)
تتوفر المُتَغَيِّرات التالية للوكلاء الذين تم تكوينهم للمصادقة مَعَ Microsoft. يستخدم هذا التكوين مصادقة معرف Microsoft Entra وهو الافتراضي للوكلاء الجدد.
لمزيد من المعلومات، راجع متغيرات المصادقة.
| الاسم | النوع | تعريف |
|---|---|---|
| User.DisplayName | سلسلة نصية | الاسم المعروض للمستخدم الذي يتحدث حاليًا إلى العامل. |
| بريد المستخدم الإلكتروني | سلسلة | عنوان البريد الإلكتروني للمستخدم الذي يتحدث حاليا إلى الْعامِلُ. |
| User.FirstName | سلسلة نصية | الاسم الأول للمستخدم الذي يتحدث حاليًا مَعَ الموظف. |
| User.Id | سلسلة نصية | المعرّف الفريد للمستخدم الذي يتحدث حاليًا مَعَ الْعامِلُ. |
| User.IsLoggedIn | قيمة منطقية | علامة بوليانية تمثل ما إذا كان المستخدم الذي يتحدث حاليًا إلى الوكيل تم التحقق من هويته أم لا. |
| User.LastName | سلسلة نصية | اسم عائلة الْمُسْتَخْدِم الذي يتحدث حاليًا مَعَ الموظف. |
| User.PrincipalName | سلسلة نصية | اسم المستخدم الأساسي للمستخدم الذي يتحدث حاليًا مع الوكيل. |
متغيرات المصادقة اليدوية مَعَ OAuth 2 العام
تتوفر المُتَغَيِّرات التالية للوكلاء الذين تم تكوينهم لاِسْتِخْدام موفر خدمة OAuth 2 العام.
| الاسم | النوع | تعريف |
|---|---|---|
| User.AccessToken | سلسلة نصية | رمز الوصول المميز للمستخدم الذي يقوم بالمصادقة مَعَ الْعامِلُ. |
| User.DisplayName | سلسلة نصية | الاسم المعروض للمستخدم الذي يتحدث حاليًا إلى العامل. |
| User.Id | سلسلة نصية | المعرّف الفريد للمستخدم الذي يتحدث حاليًا مَعَ الْعامِلُ. |
| User.IsLoggedIn | منطقي | علامة بوليانية تمثل ما إذا كان المستخدم الذي يتحدث حاليًا إلى الوكيل تم التحقق من هويته أم لا. |
متغيرات المصادقة اليدوية باِسْتِخْدام معرف Microsoft Entra
تتوفر المُتَغَيِّرات التالية للوكلاء الذين تم تكوينهم لاِسْتِخْدام موفري خدمة Microsoft Entra ID (المعروف سابقا ب Azure Active Directory).
| الاسم | النوع | تعريف |
|---|---|---|
| User.AccessToken | سلسلة نصية | رمز الوصول المميز للمستخدم الذي يقوم بالمصادقة مَعَ الْعامِلُ. |
| User.DisplayName | سلسلة نصية | الاسم المعروض للمستخدم الذي يتحدث حاليًا إلى العامل. |
| بريد المستخدم الإلكتروني | سلسلة نصية | عنوان البريد الإلكتروني للمستخدم الذي يتحدث حاليا إلى الْعامِلُ. |
| User.FirstName | سلسلة نصية | الاسم الأول للمستخدم الذي يتحدث حاليًا مَعَ الموظف. |
| User.Id | سلسلة نصية | المعرّف الفريد للمستخدم الذي يتحدث حاليًا مَعَ الْعامِلُ. |
| User.IsLoggedIn | منطقي | علامة بوليانية تمثل ما إذا كان المستخدم الذي يتحدث حاليًا إلى الوكيل تم التحقق من هويته أم لا. |
| User.LastName | سلسلة نصية | اسم عائلة الْمُسْتَخْدِم الذي يتحدث حاليًا مَعَ الموظف. |
| User.PrincipalName | سلسلة | الاسم الرَّئِيسِيّ للمستخدم الذي يتحدث حاليًا مَعَ الْعامِلُ. |
المتغيرات للوكلاء المدعومة بالصوت
المُتَغَيِّرات التالية متاحة فقط للوكلاء الممكَّنين بالصوت.
ملحوظة
لمزيد من المعلومات حول متغيرات الْعامِلُ الممكنة للصوت، راجع اِسْتِخْدام المُتَغَيِّرات الصوتية.
| الاسم | النوع | تعريف |
|---|---|---|
| Activity.InputDTMFKeys | سلسلة نصية | قيمة مفتاح DTMF الأولية من الهتفية. |
| النشاط.التعرف على الكلام.الثقة | الرقم | درجة الثقة لنتيجة افتراضية استرداد موقع Azure بأكملها، من 0 إلى 1. |
| Activity.SpeechRecognition.MinimallyFormattedText | سلسلة نصية | نص منسق قليلا من نتيجة فرضية استرداد موقع Azure. على سبيل المثال، "خمسمائة دولار" يتم كتابة الكلمات، ولكن يتم تضمين الأحرف الكبيرة الأساسية وعلامات الترقيم. |
| نشاط.نوع_إدخال_المستخدم | اختيار | نوع الْإدخالْ الْأحدث مِنْ مُسْتَخْدِمٌ الْْعامِلُ. يمكن أن تكون الْقيمة إما اختبارا أو كلاما أو DTMF. |
| Conversation.OnlyAllowDTMF | بولياني | علامة منطقية تحدد ما إذا كان يجب تعيين نظام الرد الصوتي التفاعلي (IVR) إلى وضع DTMF فقط عند وقت التشغيل. |
| Conversation.SipUuiHeaderValue | سلسلة نصية | سلسلة رأس UUI الْمُسْتَخْدِمة لتمرير السياق إلى IVR عند بدء المكالمة. |