تدفقات عمل Claude Code الديناميكية: تشغيل مئات من الوكلاء الفرعيين المتوازيين مع Opus 4.8

تم شحن Claude Opus 4.8 بميزة رئيسية لـ Claude Code: سير العمل الديناميكي (Dynamic Workflows). في جلسة واحدة، يمكن لوكيل تنسيق إنشاء المئات من الوكلاء الفرعيين المتوازيين لمعالجة مهمة كبيرة ومتشعبة: إعادة هيكلة عشرات الملفات، تشغيل مصفوفة اختبار واسعة، أو استكشاف مسارات حلول متعددة في وقت واحد. يبدو الأمر وكأنه سحر في الطرفية. وتحت الغطاء، إنهما قطعتان ملموستان تعملان معًا.

يستعرض هذا الدليل كيفية عمل سير العمل الديناميكي فعليًا، ومتى يجب اللجوء إليها، وكيفية بناء نمط التنسيق نفسه عبر واجهة برمجة التطبيقات الخام. للاطلاع على النموذج نفسه، راجع ما هو Claude Opus 4.8. للاطلاع على خلفية بنية الوكيل، فإن تحليل بنية أداة وكيل Claude Code هو القراءة المصاحبة.

ما هي سير العمل الديناميكي فعلاً

في Claude Code، تظهر سير العمل الديناميكي كوضع يسمى "ultracode" في قائمة الجهد. هذا هو الجزء الذي يستحق الفهم: ultracode ليس مستوى جهد جديد لواجهة برمجة التطبيقات. إنه مزيج من شيئين موجودين بالفعل في Opus 4.8:

1. مستوى الجهد xhigh
2. رسائل النظام في منتصف المحادثة

عند تجميعهما معًا، يمنح ذلك وكيل التنسيق عمق التفكير لتخطيط مهمة كبيرة، والإذن الدائم لإطلاق وكلاء عمل مع تطور المهمة. هذه هي الحيلة بأكملها. كل شيء آخر هو ربط (wiring) خاص بـ Claude Code.

المكون 1: جهد xhigh

يتحكم مُعامل effort في عدد الرموز التي ينفقها Opus 4.8 عبر الاستجابة، بما في ذلك استدعاءات الأدوات. xhigh هو المستوى الذي توصي به Anthropic للبرمجة طويلة المدى والعمل الوكيل؛ وهو مُعد للتشغيل الذي يتجاوز 30 دقيقة بميزانيات رموز تصل إلى الملايين.

بالنسبة لسير العمل الديناميكي، يهم هذا العمق لأن المنسق يجب أن يقوم بتخطيط حقيقي: تقسيم المهمة إلى وحدات مستقلة، وتحديد عدد العمال الذين سيتم إنشاؤهم، ودمج نتائجهم. مستويات الجهد المنخفضة تقلل من نطاق العمل وتجري عددًا أقل من استدعاءات الأدوات، وهو عكس ما يحتاجه المنسق. عند تشغيل xhigh، قم بتعيين قيمة كبيرة لـ max_tokens (64K هي نقطة بداية معقولة) بحيث يكون لدى النموذج مساحة للتفكير والتنسيق.

المكون 2: رسائل النظام في منتصف المحادثة

هذه هي إمكانية Messages API الجديدة التي تجعل الأمر برمته ممكنًا. قبل Opus 4.8، كانت رسالة النظام الأولية (system prompt) توضع في بداية المحادثة وتبقى ثابتة. الآن يمكنك وضع إدخال نظام في منتصف مصفوفة messages، مما يسمح بحقن تعليمات أو أذونات جديدة في منتصف المهمة.

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

تفعيله في Claude Code

في Claude Code، تتواجد سير العمل الديناميكي خلف خيار "ultracode" في قائمة الجهد. يؤدي اختياره إلى تعيين جهد xhigh ويمنح الجلسة الإذن بإنشاء وكلاء فرعيين متوازيين عبر رسائل النظام في منتصف المحادثة. من هناك، تصف مهمة كبيرة وتدع المنسق يقوم بتوزيعها.

تحدث بعض الأمور تلقائيًا:

• يخطط Claude للمهمة ويقرر كيفية تقسيمها
• يطلق عمالاً بالتوازي، كل منهم مخصص لجزء من المهمة
• تتدفق النتائج وتُدمج في الجلسة الرئيسية

إذا قمت بإعداد Claude Code بخطة، فإن دليل إعداد حزمة تطوير وكيل Claude مع خطة Claude يغطي التكوينات المحيطة.

متى تستخدم سير العمل الديناميكي (ومتى لا تستخدمها)

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

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

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

بناء نفس الشيء عبر واجهة برمجة التطبيقات

لا تحتاج إلى Claude Code لبناء التنسيق. المكونان نفسيهما متاحان على Messages API الخام، وتقدم Anthropic مثالاً عمليًا في بناء وضع تنسيق. الشكل هو:

1. تشغيل استدعاء منسق بجهد xhigh يخطط للمهمة
2. استخدام رسائل النظام في منتصف المحادثة لمنح المنسق إذنًا بإرسال العمال
3. توزيع استدعاءات العمال بالتوازي، كل منها مخصص لوحدة عمل واحدة
4. جمع النتائج وإعادتها إلى المنسق لدمجها

import anthropic

client = anthropic.Anthropic()

orchestrator = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=64000,
    output_config={"effort": "xhigh"},
    thinking={"type": "adaptive"},
    messages=[
        {"role": "user", "content": "Plan a refactor of the auth module across all 14 services."},
    ],
)

كل عامل هو استدعاء Messages منفصل يمكنك تشغيله بالتوازي، غالبًا بمستوى جهد أقل نظرًا لأن وظيفته ضيقة. إذا كنت تقارن هذا بالبنية التحتية للوكلاء المستضافة من Anthropic، فإن دليل الوكلاء المدارة مقابل حزمة تطوير الوكلاء (Agent SDK) يوضح المقايضات.

التكلفة والتحكم

الوكلاء الفرعيون المتوازيون يضاعفون إنفاق الرموز بسرعة. سير عمل ديناميكي يطلق 200 عامل، كل منهم ينفق عشرات الآلاف من الرموز بجهد xhigh، يكلف أموالاً حقيقية. ثلاث عادات تحافظ على معقوليته:

• حدد نطاق العمال بدقة وشغلهم بجهد medium أو low حيث تسمح المهمة الفرعية بذلك
• ضع حدًا لـ max_tokens لكل عامل حتى لا يستنزف وكيل خارج عن السيطرة ميزانيتك
• تخزين السياق المشترك مؤقتًا حتى لا يتم فوترة رسالة النظام المتكررة بالسعر الكامل على كل عامل

تحليل تسعير Opus 4.8 يحتوي على حسابات مستويات الجهد والتخزين المؤقت. باختصار: التنسيق قوي، لكن الفاتورة تتناسب طرديًا مع عدد الوكلاء، لذا تعامل مع التوازي كخيار مدروس.

اختبار تنسيقك باستخدام Apidog

عند بناء التنسيق عبر واجهة برمجة التطبيقات، الجزء الصعب في التصحيح هو التوزيع (fan-out): هل يحصل العمال على السياق المحدد النطاق الصحيح، هل استجاباتهم بالشكل الذي تتوقعه خطوة الدمج لديك، وهل تصل رسالة النظام في منتصف المحادثة بشكل صحيح؟ لا تريد اكتشاف خطأ بعد 200 استدعاء عامل مباشر.

يتيح لك Apidog اختبار الأجزاء بمعزل عن بعضها البعض:

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

قم بتنزيل Apidog، وقم ببناء طلبات المنسق والعامل مقابل https://api.anthropic.com/v1/messages، وتحقق من الحلقة على المحاكاة أولاً. دليل واجهة برمجة تطبيقات Opus 4.8 يحتوي على الطلب الأساسي للبدء منه. بمجرد أن يصبح المنطق قويًا على المحاكاة، انتقل إلى نقطة النهاية المباشرة.

الأسئلة الشائعة

ما هي سير العمل الديناميكي (Dynamic Workflows) في Claude Code؟ ميزة تتيح لجلسة واحدة إطلاق المئات من الوكلاء الفرعيين المتوازيين للتعامل مع المهام الكبيرة والمتشعبة. يتم تشغيلها بجهد xhigh بالإضافة إلى رسائل النظام في منتصف المحادثة على Opus 4.8.

هل ultracode مستوى جهد منفصل؟ لا. Ultracode هو الاسم الذي يطلقه Claude Code على جهد xhigh مقترنًا بإذن دائم لإطلاق سير عمل متعدد الوكلاء. لا تزال مستويات جهد واجهة برمجة التطبيقات هي low، medium، high، xhigh، و max.

ما هي رسائل النظام في منتصف المحادثة؟ تغيير في Messages API في Opus 4.8 يتيح لك وضع إدخال نظام في منتصف المحادثة، مما يسمح بحقن تعليمات أو أذونات جديدة في منتصف المهمة. وهذا ما يمكّن المنسق من إنشاء العمال بعد بدء التشغيل.

هل يمكنني بناء سير عمل ديناميكي بدون Claude Code؟ نعم. استخدم جهد xhigh بالإضافة إلى رسائل النظام في منتصف المحادثة على Messages API الخام. تنشر Anthropic مثالاً عمليًا للتنسيق في وثائقها.

هل تكلف سير العمل الديناميكي الكثير؟ قد تفعل. المئات من الوكلاء الفرعيين بجهد xhigh تصل إلى ملايين الرموز. حدد نطاق العمال بدقة، قلل جهدهم حيثما أمكن، وقم بتخزين السياق المشترك مؤقتًا للتحكم في الإنفاق.

متى يجب تجنب سير العمل الديناميكي؟ في المهام الضيقة أو المتسلسلة بدقة. لا يضيف العمال المتوازيون أي قيمة عندما تعتمد كل خطوة على سابقتها، ويهدرون الرموز في المهام الصغيرة.