إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
ملحوظة
تصف هذه المقالة الميزات المستخدمة في الوكلاء أو تدفقات الوكلاء التي تعمل بواسطة الحزام القياسي.
توجد المُتَغَيِّرات على أربعة مستويات أو نطاقات:
- متغيرات الْمَوْضُوعُ التي يمكنك اِسْتِخْدامها فقط فِي الْمَوْضُوعُات التي تقوم بإنشائها. هذا النطاق هو الافتراضي للمتغيرات التي تقوم بإنشائها.
- المُتَغَيِّرات العمومية التي يمكنك اِسْتِخْدامها فِي جميع الْمَوْضُوعُات. يمكنك تغيير نطاق متغير موضوع لجعله متغيرا عموميا.
- متغيرات النِظَامٌ التي ينشئها Copilot Studio تلقائيا لعامل. وهي توفر المزيد من المعلومات السياقية حول المحادثة أو الْمُسْتَخْدِم. وهي متوفرة فِي جميع المواضيع.
- متغيرات البيئة التي تقوم بإنشائها فِي Power Platform. إنها للقراءة فقط في Copilot Studio. فهي تخزن مفاتيح وقيم المعلمات، والتي تعمل بعد ذلك كمدخلات لكائنات التطبيق الأخرى المختلفة، بما فِي ذلك Copilot Studio. عن طريق فصل المعاملات عن الكائنات المستهلكة، يمكنك تغيير القيم داخل نفس البيئة أو عند نقل الحلول إلى بيئات أخرى. البَدِيل هو ترك قيم المعلمَات المضمِنة فِي التعليمَات البرمجية ضمِن المكونَات التي تستخدمهَا.
أنواع المتغيرات
يحتوي كل متغير على نوع أساسي. يحدد النوع القيم التي يمكن أن يحتفظ بها المتغير وعوامل التشغيل التي يمكنك اِسْتِخْدامها عند إنشاء تعبير منطقي معه.
| النوع | وصف |
|---|---|
| السلسلة | تسلسل من الأحرف الْمُسْتَخْدِمة لتمثيل النص |
| قيمة منطقية | قيمة منطقية يمكن أن تكون true فقط أو false |
| الرقم | أي رقم حقيقي |
| جدول | قَائِمَة بالقيم، ولكن يجب أن تكون جميع القيم من نفس النوع |
| السِجل | مجموعة من أزواج الاسم والقيم حيث يمكن أن تكون القيم من أي نوع |
| التاريخ والوقت | تاريخ أو وقت أو يوم من أيام الأسبوع أو شهر نسبة إلى نقطة زمنية |
| خيار | قَائِمَة بقيم السلسلة مَعَ المرادفات المقترنة |
| فارغ | عنصر نائب لـ "لا قيمة" أو "قيمة غير معروفة"؛ تعرّف على المزيد حول Blank في وثائق Power Fx |
يمكنك تعيين نوع متغير فِي المرة الأولى التي تقوم فيها بتعيين قيمة إليه. بعد ذلك، يتم إصلاح النوع ولا يمكنك تعيين قيم من أي نوع آخر. على سبيل المثال، إذا قمت بتعيين قيمة 1 البداية إلى متغير، يمكنك تعيين نوعه إلى رقم. إذا حاولت بعد ذلك تعيين قيمة سلسلة مثل "apples"، فستحصل على خطأ.
عند اختبار عامل، قد يظهر متغير مؤقتا مَعَ النوع غير معروف. لا يحتوي المتغير غير المعروف على قيمة حَتَّى الآن.
يتم تحديد ترتيب المتغيرات من الأعلى إلى الأسفل في لوحة التأليف. ويأخذ العامل فِي الاعتبار العقد الموجودة فِي أعلى لوحة التأليف قبل العقد الموجودة فِي الأسفل.
عندما تنشئ الفروع باستخدام عقد Condition، يقوم Copilot Studio بترتيب الفروع من اليسار إلى اليمين. ينظر الوكيل أولًا في العقد الموجودة في الفرع الواقع في أقصى اليسار قبل العقد الموجودة في الفرع الواقع في أقصى اليمين.
الكيانات
يستخدم Copilot Studio الكيانات لتحديد أنواع معينة من المعلومات من استجابات الْمُسْتَخْدِم. يتم حفظ المعلومات المحددة فِي متغير من النوع المناسب للمعلومات. يسرد الجدول التالي نوع الأساس المتغير المقترن بالكيانات التي تم إنشاؤها مسبقا.
| الكيان | نوع الأساس المتغير |
|---|---|
| خيارات الاختيار المتعدد | خيار |
| استجابة المستخدم بالكامل | السلسلة |
| العمر | الرقم |
| قيمة منطقية | قيمة منطقية |
| المدينة | السلسلة |
| Color | السلسلة |
| Continent | السلسلة |
| البلد أو المنطقة | السلسلة |
| التاريخ والوقت | التاريخ والوقت |
| بريد إلكتروني | السلسلة |
| Event | السلسلة |
| رقم صحيح | رقم صحيح |
| اللغة | السلسلة |
| مال | الرقم |
| الرقم | الرقم |
| ترتيبي | الرقم |
| المؤسسة | السلسلة |
| النسبة المئوية | الرقم |
| اسم الشخص | السلسلة |
| رقم الهاتف | السلسلة |
| نقطة الاهتمام | السلسلة |
| السرعة | الرقم |
| الدولة | السلسلة |
| عنوان الشارع | السلسلة |
| درجة الحرارة | الرقم |
| 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 => غير محدد (خطأ فِي التحقق من الصحة) |
| النص | السلسلة |
| نَعَم/لا | قيمة منطقية |
| مصدر البيانات | السلسلة |
| Secret | السلسلة |
ملحوظة
ترى أخطاء متغيرات البيئة في دردشة الاختبار وعند النشر. ومع ذلك، هذه الأخطاء لا تظهر في قائمة الموضوع لأن متغيرات البيئة ليست متغيرات موضوع.
متغيرات النِظَامٌ
كل وكيل يحتوي على متغيرات نظام مدمجة توفر معلومات إضافية عن المحادثة.
لا يعرض Copilot Studio جميع متغيرات النِظَامٌ. للوصول إلى متغيرات النِظَامٌ المخفية، استخدم صيغة Power Fx.
لاِسْتِخْدام متغيرات النِظَامٌ فِي صيغة Power Fx، أضف System. قبل اسم المتغير. على سبيل المثال، لتضمين متغير User.DisplayName النِظَامٌ فِي صيغة، ارجع إليه باسم System.User.DisplayName.
| الاسم | النوع | تعريف |
|---|---|---|
| نشاط.المرفقات | جدول | مرفقات الملفات التي يوفرها الْمُسْتَخْدِم. |
| النشاط.القناة | اختيار | معرف القناة للمحادثة الحالية. |
| النشاط.بيانات القناة | أي | كائن يحتوي على محتوى خاص بالقناة. |
| Activity.ChannelId | سلسلة نصية | معرف القناة للمحادثة الحالية، كسلسلة. |
| Activity.From.Id | سلسلة نصية | المعرف الفريد الخاص بالقناة للمرسل. |
| Activity.From.Name | سلسلة نصية | الاسم السهل الاستخدام الخاص بالقناة للمرسل. |
| اسم النشاط | سلسلة نصية | اسم الحدث. |
| Activity.Recipient.Id | سلسلة نصية | خاصية النوع للنشاط الوارد. |
| Activity.Recipient.Name | سلسلة نصية | يمثل اسم الْعرض للعامل داخل الْقناة. في سياق القناة الهاتفية، قيمة هذا المتغير هي رقم الهاتف الذي يتم إرفاق الْعامِلُ به. |
| نص.النشاط | سلسلة نصية | أحدث رسالة أرسلها الْمُسْتَخْدِم. |
| نوع النشَاط | اختيار | نوع النشاط. |
| Activity.TypeId | سلسلة نصية | نوع النشاط، كسلسلة. |
| Activity.Value | أي | قيمة غير محددة. |
| معرف_بيئة_الروبوت | سلسلة نصية | معرّف بيئة الْعامِلُ. |
| 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 | اختيار | يستخدم هذا المتغير لتعيين الإعدادات المحلية للغة الْمُسْتَخْدِم لكل محادثة. |
المتغيرات للوكلاء المدعومة بالصوت
المُتَغَيِّرات التالية متاحة فقط للوكلاء الممكَّنين بالصوت. تعرف على المزيد في استخدام متغيرات الصوت.
| الاسم | النوع | تعريف |
|---|---|---|
| Activity.InputDTMFKeys | سلسلة نصية | قيمة مفتاح DTMF الأولية مِنْ الهتفية. |
| النشاط.التعرف على الكلام.الثقة | الرقم | درجة الثقة لفرضية التعرف التلقائي على الكلام هي النتيجة الكاملة 0 إلى 1. |
| Activity.SpeechRecognition.MinimallyFormattedText | سلسلة نصية | نص منسق قليلا لفرضية التعرف التلقائي على الكلام. على سبيل المثال، "خمسمائة دولار" يتم كتابة الكلمات، ولكن يتم تضمين الأحرف الكبيرة الأساسية وعلامات الترقيم. |
| نشاط.نوع_إدخال_المستخدم | اختيار | نوع الْإدخالْ الْأحدث مِنْ مُسْتَخْدِمٌ الْْعامِلُ. يمكن أن تكون الْقيمة إما اختبارا أو كلاما أو DTMF. |
| Conversation.OnlyAllowDTMF | قيمة منطقية | علامة منطقية تحدد ما إذا كان يجب تعيين نظام الرد الصوتي التفاعلي (IVR) إلى وضع DTMF فقط عند وقت التشغيل. |
| Conversation.SipUuiHeaderValue | سلسلة نصية | سلسلة رأس UUI الْمُسْتَخْدِمة لتمرير السياق إلى IVR عند بدء المكالمة. |
متغيرات المصادقة المتكاملة (افتراضي)
تتوفر المُتَغَيِّرات التالية للوكلاء الذين تم تكوينهم للمصادقة مَعَ 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 | سلسلة نصية | الاسم الرَّئِيسِيّ للمستخدم الذي يتحدث حاليًا مَعَ الْعامِلُ. |