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