استخدم المتغيرات الداخلية والخارجية لنقل المعلومات.

استخدم المتغيرات كمعلمات الإدخال والإخراج لتمرير المعلومات بين تدفقات العاملين وعاملي Copilot Studio.

Important

يمكن لعامل تلقي ما يصل إلى 1 ميغابايت من البيانات فقط من تيار في إجراء واحد. ومع ذلك، لا يوجد حد لعدد المتغيرات أو كمية البيانات التي يمكن للعامل إرسالها.

في هذا المثال، يمكنك إنشاء تدفق مع معلمة إدخال وإعادته إلى عامل كمعلمة إخراج.

المتطلبات الأساسية

• فهم كيفية إنشاء تدفق باستخدام لوحة تأليف Copilot Studio

أنواع الوسائط المدعومة

يدعم عاملو Copilot Studio الأنواع التالية من معلمات الإدخال والإخراج لتدفقات العامل:

• العدد
• سلسلة
• منطقي

أنواع البيانات التالية غير مدعومة:

• كائن
• التاريخ
• Timestamp
• قائمة [سلسلة]
• قائمة [الرقم]
• قائمة [بوليان]
• قائمة [كائن]
• قائمة [تاريخ]
• قائمة [طابع زمني]

إنشاء موضوع وتدفق

1. انتقل إلى صفحة المواضيع لعاملك.

2. قم بإنشاء موضوع جديد يسمى رسالة Echo.

3. أضف عبارة التشغيل echo.

4. أضف عقدة سؤال وأدخل الرسالة "أخبرني شيئا وسأقوله لك مرة أخرى."

5. بالنسبة الهوية، اختر استجَابة المستخدم بَالكَامل.

6. بالنسبة لـ ‏‫حفظ رد المستخدم باسم‬, ، واعد تسمية المتغير إلى userResponse.

   

7. حدد أيقونة إضافة عقدة ضمن عقدة السؤال ، ثم حدد إضافة أداة.

8. في علامة التبويب الإجراءات الأساسية، حدد تدفق عامل جديد. تفتح واجهة مصمم تدفق الوكيل مع قالب أولي لتدفق وكيل يبدأ استدعاؤه بواسطة وكيل. يتضمن التدفق إجراءين: عندما يستدعي عامل التدفق والاستجابة إلى العامل.

9. حدد نشر لحفظ التدفق قبل إجراء أي تغييرات. يظهر إعلام عند إنشاء التدفق بنجاح.

10. حدد الرجوع إلى الوكيل للعودة إلى موضوعك. تتم إضافة عقدة إجراء جديدة إلى الموضوع الخاص بك للتدفق.

11. حدد حفظ لإنهاء إضافة التدفق كأداة إلى عاملك.

تحرير تفاصيل التدفق

1. في عقدة الإجراء مع التدفق، حدد ارتباط عرض تفاصيل التدفق للعودة إلى تدفق العامل.

2. في علامة التبويب نظرة عامة على التدفق، قم بتحرير تفاصيل التدفق، واستبدل الاسم بـ معلمة الصدى. حدد حفظ.

3. ارجع إلى علامة تبويب مصمم.

إضافة معلمة إدخال إلى التدفق

1. حدد مشغل التدفق عندما يستدعي عامل مشغل تدفق التدفق، وحدد إضافة إدخال.

2. حدد نص وأدخل الاسم String_Input.

   

إضافة معلمة إخراج إلى التدفق

1. حدد إجرَاء الاستجابة الاستجَابة إلى العَامل وحدد إضَافَة إخراج.

2. حدد نص وأدخل الاسم String_Output.

   

3. بالنسبة للقيمة، أدخل شرطة مائلة (/) في المربع، ثم حدد إدراج محتوى ديناميكي، وبعد ذلك حدد المتغير String_Input.

4. حدد حفظ مسودة ونشر. يقوم Copilot Studio بإبلاغك عند نشر تدفق الوكيل.

5. حدد الرجوع إلى العامل للعودة إلى محرر موضوع العامل. تتم إضافة تدفق الإجراء الجديد إلى الموضوع.

استدعِ التدفق من الموضوع

1. حدد عقدة الإجراء الجديدة.

2. قم بتعيين معلمة إدخال التدفق إلى متغير الإخراج من عقدة السؤال: String_Input (سلسلة) تستمد قيمتها من المتغير userResponse.

   

3. أضف عقدة الرسالة.

4. حدد ‏‫إدراج متغير‬، ثم حدد String_Output.

   

5. حدد حفظ.

6. اختبر وكيلك.

   

المحتوى ذو الصلة

• نظرة عامة على المتغيرات