استدعاء تدفق عامل

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

المتطلبات المسبقه

يعتمد هذا المثال على مثال سابق حيث قمت بإنشاء تدفق عامل يجلب توقعات الطقس.

إذا لم تكن قد أنشأت بالفعل تدفق توقعات الطقس، فقم بذلك الآن.

استدعاء تدفق عامل من عامل

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

1. من جزء التنقل الأيمن في Copilot Studio، حدد Agents وحدد العامل الذي تريد إضافة التدفق إليه.

2. انتقل الى جزء الأَدَوات وحدد اضافة أداة.

3. حدد Flow لإظهار قائمة التدفقات المنشورة المتوفرة.

4. حدد Get weather forecast flow الذي أنشأته سابقا.

5. حدد إضافة وتكوين.

   تتم إضافة التدفق إلى العامل الخاص بك، ويظهر في قائمة الأدوات للعامل. يفتح جزء التكوين الخاص بالأداة التي يستخدمها العامل. يمكنك استخدام هذا الجزء لتكوين الأداة للعامل.

6. ضمن الاسموالوصف، أدخل اسم عرض للأداة ووصفا واضحا يساعد منسق العامل على فهم وقت استخدام التدفق. على سبيل المثال، "احصل على توقعات الطقس اليوم في اسم مدينة أو رمز بريدي متوفر."

7. ضمن Inputs، حدد كيفية ملء العامل لقيمة المتغير.

8. ضمن الإكمال، حدد ما تريد أن يفعله العامل بعد انتهاء استخدامه للأداة.

9. عند الانتهاء من التكوين، حدد حفظ.

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

هنا نعرض كيفية استخدام عقدة إجراء في موضوع لاستدعاء التدفق عندما يسأل العميل عن الطقس.

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

2. أنشئ موضوعا جديدا، وقم بتسمائه Get weather.

3. أَضِفِ عِبَارَاتِ الْمُحَرِّكَ التَّالِيَةِ:

   • هل ستمطر
   • توقعات اليوم
   • الاطلاع على حالة الطقس
   • ما هو الطقس

   

4. حدد أيقونة إضافة عقدة أسفل عقدة المشغل، وحدد إرسال رسالة.

5. في عقدة الرسالة ، أدخل يمكنني مساعدتك في ذلك. في مربع النص.

6. حدد أيقونة إضافة عقدة ضمن عقدة الرسالة وحدد طرح سؤال لإضافة عقدة سؤال للجزر الأول من المعلومات لتدفقك، المدينة.

7. في عقدة السؤال :

   1. أدخل السؤال "ما هي مدينتك؟" في مربع النص.
   2. ضمن تحديد، حدد استجابة المستخدم بأكملها.
   3. لاحظ اسم المتغير المقترن بهذه الاستجابة، Var1. يمكنك ترك الاسم كما هو، أو استبداله باسم أكثر معنى مثل "المدينة" (راجع إعادة تسمية متغير، إذا لزم الأمر).

8. تابع بنفس الطريقة لإضافة عقدة سؤال أخرى لقطعة أخرى من المعلومات لتدفقك، الرمز البريدي:

   1. أدخل السؤال "ما هو الرمز البريدي؟" في مربع النص.
   2. ضمن تحديد، حدد رقم.
   3. لاحظ اسم المتغير المقترن بهذه الاستجابة، Var2. يمكنك ترك الاسم كما هو، أو استبداله باسم أكثر معنى (على سبيل المثال، "ZIPcode").

9. حدد أيقونة إضافة عقدة تحت عقدة السؤال للرمز البريدي، ثم اختر إضافة أداة، وبعد ذلك اختر التدفق الذي أنشأته سابقًا، الحصول على توقعات الطقس.

10. اضبط مدخلات التدفق إلى متغيرات الإخراج من عُقَد الأسئلة. تحصل المدينة (سلسلة) على قيمتها من Var1 (أو City إذا قمت بإعادة تسميتها) ويحصل الرمز البريدي (رقم) على قيمته من Var2 (أو ZIPcode إذا قمت بإعادة تسميته).

    

11. ضمن عقدة الإجراء ، أضف عقدة رسالة ، وأدخل رسالة تستخدم معلومات الإخراج من التدفق. على سبيل المثال:

    "توقعات اليوم ل location: day_summary"
    فرصة هطول الأمطار chance_of_rain%
    حيث تُعتبر معلمات الإخراج location و day_summary و chance_of_rain من النظام الخاص بك.

    

12. حَدِّد حِفظ.

إدارة تدفق عامل مستخدم في موضوع

بمجرد أن يكون لديك عقدة إجراء تستدعي التدفق، يمكنك استخدام الخيارات التالية من قائمة العقدة لإدارة التدفق:

• يؤدي الحذف إلى حذف العقدة نهائيا وإزالة التدفق من الموضوع.

• Refresh إعادة تحميل التدفق للحصول على أي تغييرات أجريتها في Power Automate، والتحقق من صحتها في الموضوع. يجب إصلاح أي مشاكل تتعلق بالتدفق قبل أن تتمكن من حفظ الموضوع.

إذا كنت ترغب في تحديد تدفق مختلف أو إنشائه، فاستخدم أيقونة تغيير التدفق التي تظهر عند المرور فوق التدفق في عقدة الإجراء.

اختبار التدفق والموضوع

من الجيد اختبار التدفق والموضوع الذي يستدعيه.

في لوحة اختبار الوكيل، اكتب إحدى عبارات تفعيل الموضوع لبدء محادثة مع الوكيل. أدخل مدينتك والرمز البريدي عندما يطلبها الوكيل. تحقق من أن العامل يرجع توقعات الطقس اليوم لمدينتك وأن الرسالة تبدو بالطريقة التي تتوقعها.

استكشاف أخطاء وكيلك وإصلاحها

اختبر وكيلك دائما عند إجراء تغييرات على الموضوعات والتدفقات، للتأكد من أن كل شيء لا يزال يعمل. إذا واجه العامل مشكلة أثناء محادثة، فإنه يستجيب برسالة خطأ.

ابحث عن معظم المشكلات المتعلقة بالتدفق في مدقق التدفق في علامة تبويب مصمم التدفق . استخدم مدقق الموضوع لتحديد المشكلات على لوحة التأليف.