استخدام وترحيل مهام سير عمل العامل التعريفي مع Microsoft Foundry Toolkit

استخدم Microsoft Foundry Toolkit تعليمة Visual Studio برمجية للعمل مع مهام سير العمل التعريفية الحالية وإعدادها للترحيل. يمكنك اختبار سير عمل محفوظ وتحرير YAML الذي تم تصديره واستخدام GitHub Copilot للمساعدة في تحويل التعريف إلى التعليمات البرمجية Microsoft Agent Framework.

هام

سير العمل التعريفي في Microsoft Foundry قيد المعاينة ويتقاعد في 1 ديسمبر 2026. استخدم Microsoft Agent Framework لتطوير سير عمل جديد. لا يؤثر هذا الإيقاف على التنسيق المستند إلى التعليمات البرمجية في العوامل المستضافة. راجع دليل ترحيل سير العمل لمسارات الترحيل المدعومة.

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

عرض سير عمل الوكيل التصريحي

ابحث عن سير العمل في قائمة الوكلاء الموحدين لمشروعك.

  1. في طريقة عرض Foundry Toolkit ، ضمن My Resources، تأكد من مشروع Foundry المحدد.
  2. حدد عوامل، ثم حدد علامة التبويب سير العمل .
  3. حدد اسم سير العمل لفتح ملعبه.
  4. استخدم محدد الإصدار لاختيار الإصدار المحفوظ الذي تريد فحصه.

يعرض الملعب الرسم البياني لسير العمل ومنطقة المحادثة. الرسم البياني للقراءة فقط. استخدم YAML المصدر أو مدخل Foundry لتحرير التعريف.

تحرير تعريف سير عمل موجود

قم بتصدير التعريف قبل تحريره أو ترحيله. احتفظ بنسخة من YAML الأصلي بحيث يمكنك مقارنتها بالتغييرات التي أجريتها.

  1. افتح سير العمل الموجود في مدخل Foundry.
  2. في مصمم سير العمل، قم بالتبديل إلى طريقة عرض YAML وانسخ التعريف أو قم بتصديره. للحصول على التفاصيل، راجع تصدير تعريف سير العمل.
  3. احفظ التعريف في مساحة العمل المحلية باسم ينتهي ب .workflow.yaml، مثل support.workflow.yaml.
  4. افتح الملف في تعليمة Visual Studio برمجية وقم بتحرير YAML.
  5. أحفظ الملف. لا تحدث تغييرات الملفات المحلية سير العمل في Foundry.

حفظ إصدار جديد من سير العمل الحالي

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

  1. تأكد من تحديد مشروع سير العمل الأصلي في Foundry Toolkit.
  2. .workflow.yaml عند فتح الملف، حدد Deploy في شريط أدوات المحرر.
  3. في إدخال اسم سير العمل، أدخل اسم سير العمل الموجود.
  4. انتظر إعلام نجاح النشر.
  5. أعد فتح سير العمل من Agents>Workflow وحدد الإصدار الجديد.

يؤدي النشر باستخدام اسم سير عمل موجود إلى إنشاء إصدار جديد. ينشئ اسم مختلف سير عمل منفصلا؛ لا تستخدم هذا المسار لبدء تطوير سير عمل جديد.

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

اختبر الإصدار المحفوظ الذي تخطط للاحتفاظ به أو ترحيله. استخدم نفس الطلبات لاحقا لمقارنة التنفيذ الذي تم ترحيله.

  1. افتح ملعب سير العمل وحدد الإصدار المطلوب.
  2. في علامة التبويب Playground ، حدد New لبدء جلسة ملعب جديدة.
  3. أدخل طلبا يمارس سير العمل وإرساله.
  4. راجع الاستجابة والرسم البياني للتنفيذ. تأكد من تشغيل العوامل والفروع والخطوات المتوقعة.
  5. كرر مع الطلبات التي تمارس فروعا مختلفة ومدخلات مفقودة وأي خطوات موافقة في سير العمل الخاص بك.

يشغل الملعب سير عمل Foundry المحفوظ. لا يقوم بتشغيل تغييرات غير محفوظة في ملف YAML المحلي أو التعليمات البرمجية التي Copilot تنشئها.

تحويل سير عمل YAML إلى كود إطار عمل الوكيل

استخدم إجراء إنشاء التعليمات البرمجية للملعب لمطالبة GitHub Copilot بتحويل تعريف سير العمل المحدد. التعليمات البرمجية التي تم إنشاؤها هي نقطة بداية يجب مراجعتها واختبارها.

  1. في ملعب سير العمل، حدد الإصدار المراد ترحيله.
  2. حدد إنشاء التعليمات البرمجية.
  3. اختر Python أو C#‎.
  4. راجع طلب التحويل في Copilot Chat واتبع مطالباته لإنشاء التعليمات البرمجية.
  5. راجع المشروع الذي تم إنشاؤه والتبعيات واتصالات النموذج والأدوات وتكوين المصادقة.
  6. قارن تنسيقه مع YAML المصدر. تحقق من التفريع والمتغيرات واستدعاءات الوكيل وخطوات الموافقة البشرية.
  7. شغل التعليمات البرمجية محليا واختبرها مع الطلبات التي استخدمتها لسير العمل الأصلي. استخدم "مركز التحكم بالعامل" لفحص التنفيذ.
  8. عندما تتصرف التعليمات البرمجية كما هو مطلوب، اتبع إنشاء وكلاء مستضافين لإعداد مشروع وكيل مستضاف مدعوم ونشره واختبار الإصدار المنشور.

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

للحصول على خيارات الترحيل الأخرى، بما في ذلك YAML التعريفي ل Agent Framework، Azure Logic Apps، واتصالات A2A المباشرة، راجع دليل ترحيل سير العمل.

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

استخدم هذه الدلائل لاختيار الترحيل وإكماله:

  • Last updated on