تحرير تدفق العامل أو سير العمل وإدارته في المصمم

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

Important

تحتوي هذه المقالة على وثائق إصدار أولي Microsoft Copilot Studio وهي عرضة للتغيير.

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

إذا كنت تقوم بإنشاء عامل جاهز للإنتاج، فشاهد نظرة عامة على Microsoft Copilot Studio.

لعرض تدفق عامل أو سير عمل في المصمم، افتح Copilot Studio، وحدد Flows، وحدد التدفق، ثم حدد علامة التبويب Build.

لقطة شاشة لمصمم Copilot Studio تعرض سير عمل منشورًا مع مشغل وعدة إجراءات.

تعديل كيفية عرض التدفق

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

لقطة شاشة لشريط الْأدوات الْخاص بخيارات الْعرض فِي مصمم Copilot Studio، مع وسائل شرح مرقمة مِنْ 1 إلى 6.

دليل الرموز

  1. الْتَكبِير: تَكبِير حَجمِ سير العمل عَلى الْلوحَة.
  2. التَصغِير: تَصغير حَجمِ سير العمل عَلى اللوحَة.
  3. احتواء طريقة العرض: قم بتغيير حجم طريقة العرض لتناسب سير العمل بأكمله على اللوحة.
  4. ترتيب: أعد ترتيب سير العمل والفروع للحصول على نظرة شاملة أوضح وأكثر تنظيماً.
  5. التخطيط العمودي: قم بالتبديل إلى طريقة عرض تخطيط عمودي لسير العمل.

‏إضَافَة إجرَاءَاتٍ وإزَالتهَا

  1. في البطاقة التي تريد إضافة الإجراء بعدها، حدد إضافة خطوة. يتم فتح جزء Add .

  2. ضمن إضافة، ابدأ بكتابة الإجراء الذي تريد أن ينفذه التدفق أو الموصل الذي تريد إضافته، ثم حدده من القائمة. بِنَاءً عَلى اختيَارِك، قد تَحتَاجُ إلى تقديمِ معلومَاتٍ إضَافيّةٍ لإكمَالِ الإجرَاءِ.

إذا حددت عدم الحاجة إلى إجراء، فحدد أيقونة حذف في الزاوية العلوية اليسرى من الإجراء.

تحقّق مِن مُعلّمَات الْتدفّق

لعَرضِ الْمُعلمَات الْخَاصة بمُشغّلٍ أو إجرَاءٍ فِي سير العمل، حدّد الْبطَاقة الْخَاصَة به. تفتح لوحة التكوين على الجانب الأيمن. لإدخال قيمة لمعامِل، اختر خيارًا من قائمة الخيارات أو أدخل معادلة لتعيين القيمة تلقائيًا.

عرض سجل الإصدارات لتدفقات العميل

يتم تسجيل محفوظات الإصدار في Microsoft Dataverse أثناء إنشاء تدفق عامل أو تعديله. لفهم كيفية تطور تدفق العامل، راجع محفوظات الإصدارات الخاصة به. يتم تجميع إصدارات التدفقات حسب التاريخ، مع مؤشرات تشير إلى أحدث إصدار، والمُصدر، والمُصدرة في الماضي.

يستند سجل التدفق إلى الإصدارات المحفوظة، لذلك من الجيد حفظ المسودات قبل اكتمال التدفق.

لاستخدام لوحة محفوظات الإصدار، يجب حفظ تدفق العامل مرة واحدة على الأقل.

  1. في القائمة الموجودة أعلى اللوحة، حدد محفوظات الإصدارات.

  2. لعرض الإصدارات المسجلة من التدفق، قم بتوسيع عنصر في القائمة.

  3. لعرض الإصدار في المصمم، حدده في القائمة.

افحص الأخطاء

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

Important

لا يمكنك نشر تدفق إذا كان يحتوي على أخطاء. يجب تصحيح جميع الأخطاء قبل أن تتمكن من نشر التدفق الخاص بك.

نشر سير العمل

إذا لم يكن لسير العمل أخطاء، يمكنك نشره. لنشرِ التدفّق الخَاص بك، فِي القَائمَة أعَلى اللوحَة، حدّد نَشر.

اختبار تدفق العامل أو سير العمل

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

هناك طريقتان لتشغيل اختبار:

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

يشترك كلا السطحين في نفس الفكرة: توفير مدخلات (حقيقية أو وهمية)، وتشغيل، ثم فحص الإخراج.

اختبار عقدة واحدة في عملية سير العمل

افتح أي إجراء أو عقدة في سير العمل الخاص بك وحدد زر التشغيل أو الاختبار. هناك ثلاثة أقسام:

  1. تشغيل / إعادة تعيين الاختبار: تشغيل الخطوة عند الطلب، أو مسح المدخلات والمخرجات الحالية.

    لقطة شاشة للوحة اختبار العقدة تعرض أقسام الإدخالات والتكوين والإخراج مع تمييز زر الاختبار.

  2. تحميل القيم من التشغيل السابق: قائمة منسدلة من عمليات التشغيل الأخيرة لهذا التدفق. يؤدي اختيار واحد إلى جلب مخرجات الخطوة الأولية من التشغيل إلى حقول الإدخال أدناه.

  3. المدخلات: حقل واحد قابل للتحرير لكل خطوة مصدر إخراج مراجع العقدة. يعرض الرمز الموجود على يمين كل صف نوع البيانات المتوقع للحقل (نص، بريد إلكتروني، تاريخ ووقت، رقم، إلخ).

  4. الإخراج: النتيجة المباشرة لأحدث اختبار، منسقة لنوع العقدة (JSON، نتيجة المطالبة، استجابة الموصل، وما إلى ذلك).

المدخلات الوهمية

تكون حقول الإدخال فارغة بشكل افتراضي. يمكنك:

  • اكتب أي قيمة مباشرة في حقل. يقبل الحقل النوع المبيّن على الشارة اليمنى.
  • اترك حقلا فارغا إذا لم تعتمد خطوتك عليه.

لقطة شاشة للوحة اختبار العقدة تعرض حقول إدخال فارغة مع شارات النوع على اليمين.

Tip

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

تحميل القيم من تشغيل سابق

لقطة شاشة لقيم التحميل من القائمة المنسدلة السابقة التي تعرض عمليات التشغيل السابقة مع تسميات التاريخ والوقت والحالة.

إذا كان التدفق الخاص بك يعمل من قبل، يمكنك إعادة تشغيل البيانات الحقيقية بدلا من كتابتها في:

  1. في القائمة المنسدلة تحميل القيم من التشغيل السابق اختر تشغيل. يتم تسمية كل إدخال بتاريخ/وقت التشغيل وحالته (على سبيل المثال، 24 أبريل، 09:12 — ناجح).

  2. يجلب المصمم مخرجات الخطوة الخاصة بتلك الدورة ويعرضها من خلال مخطط الإدخال الخاص بعقدتك. تتم كتابة القيم المطابقة في حقول الإدخال.

  3. قم بتحرير أي حقل بعد ذلك إذا كنت تريد تعديل السيناريو.

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

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

قم بتشغيل الاختبار

حدد تشغيل الاختبار. يظهر الزر حالة مشغول أثناء إرسال المكالمة؛ يعرض القسم "إخراج" مؤشر تحميل، ثم النتيجة أو خطأ.

  • يقوم اختبار إعادة التعيين بمسح كل من المدخلات والإخراج الأخير.
  • يقوم الاختبار بتشغيل العقدة بمعزل عن واجهة برمجة تطبيقات الموصل. لا يؤدي الاختبار إلى تشغيل بقية التدفق.

اختبار التدفق بأكمله

في شريط الأوامر العلوي، حدد زر التشغيل (اختبار). يقوم الاختبار بتشغيل العملية الشاملة مقابل بيئة التشغيل الفعلية.

قبل بدء التشغيل، المصمم:

  1. يحفظ التدفق وينشره إذا كانت لديك تغييرات غير محفوظة (أو إذا كانت هذه هي المرة الأولى).
  2. تثبيت أي اتصالات جديدة عند التشغيل الأول.
  3. يُشغل العملية. يعتمد المسار على نوع المشغل الخاص بك.
نوع المشغل ماذا يحدث عند تحديد الاختبار
طلب يدوي / HTTP يفتح مربع حوار لإدخال مدخلات المشغل، ثم يتم تشغيل التدفق على الفور.
تكرار/نافذة متحركة/استقصاء إما أن يبدأ الجدول الزمني ويبدأ التشغيل الأول تلقائيا، أو إذا كان مثبتا بالفعل، يتم تشغيل التدفق مرة واحدة.
حدث الموصل (على سبيل المثال، عند وصول بريد إلكتروني) يتم نشر التدفق وينتظر. يمكنك أن ترى Waiting for trigger.... قم بتنفيذ الإجراء في النظام المصدر لبدء العملية.
خطاف ويب HTTP يتم نشر التدفق؛ قم بتشغيله من النظام الخارجي كما تفعل عادة.

المدخلات الوهمية (مشغل يدوي)

بالنسبة إلى المشغلات اليدوية، يعرض مربع الحوار إدخال مدخلات المشغل اليدوي حقلا واحدا لكل إدخال قمت بتعريفه على المشغل:

  • النص/الرقم/البريد الإلكتروني/التاريخ: عنصر تحكم الإدخال المناسب.
  • منطقي: مفتاح التبديل.
  • خيار واحد (قائمة تعداد): القائمة المنسدلة.
  • تحديد متعدد: قائمة منسدلة متعددة التحديد.
  • الملف: أداة انتقاء الملفات (يتم تحميل المحتويات كجزء من التشغيل).
  • Object/array: منطقة نص متعددة الأسطر حيث يمكنك لصق JSON.

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

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

عرض عملية التشغيل

بمجرد أن يتم التشغيل:

  • يعرض شريط الأوامر زر إلغاء بينما يكون التشغيل نشطا.
  • تسرد لوحة النشاط (الجانب الأيمن) التشغيل الحالي في الأعلى مع شارة الحالة: قيد التشغيل أو قيد الانتظار أو نجح أو فشل أو تم إلغاؤه. حدد أي تشغيل لفتحه على اللوحة وفحص مدخلات كل خطوة ومخرجاتها.

تحديد جولات سابقة

تعمل لوحة النشاط أيضًا كتاريخ تشغيل التدفق الخاص بك.

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

متى تستخدم كل نوع من أنواع الاختبارات

  • التكرار على خطوة ذكاء الاصطناعي واحدة أو إجراء موصل؟: اختبر هذه العقدة. إنه أسرع، ولا ينشر، ويسمح لك بالسخرية من القيم الأولية التي تهمك فقط.
  • التحقق من صحة السلوك من طرف إلى طرف أو منطق المشغل؟: تشغيل اختبار التدفق. إنه يمارس الرسم البياني بأكمله مقابل وقت التشغيل الحقيقي.
  • إعادة إنتاج مشكلة إنتاج؟: افتح التشغيل الفاشل من لوحة النشاط، ثم افتح العقدة الفاشلة واستخدم تحميل القيم من التشغيل السابق في علامة التبويب "اختبار" الخاصة به لإعادة تشغيل البيانات المصدر الدقيقة في الإجراء.