بناء سير عمل في Microsoft Foundry

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

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

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

• حساب Azure مع اشتراك نشط. إذا لم يكن لديك واحد، أنشئ حساب Azure مجاني مجاني، يشمل اشتراكا تجريبيا مجانيا.
• project في Microsoft Foundry. لمزيد من المعلومات، راجع إنشاء المشاريع.
• Access لإنشاء وتشغيل سير العمل في project Foundry الخاص بك. لمزيد من المعلومات، راجع Azure access control القائم على الأدوار (RBAC) في Foundry.

تحديد متى تستخدم سير العمل

سير العمل مثالي للسيناريوهات التي تحتاج فيها:

• تنسيق عدة عملاء في عملية قابلة للتكرار.
• أضف منطق التفرع (مثل if/else) والتعامل مع المتغيرات دون كتابة كود.
• أنشئ خطوات من نوع Human in-the-loop (مثل الموافقات أو الأسئلة التوضيحية).

إذا كنت ترغب في تحرير سير العمل في YAML باستخدام Visual Studio Code أو تشغيل سير العمل في ساحة عمل محلية، انظر:

• العمل مع سير عمل الوكلاء التصريحي (منخفض الكود) في Visual Studio Code
• العمل مع سير عمل الوكلاء المستضاف (Pro-code) في Visual Studio Code

افهم أنماط سير العمل

توفر Foundry قوالب لأنماط التوزيع الموسيقي الشائعة. ابدأ بسير عمل فارغ أو اختر قالبا:

النمط	وصف	حالة الاستخدام النموذجي
الإنسان في loop	يطرح سؤالا على المستخدم وينتظر مدخلات المستخدم للمتابعة	إنشاء طلبات الموافقة أثناء تنفيذ سير العمل وانتظار موافقة البشر، أو الحصول على معلومات من المستخدم
متسلسله	يمرر النتيجة من وكيل إلى آخر بترتيب محدد	سير العمل خطوة بخطوة، pipelines، أو معالجة متعددة المراحل
دردشة جماعية	يمرر التحكم بين الوكلاء ديناميكيا بناء على السياق أو القواعد	سير العمل الديناميكي، التصعيد، البديل، أو سيناريوهات التسليم الخبير

لمزيد من المعلومات، راجع تنسيقات سير العمل في إطار عمل Microsoft Agent.

إنشاء سير عمل

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

1. تسجيل الدخول إلى Microsoft Foundry. تأكد من تفعيل مفتاح New Foundry . تشير هذه الخطوات إلى Foundry (جديد).

   

2. في القائمة العلوية اليمنى، اختر البناء.

3. اختر إنشاء سير عمل> جديدتسلسلي.

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

5. اختر خيار الحفظ في الوسيط لحفظ التغييرات.

   مهم

   Foundry لا يحفظ سير العمل تلقائيا. اختر الحفظ بعد كل تغيير للحفاظ على عملك.

6. حدد تشغيل سير العمل.

7. تفاعل مع سير العمل في نافذة الدردشة.

8. اختياريا، أضف عقد جديدة إلى سير عملك. القسم التالي في هذا المقال يوفر معلومات عن العقد.

تحقق من سير العمل الخاص بك

بعد اختيار تشغيل سير العمل، تحقق من ذلك:

• تكتمل كل عقدة في العارض.
• ترى الردود المتوقعة في نافذة الدردشة.
• أي متغيرات تحفظها (مثل مخرجات JSON من عقدة وكيل) تحتوي على القيم التي تتوقعها.

إضافة العقد

العقد هي اللبنات الأساسية لسير عملك. كل عقدة تقوم بإجراء محدد بالتسلسل.

تشمل أنواع العقد الشائعة ما يلي:

• الوكيل: استدعاء وكيل.
• المنطق: استخدم إذا/غير، اذهب إلى، أو لكل منهما.
• تحويل البيانات: قم بتعيين متغير أو تحليل قيمة.
• الدردشة الأساسية: أرسل رسالة أو اطرح سؤالا على وكيل.

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

إضافة وكلاء

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

للحصول على خيارات إنشاء وكلاء متقدمة، اذهب إلى تبويب وكيل المسبك في بوابة Foundry.

إضافة وكيل موجود

1. في مرئي سير العمل، اختر علامة الجمع.

2. في القائمة المنسدلة، اختر وكيل Invoke.

3. في نافذة إنشاء وكيل جديد ، اختر الموجود.

4. أدخل اسم الوكيل للبحث عن وكلاء موجودين في project Foundry الخاص بك.

5. حدد الوكيل المطلوب لإضافته إلى سير عملك.

أنشئ وكيل جديد

1. في مرئي سير العمل، اختر علامة الجمع.

2. في القائمة المنسدلة، اختر وكيل Invoke.

3. أدخل اسم الوكيل ووصفا لما يفعله الوكيل.

4. حدد إضافة.

5. في نافذة Invoke a agent ، قم بتكوين الوكيل.

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

تكوين تنسيق استجابة الإخراج

لتكوين وكيل لإعادة مخرجات JSON منظمة:

1. في نافذة تكوين وكيل الاستدعاء ، اختر إنشاء وكيل جديد.

2. قم بتكوين الوكيل لإرسال المخرجات كمخطط JSON:

   1. اختر التفاصيل.
   2. اختر أيقونة المعامل.
   3. لتنسيق النص، اختر مخطط JSON.

   

3. انسخ مخطط JSON المطلوب والصقه في نافذة إضافة تنسيق الاستجابة . تظهر لقطة الشاشة التالية مثالا رياضيا. حَدِّد حِفظ.

   

مهم

لا تدرج الأسرار (كلمات المرور، المفاتيح، الرموز) في مخططات JSON، أو المطالبات، أو متغيرات سير العمل المحفوظة.

{
  "name": "math_response",
  "schema": {
    "type": "object",
    "properties": {
      "steps": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "explanation": {
              "type": "string"
            },
            "output": {
              "type": "string"
            }
          },
          "required": [
            "explanation",
            "output"
          ],
          "additionalProperties": false
        }
      },
      "final_answer": {
        "type": "string"
      }
    },
    "additionalProperties": false,
    "required": [
      "steps",
      "final_answer"
    ]
  },
  "strict": true
}

1. اختر إعدادات الإجراءات. ثم اختر حفظ الإخراج json_object/json_schema ك.

2. اختر إنشاء متغير جديد. اختر اسم متغير، ثم اختر تم.

   

تكوين ميزات إضافية

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

  كل من البصري وYAML قابلان للتحرير. تظهر التغييرات على ملف YAML فورا في الموزع البصري.

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

• ملاحظات: أضف ملاحظات إلى أداة التصور لسير العمل لمزيد من السياق. في الزاوية العلوية اليسرى من العارض، اختر إضافة نغمة.

إنشاء التعبيرات باستخدام Power Fx

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

استخدام المتغيرات في صيغة

لاستخدام متغير في صيغة Power Fx، يجب إضافة بادئة إلى اسمه للإشارة إلى نطاق المتغير:

• بالنسبة لمتغيرات النظام، استخدم System.
• بالنسبة للمتغيرات المحلية، استخدم Local.

إليك متغيرات النظام:

الاسم	وصف
Activity	معلومات عن النشاط الحالي
Bot	معلومات عن الوكيل
Conversation	معلومات عن المحادثة الحالية
Conversation.Id	التعريف الفريد للمحادثة الحالية
Conversation.LocalTimeZone	المنطقة الزمنية للمستخدم، في صيغة قاعدة بيانات المنطقة الزمنية IANA
Conversation.LocalTimeZoneOffset	إزاحة الوقت عن UTC للمنطقة الزمنية المحلية الحالية
Conversation.InTestMode	علم بوليان يمثل إذا كانت المحادثة تحدث على لوحة اختبار
ConversationId	التعريف الفريد للمحادثة الحالية
InternalId	معرف داخلي للنظام
LastMessage	معلومات عن الرسالة السابقة التي أرسلها المستخدم
LastMessage.Id	معرف الرسالة السابقة التي أرسلها المستخدم
LastMessage.Text	الرسالة السابقة التي أرسلها المستخدم
LastMessageId	معرف الرسالة السابقة التي أرسلها المستخدم
LastMessageText	الرسالة السابقة التي أرسلها المستخدم
Recognizer	معلومات حول التعرف على النية والرسالة التي تفعل
User	معلومات عن المستخدم الذي يتحدث حاليا مع الوكيل
User.Language	موقع لغة المستخدم لكل محادثة
UserLanguage	موقع لغة المستخدم لكل محادثة

استخدام القيم الحرفية في صيغة

بالإضافة إلى استخدام المتغيرات في صيغة Power Fx، يمكنك إدخال قيم حرفية. لاستخدام قيمة حرفية في صيغة، يجب إدخالها بالتنسيق الذي يتوافق مع نوعها.

الجدول التالي يسرد أنواع البيانات وتنسيق قيمها الحرفية المقابلة:

النوع	أمثلة على التنسيق
سلسلة‬‬	"hi"، "hello world!"، "copilot"
المنطقي	فقط true أو false
الرقم‬	1, 532, 5.258,-9201
السجل والجدول	[1]، [45, 8, 2]، ["cats", "dogs"]، { id: 1 }، ، { message: "hello" }{ name: "John", info: { age: 25, weight: 175 } }
التاريخ والوقت	Time(5,0,23)، ، Date(2022,5,24)DateTimeValue("May 10, 2022 5:00:00 PM")
الاختيار	غير مدعوم
فارغ	فقط Blank()

صيغ Power Fx الشائعة

الجدول التالي يسرد صيغ Power FX التي يمكنك استخدامها مع كل نوع بيانات.

النوع	صيغ Power Fx
سلسلة‬‬	دالة النص دوال كونكات وكونكتانتات دالة لين الوظائف السفلى والعليا والصحيحة دوال IsMatch وMatch وMatchAll دوال EndsWith وStartsWith إيجاد دالة وظيفة الاستبدال والاستبدال
المنطقي	الدالة البوليانية و، أو، وغير الدوال دوال إذا و يبدوان
الرقم‬	الدوال العشرية، العوامة، والقيم دوال الاستخبارات، الدوران، التقريب، الجمع المستمر، والقطع
السجل والجدول	دوال كونكات وكونكتانتات دوال Count، CountA، CountIf، وCountRows دالة ForAll أولا، دوال FirstN، Index، Last، وLastN وظائف التصفية، والبحث، والبحث دالة JSON دالة ParseJSON
التاريخ والوقت	دوال التاريخ، التاريخ، الوقت، والوقت دوال DateValue وTimeValue وDateTimeValue اليوم، الشهر، السنة، الساعة، الدقيقة، الثانية، وأيام الأسبوع الآن، اليوم، IsToday، UTCNow، UTCToday، IsUTCToday دوال DateAdd وDateDiff وTimeZoneOffset دالة النص
فارغ	دوال Blank، Conalesce، IsBlank، و IsEmpty دوال error، ifError، IsError، IsBlankOrError

قم بتعيين متغير باستخدام Power Fx

يوضح هذا المثال كيفية تخزين وإخراج اسم العميل بحروف كبيرة:

1. قم بإنشاء سير عمل وإضافة عقدة طرح سؤال .

2. في اللوحة التي تظهر، في مربع اسأل سؤالا ، أدخل ما اسمك؟ أو رسالة أخرى. في صندوق حفظ استجابة المستخدم ك "، أدخل اسم متغير؛ على سبيل المثال، Var01. ثم حدد تم.

   

3. أضف إجراء إرسال رسالة . في اللوحة التي تظهر، في منطقة الرسالة للإرسال ، أدخل {Upper(Local.Var01)}. ثم حدد تم.

   

4. حدد معاينة.

5. في لوحة المعاينة، أرسل رسالة إلى الوكيل لاستدعاء سير العمل.

   

إنشاء تدفقات if/else باستخدام Power Fx

يوضح هذا المثال كيفية إضافة تدفق if/else وبناء شرط باستخدام متغيرات النظام.

1. قم بإنشاء سير عمل وإضافة عقدة طرح سؤال .

2. اختر الأيقونة + وأضف تدفق if/else .

3. اكتب System. في مربع الحالة لبناء بيان شرط لكل فرع if/else.

   

4. اختر إجراء تاليا للخطوة التالية في سير العمل.

5. حدد تم. اختر الحفظ لحفظ سير العمل.

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

مشكلة	حل
خيار سير العمل غير مرئي أو لا يمكن إنشاء/تعديل سير العمل	تأكد من أن لديك دور Contributor أو أعلى في project. انظر Azure access control القائم على الأدوار (RBAC) في Foundry.
التغييرات لا تظهر بعد التحرير	اختر الحفظ في المراقب. Foundry لا يحفظ التغييرات تلقائيا.
تشغيل سير العمل ينتج مخرجا غير متوقع	تحقق من أن كل عقدة وكيل لديها وكيل معين لها. تحقق من صحة المخرجات المحفوظة (مخطط JSON).
خطأ في صيغة Power Fx: "الاسم غير صحيح"	أضف بادئة التسكوب الصحيحة. الاستخدام System. للمتغيرات النظامية والمتغيرات Local. المحلية.
خطأ في صيغة Power Fx: "عدم تطابق النوع"	تحقق من أن نوع المتغير يطابق المدخلات المتوقعة. استخدم وظائف التحويل إذا Text()Value() لزم الأمر.
انتهاء وقت سير العمل	قسم سير العمل المعقد إلى أجزاء أصغر. تحقق من استجابة الخدمات الخارجية ضمن الأطر الزمنية المتوقعة.

تنظيف الموارد

لحذف سير عمل لم تعد بحاجة إلى:

1. افتح سير العمل في بوابة Foundry.
2. اختر قائمة الإصدارات المنسدلة على يسار زر الحفظ .
3. اختر خيار الحذف للإصدار الذي تريد إزالته.

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

• الأسئلة الشائعة عن خدمة وكلاء الصاهر
• أفضل ممارسات الأدوات لوكلاء Foundry
• العمل مع سير عمل الوكلاء التصريحي (منخفض الكود) في Visual Studio Code
• العمل مع سير عمل الوكلاء المستضاف (Pro-code) في Visual Studio Code