إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
ملحوظة
الميزات في هذا المقال مدعومة بالحزام القياسي، الذي يستخدم خيارات الفوترة الموضحة في الترخيص للوكلاء المدعومين بالحزام القياسي. تعرّف على كيفية الوصول إلى الميزات القياسية في الوصول إلى الوكلاء القياسيين وتدفقات الوكلاء.
توجد المُتَغَيِّرات على أربعة مستويات أو نطاقات:
- متغيرات الْمَوْضُوعُ التي يمكنك اِسْتِخْدامها فقط فِي الْمَوْضُوعُات التي تقوم بإنشائها. هذا النطاق هو الافتراضي للمتغيرات التي تقوم بإنشائها.
- المُتَغَيِّرات العمومية التي يمكنك اِسْتِخْدامها فِي جميع الْمَوْضُوعُات. يمكنك تغيير نطاق متغير موضوع لجعله متغيرا عموميا.
- متغيرات النِظَامٌ التي ينشئها Copilot Studio تلقائيا لعامل. وهي توفر المزيد من المعلومات السياقية حول المحادثة أو الْمُسْتَخْدِم. وهي متوفرة فِي جميع المواضيع.
- متغيرات البيئة التي تقوم بإنشائها فِي Power Platform. إنها للقراءة فقط فِي Copilot Studio. فهي تخزن مفاتيح وقيم المعلمات، والتي تعمل بعد ذلك كمدخلات لكائنات التطبيق الأخرى المختلفة، بما فِي ذلك Copilot Studio. عن طريق فصل المعاملات عن الكائنات المستهلكة، يمكنك تغيير القيم داخل نفس البيئة أو عند نقل الحلول إلى بيئات أخرى. البَدِيل هو ترك قيم المعلمَات المضمِنة فِي التعليمَات البرمجية ضمِن المكونَات التي تستخدمهَا.
أنواع المتغيرات
يحتوي كل متغير على نوع أساسي. يحدد النوع القيم التي يمكن أن يحتفظ بها المتغير وعوامل التشغيل التي يمكنك اِسْتِخْدامها عند إنشاء تعبير منطقي معه.
| النوع | الوصف |
|---|---|
| سلسلة | تسلسل من الأحرف الْمُسْتَخْدِمة لتمثيل النص |
| المنطقي | قيمة منطقية يمكن أن تكون true فقط أو false |
| الرقم | أي رقم حقيقي |
| الجدول | قَائِمَة بالقيم، ولكن يجب أن تكون جميع القيم من نفس النوع |
| السِجل | مجموعة من أزواج الاسم والقيم حيث يمكن أن تكون القيم من أي نوع |
| التاريخ/الوقت | تاريخ أو وقت أو يوم من أيام الأسبوع أو شهر نسبة إلى نقطة زمنية |
| خيار | قَائِمَة بقيم السلسلة مَعَ المرادفات المقترنة |
| فراغ | عنصر نائب لـ "لا قيمة" أو "قيمة غير معروفة"؛ تعرّف على المزيد حول Blank في وثائق Power Fx |
يمكنك تعيين نوع متغير فِي المرة الأولى التي تقوم فيها بتعيين قيمة إليه. بعد ذلك، يتم إصلاح النوع ولا يمكنك تعيين قيم من أي نوع آخر. على سبيل المثال، إذا قمت بتعيين قيمة 1 البداية إلى متغير، يمكنك تعيين نوعه إلى رقم. إذا حاولت بعد ذلك تعيين قيمة سلسلة مثل "apples"، فستحصل على خطأ.
عند اختبار عامل، قد يظهر متغير مؤقتا مَعَ النوع غير معروف. لا يحتوي المتغير غير المعروف على قيمة حَتَّى الآن.
يتم تحديد ترتيب المتغيرات من الأعلى إلى الأسفل في لوحة التأليف. ينظر الوكيل في العقد الموجودة أعلى مساحة التأليف قبل العقد الموجودة في الأسفل.
عندما تنشئ الفروع باستخدام عقد Condition، يقوم Copilot Studio بترتيب الفروع من اليسار إلى اليمين. ينظر الوكيل أولًا في العقد الموجودة في الفرع الواقع في أقصى اليسار قبل العقد الموجودة في الفرع الواقع في أقصى اليمين.
الكيانات
يستخدم Copilot Studio الكيانات لتحديد أنواع معينة من المعلومات من استجابات الْمُسْتَخْدِم. يتم حفظ المعلومات المحددة فِي متغير من النوع المناسب للمعلومات. يسرد الجدول التالي نوع الأساس المتغير المقترن بالكيانات التي تم إنشاؤها مسبقا.
| الكيان | نوع الأساس المتغير |
|---|---|
| خيارات الاختيار المتعدد | خيار |
| استجابة المستخدم بالكامل | سلسلة |
| العمر | الرقم |
| المنطقي | المنطقي |
| المدينة | سلسلة |
| اللون | سلسلة |
| Continent | سلسلة |
| البلد أو المنطقة | سلسلة |
| التاريخ والوقت | التاريخ/الوقت |
| بريد إلكتروني | سلسلة |
| الحدث | سلسلة |
| عدد صحيح | عدد صحيح |
| اللغة | سلسلة |
| مال | الرقم |
| الرقم | الرقم |
| ترتيبي | الرقم |
| المنظمه | سلسلة |
| النسبة المئوية | الرقم |
| اسم الشخص | سلسلة |
| رقم الهاتف | سلسلة |
| نقطة الاهتمام | سلسلة |
| السرعة | الرقم |
| الولاية | سلسلة |
| عنوان الشارع | سلسلة |
| درجة الحرارة | الرقم |
| 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.
| Name | النوع | تعريف |
|---|---|---|
| نشاط.المرفقات | table | مرفقات الملفات التي يوفرها الْمُسْتَخْدِم. |
| النشاط.القناة | اختيار | معرف القناة للمحادثة الحالية. |
| النشاط.بيانات القناة | أي | كائن يحتوي على محتوى خاص بالقناة. |
| 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 | سلسلة نصية | معرف الرسالة السابقة المرسلة من قبل الْمُسْتَخْدِم. |
| نص.الرسالةالأخيرة | سلسلة نصية | الرسالة السابقة التي أرسلها الْمُسْتَخْدِم. |
| التعرف.الكينات_المستخرجة | اختيار | يمثل الكيانات المستخرجة من رسالة التشغيل. ملاحظة: يتم دعم هذا المتغير فقط إذا كان المشغل هو On Select Intent. |
| Recognizer.IntentOptions | اختيار | يمثل خيارات الهدف عندما تقوم أداة التعرف بإرجاع نتائج غامضة. ملاحظة: يتم دعم هذا المتغير فقط إذا كان المشغل هو On Select Intent. |
| التعرف على.المقصد المحدد | اختيار | يمثل الهدف المحدد من أداة التعرف. ملاحظة: يتم دعم هذا المتغير فقط إذا كان المشغل هو On Select Intent. |
| معرف رسالة التنبيه Recognizer | سلسلة نصية | معرف رسالة الْمُسْتَخْدِم التي أدت إلى تشغيل الْمَوْضُوعُ الحالي. |
| Recognizer.TriggeringMessage.Text | سلسلة نصية | رسالة الْمُسْتَخْدِم التي أدت إلى ظهور الْمَوْضُوعُ الحالي. |
| Recognizer.MultipleTopicsMatchedReason | سلسلة نصية | يستخدم لتحديد سبب مطابقة مواضيع متعددة. ملاحظة: يتم دعم هذا المتغير فقط إذا كان المشغل هو On Select Intent. |
| سبب تسجيل الدخول | اختيار | يستخدم لتحديد خيار تسجيل الدخول المطلوب عند تشغيل الْمَوْضُوعُ. ملاحظة: يتم دعم هذا المتغير فقط إذا كان المشغل هو On Sign In. |
| إعدادات.اللغة | اختيار | يستخدم هذا المتغير لتعيين الإعدادات المحلية للغة الْمُسْتَخْدِم لكل محادثة. |
المتغيرات للوكلاء المدعومة بالصوت
المُتَغَيِّرات التالية متاحة فقط للوكلاء الممكَّنين بالصوت. تعرف على المزيد في استخدام متغيرات الصوت.
| Name | النوع | تعريف |
|---|---|---|
| نشاط .إدخال DTMF المفاتيح | سلسلة نصية | قيمة مفتاح DTMF الخام من الهاتفية. |
| النشاط.التعرف على الكلام.الثقة | الرقم | درجة الثقة لفرضية التعرف التلقائي على الكلام هي النتيجة الكاملة 0 إلى 1. |
| Activity.التعرف على الكلام.MinimallyFormattedText | سلسلة نصية | نص منسق قليلا لفرضية التعرف التلقائي على الكلام. على سبيل المثال، "خمسمائة دولار" يتم كتابة الكلمات، ولكن يتم تضمين الأحرف الكبيرة الأساسية وعلامات الترقيم. |
| نشاط.نوع_إدخال_المستخدم | اختيار | نوع الإدخال الأحدث من مستخدم الوكيل. يمكن أن تكون القيمة إما اختبار أو خطاب أو DTMF. |
| المحادثة.السماح لDTMF فقط | المنطقي | علامة منطقية تحدد ما إذا كان يجب تعيين نظام الرد الصوتي التفاعلي (IVR) إلى وضع DTMF فقط عند وقت التشغيل. |
| Conversation.SipUuiHeaderValue | سلسلة نصية | سلسلة رأس UUI الْمُسْتَخْدِمة لتمرير السياق إلى IVR عند بدء المكالمة. |
متغيرات المصادقة المتكاملة (افتراضي)
تتوفر المُتَغَيِّرات التالية للوكلاء الذين تم تكوينهم للمصادقة مَعَ Microsoft. يستخدم هذا التكوين مصادقة معرف Microsoft Entra وهو الافتراضي للوكلاء الجدد. تعرف على المزيد في متغيرات المصادقة.
| Name | النوع | تعريف |
|---|---|---|
| User.DisplayName | سلسلة نصية | اسم العرض للمستخدم الذي يتحدث حاليا مع الوكيل. |
| بريد المستخدم الإلكتروني | سلسلة نصية | عنوان البريد الإلكتروني للمستخدم الذي يتحدث حاليا إلى الْعامِلُ. |
| User.FirstName | سلسلة نصية | الاسم الأول للمستخدم الذي يتحدث حاليًا مَعَ الموظف. |
| User.Id | سلسلة نصية | المعرّف الفريد للمستخدم الذي يتحدث حاليًا مَعَ الْعامِلُ. |
| User.IsLoggedIn | المنطقي | علامة بوليانية تمثل ما إذا كان المستخدم الذي يتحدث حاليًا إلى الوكيل تم التحقق من هويته أم لا. |
| User.LastName | سلسلة نصية | اسم عائلة الْمُسْتَخْدِم الذي يتحدث حاليًا مَعَ الموظف. |
| User.PrincipalName | سلسلة نصية | اسم المستخدم الأساسي للمستخدم الذي يتحدث حاليًا مع الوكيل. |
متغيرات المصادقة اليدوية مَعَ OAuth 2 العام
تتوفر المُتَغَيِّرات التالية للوكلاء الذين تم تكوينهم لاِسْتِخْدام موفر خدمة OAuth 2 العام.
| Name | النوع | تعريف |
|---|---|---|
| User.AccessToken | سلسلة نصية | رمز الوصول المميز للمستخدم الذي يقوم بالمصادقة مَعَ الْعامِلُ. |
| User.DisplayName | سلسلة نصية | اسم العرض للمستخدم الذي يتحدث حاليا مع الوكيل. |
| User.Id | سلسلة نصية | المعرّف الفريد للمستخدم الذي يتحدث حاليًا مَعَ الْعامِلُ. |
| User.IsLoggedIn | المنطقي | علامة بوليانية تمثل ما إذا كان المستخدم الذي يتحدث حاليًا إلى الوكيل تم التحقق من هويته أم لا. |
متغيرات المصادقة اليدوية باِسْتِخْدام معرف Microsoft Entra
تتوفر المُتَغَيِّرات التالية للوكلاء الذين تم تكوينهم لاِسْتِخْدام موفري خدمة Microsoft Entra ID (المعروف سابقا ب Azure Active Directory).
| Name | النوع | تعريف |
|---|---|---|
| User.AccessToken | سلسلة نصية | رمز الوصول المميز للمستخدم الذي يقوم بالمصادقة مَعَ الْعامِلُ. |
| User.DisplayName | سلسلة نصية | اسم العرض للمستخدم الذي يتحدث حاليا مع الوكيل. |
| بريد المستخدم الإلكتروني | سلسلة نصية | عنوان البريد الإلكتروني للمستخدم الذي يتحدث حاليا إلى الْعامِلُ. |
| User.FirstName | سلسلة نصية | الاسم الأول للمستخدم الذي يتحدث حاليًا مَعَ الموظف. |
| User.Id | سلسلة نصية | المعرّف الفريد للمستخدم الذي يتحدث حاليًا مَعَ الْعامِلُ. |
| User.IsLoggedIn | المنطقي | علامة بوليانية تمثل ما إذا كان المستخدم الذي يتحدث حاليًا إلى الوكيل تم التحقق من هويته أم لا. |
| User.LastName | سلسلة نصية | اسم عائلة الْمُسْتَخْدِم الذي يتحدث حاليًا مَعَ الموظف. |
| User.PrincipalName | سلسلة نصية | الاسم الرَّئِيسِيّ للمستخدم الذي يتحدث حاليًا مَعَ الْعامِلُ. |