· · 3 دقائق قراءة

سير العمل المستدامة في Microsoft Agent Framework: من الذاكرة إلى Azure Functions

يدعم نموذج برمجة سير العمل في MAF الآن التنفيذ المستدام المدعوم بـ Durable Task — إليك كيفية بناء سير عمل وكلاء قابلة للتركيب تصمد أمام إعادة تشغيل العمليات وتتوسع عبر Azure Functions.

Agent Framework .NET Azure Functions Durable Task AI Workflows
هذا المقال متاح أيضاً بـ:English, Español, Català, Deutsch, Français, Português, Italiano, 日本語, 中文, 한국어, Русский, हिन्दी, Polski, Türkçe, Bahasa Indonesia, Nederlands

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

يدعم نموذج برمجة سير العمل في Microsoft Agent Framework الآن التنفيذ المستدام، المدعوم بإطار Durable Task، مع استضافة Azure Functions. إليك كيفية عمل نموذج البرمجة ولماذا تهم قصة الاستدامة.

العناصر الأساسية

Executor هي الوحدة الأساسية للعمل. كل واحد مكتوب بالنوع — يأخذ مدخلاً محدداً وينتج مخرجاً محدداً:

using Microsoft.Agents.AI.Workflows;

internal sealed class OrderLookup()
    : Executor<OrderCancelRequest, Order>("OrderLookup")
{
    public override async ValueTask<Order> HandleAsync(
        OrderCancelRequest message,
        IWorkflowContext context,
        CancellationToken cancellationToken = default)
    {
        // البحث عن الطلب، إعادته
        return new Order(Id: message.OrderId, ...);
    }
}

سير العمل تربط المنفذين في رسوم بيانية موجهة باستخدام منشئ fluent. يتولى الإطار التنفيذ وتدفق البيانات بين الخطوات ونشر الأخطاء.

يمكنك نمذجة:

  • سلاسل متسلسلة (خطوة A → خطوة B → خطوة C)
  • Fan-out/fan-in متوازي (تشغيل الوكلاء A، B، C بالتوازي، تجميع النتائج)
  • التفريع الشرطي
  • موافقات الإنسان في الحلقة (إيقاف سير العمل مؤقتاً، انتظار إشارة خارجية)

منفذ In-Memory للتطوير المحلي

البدء سريع:

dotnet add package Microsoft.Agents.AI
dotnet add package Microsoft.Agents.AI.Workflows

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

إضافة الاستدامة مع Durable Task

عندما يحتاج سير العمل إلى الصمود أمام إعادة تشغيل العملية — لأنه طويل الأمد، لأن له خطوات إنسان في الحلقة، لأنه يتوزع على استدعاءات وكلاء متوازية عديدة — فإن منفذ In-Memory لا يكفي.

يخزن تكامل Durable Task في MAF حالة سير العمل في Azure Storage. إذا أعيد تشغيل العملية، يستأنف سير العمل من حيث توقف. يظل نموذج البرمجة كما هو؛ تقوم فقط باستبدال المنفذ.

dotnet add package Microsoft.Agents.AI.Workflows.DurableTask

نفس المنفذين، نفس رسم بياني سير العمل — مدعوم بحالة مستدامة.

استضافة Azure Functions

الطبقة الثالثة هي استضافة Azure Functions. يصبح سير العمل تطبيق Function: قم بتشغيل سير العمل عبر نقطة نهاية HTTP، ويتولى وقت التشغيل المستدام التوسع والحالة والموثوقية.

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

لماذا هذا مهم

التوليفة مهمة لأنظمة الذكاء الاصطناعي الحقيقية:

  • استدعاءات وكلاء متوازية — التوزيع على وكلاء متخصصين متعددين في وقت واحد دون تعطل، تجميع النتائج عند اكتمال الجميع
  • العمليات طويلة الأمد — يمكن لسير العمل التي تتضمن موافقة بشرية أو أحداثاً خارجية الإيقاف المؤقت والاستئناف عبر ساعات أو أيام
  • التوسع — يتوسع Azure Functions التنفيذ أفقياً؛ يدير إطار Durable Task تنسيق الحالة المتوازية

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

المنشور الأصلي: Durable Workflows in the Microsoft Agent Framework

شارك:
عرض الكود المصدري لهذا المقال على GitHub ↗
← وكيل MAF المحلي الخاص بك وجد الآن موطناً في الإنتاج
نمط Handoff: عندما لا يكفي وكيل واحد →