> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wolffi.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# وضع سير العمل

> حوّل الوكيل الواحد الذي تحادثه إلى قائد تشغيلةٍ يصمّمها بنفسه — مراحل، ووكلاء متوازون أحياء، ونموذج يُختار لكل وكيل

# وكيل واحد، وكلاء كثيرون

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

هو خيار اختياري. افتراضيًا يعمل وولفيش في **الوضع المفرد** — نموذج واحد يجيب مباشرةً. تبدّل الأوضاع داخل **بطاقة النموذج بجوار حقل الإدخال**: افتحها، واختر «فردي» أو «سير عمل» من صفّ الرقاقات فوق حقل البحث، ويسري الاختيار من رسالتك التالية.

## سير العمل مقابل الوضع المفرد

|           | المفرد (افتراضي)                                     | سير العمل                                                               |
| --------- | ---------------------------------------------------- | ----------------------------------------------------------------------- |
| النماذج   | واحد — الدماغ                                        | الدماغ قائدًا، وأيّ نموذج موصول لكل وكيل                                |
| العمل     | يقوم الدماغ بكل شيء بنفسه، بالتتابع                  | يفوّض القائد الشرائح المستقلة إلى وكلاء متوازين                         |
| التكلفة   | نموذج واحد، جلسة واحدة                               | عدّة جلسات حيّة، كلٌّ منها تُحاسَب على نموذجها                          |
| الأفضل لـ | الدردشات السريعة، المهام الصغيرة أو التسلسلية الصرفة | المهام المعقّدة التي تنقسم إلى أجزاء مستقلة، أو العمل الذي يستحق التحقق |

<Note>
  الانتقال إلى وضع سير العمل لا يفرض التفويض. يُحجّم القائد سير العمل على قدر المهمة، **في كل دور**: «مرحبًا» أو تعديل ملف واحد يحصل على إجابة مباشرة بلا خطة ولا وكلاء، بينما قد يحصل التسليم الشاق على وكلاء تحليل ووكلاء بناء ووكلاء متشكّكين وجولة تحقق. يجب ألّا يجعل وضعُ سير العمل الأشياءَ الصغيرة بطيئة أبدًا.
</Note>

## كيف يعمل

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

```
        أنت
         │
    ┌────▼────┐
    │ القائد  │   (نموذج الدماغ لديك)
    └────┬────┘
  التخطيط │ الإطلاق / الجمع / التوجيه / الإلغاء
    ┌────┼────┐
    ▼    ▼    ▼
  وكيل  وكيل  وكيل   (نماذج يختارها القائد، تعمل بالتوازي)
```

يجري الدور في وضع سير العمل هكذا:

1. **التخطيط.** للمهمة الكبيرة بما يكفي، يعلن القائد مراحل التشغيلة — مثل تحليل ← بناء ← نقد ← تحقق. الخطة تصميمه هو، لا قالبًا ثابتًا أبدًا، ويمكنه مراجعتها في منتصف التشغيلة كلما تعلّم. تُعرض المراحل على بطاقة سير العمل وتضيء مع عمل وكلائها.
2. **الإطلاق.** يوزّع الشرائح المستقلة على وكلاء — عدّة وكلاء دفعةً واحدة — كاتبًا لكل واحد مهمةً كاملة مكتفية بذاتها. لا يرى الوكيل إلا ما يكتبه له القائد؛ فليس له اطّلاع على خيط دردشتك ولا على بقية الوكلاء.
3. **الجمع لحظة الوصول.** ينتظر وفق الأحداث: **أول** وكيل ينتهي يعود أولًا، ويتفاعل القائد مع كل تقرير فور وصوله بدل التعطّل بانتظار الأبطأ.
4. **التحقق.** يُنتقد العمل المنتَج قبل الوثوق به — وكيل متشكّك يُطلب منه الدحض، أو فاحص يعيد تشغيل الادّعاء، أو وكلاء متنافسون يقارن القائد إجاباتهم. لا شيء مهم يُسلَّم ولم يره سوى مؤلّفه.
5. **التكرار.** يعيد إشراك الوكلاء الخاملين بتعليمات متابعة، ويلغي الخارجين عن المسار، ويمتصّ بنفسه الشريحة الفاشلة حين يكون ذلك أرخص من إعادة الإطلاق.
6. **التوليف.** متى صمدت الأجزاء، يكتب القائد **ردًّا واحدًا** بصوته هو. لا يلصق مخرجات الوكلاء الخام عليك أبدًا، ولا يترك وكيلًا يعمل حين يجيب.

### نموذج لكل وكيل

هذا أكبر فرق عن خانة «العامل» الثابتة الوحيدة في وضع التنسيق القديم: لا يوجد نموذج ثانٍ تضبطه. يرى القائد كتالوجًا حيًّا **بكل نموذج لدى كل مزوّد وصلته** — كلٌّ بنافذة سياقه ومستويات تفكيره المدعومة وقدرته البصرية — ويختار لكل شريحة: نموذجًا طليعيًا للاستدلال الصعب والحكم، وسريعًا رخيصًا للمسح الميكانيكي، ونموذجه هو حين لا يحدّد شيئًا. يبقى ضمن عائلة مزوّد دماغك افتراضيًا، ولا يعبر إلى عائلة أخرى إلا حين تستفيد الشريحة بوضوح — قدرة تفتقدها عائلته، أو متشكّك مستقل تختلف نقاطه العمياء عن نقاط المنتِج.

ويُضبط **جهد التفكير** لكل وكيل بحسب مهمته أيضًا — `off` / `on` / `high` / `max`، مقيّدًا بما يدعمه النموذج المختار.

### أدوات سير العمل

يقود القائد التشغيلة عبر طقم أدوات صغير مخصّص. أنت لا تستدعي هذه الأدوات — القائد يفعل، من تلقاء نفسه.

| الأداة                                                | ما تفعله                                                                                                                                                  |
| ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `workflow_plan(phases, note?)`                        | إعلان مراحل التشغيلة (أو مراجعتها). تُعرض على بطاقة سير العمل، وتضيء المراحل مع عمل وكلائها واكتمالهم.                                                    |
| `agent_spawn({task, name?, model?, effort?, phase?})` | إطلاق وكيل حيّ في الخلفية. يعود بمعرّف فورًا؛ أطلق عدّة وكلاء تباعًا للتوازي. `model` أيّ `provider/model-id` وصلته.                                      |
| `agent_send(agent_id, message, effort?)`              | إرسال متابعة إلى وكيل خامل — يعمل من جديد وسياقه السابق كامل.                                                                                             |
| `agents_await(agent_ids?)`                            | الانتظار حتى يصل الوكيل **التالي** (لا كلهم)؛ يعيد أول تقرير مكتمل — أو **إشعار توقّف** مبكّراً عن وكيلٍ ما زال يعمل لكنّه عَلِق يكرّر نفسه (انظر أدناه). |
| `agent_cancel(agent_id)`                              | إلغاء وكيل فورًا، مع إجهاض استدعاء الأداة الجاري لديه. الإلغاء وإعادة الإطلاق هما أيضًا طريقة القائد لتوجيه وكيل في منتصف عمله.                           |

<Note>
  التفويض **مستوى واحد فقط**. الوكلاء وكلاء كاملون مع ثلاثة استثناءات: لا يستطيعون إطلاق وكلاء خاصين بهم، ولا مراسلة أيّ قناة، ولا طرح أسئلة عليك — العائق يوضع في تقريرهم إلى القائد بدلًا من ذلك. القائد هو الوحيد القادر على الوصول إليك. هذا يُبقي البنية مسطّحة ووعدَ الصوت الواحد قائمًا.

  ما *يتشاركه* الوكلاء فعلًا هو **جلسة المدير المحفوظة** في التطبيق: أمر `sudo` داخل وكيلٍ يتوثّق تمامًا كما يتوثّق في المحادثة (حوار كلمة سرّ نظاميّ واحد على الأكثر لكل تشغيلة للتطبيق، من جهة التطبيق)، فالعمل الإداري المفوَّض يمضي وحسب بدل أن يرتدّ عائقًا — وينطبق الأمر نفسه على التشغيلات المجدولة.
</Note>

### إعادة محاولات الوكلاء

الوكلاء **بطلقة واحدة** — لا يعيدون المحاولة من تلقاء أنفسهم. أيّ فشل يصعد مباشرةً إلى القائد، فيقرأه ويقرّر: إعادة تشغيله، أو إعادة تحديد نطاقه، أو تجربة نموذج آخر، أو امتصاص الشريحة بنفسه. (القائد نفسه لا يزال يملك رصيد إعادة محاولة للأخطاء العابرة؛ الوكلاء لا.)

### حين يَعلَق وكيل

قد يُوحِل الوكيل نفسه — يعيد **استدعاء الأداة نفسها مرّةً بعد مرّة** بلا طائل (صفحة تظلّ تُعيد التحميل، أو إجراء مرفوض يُعاد في حلقة). يرصد وولفيش ذلك ويُخبر الطرفين. فالوكيل العالق يتلقّى ملاحظةً في تغذيته هو بأنّه يكرّر نفسه وعليه أن يختم بما لديه. والقائد يُوقَظ في هذه الأثناء **من `agents_await`** بإشعار توقّفٍ يسمّي الوكيل والاستدعاء الذي يلحّ عليه وعدد مرّاته — فلا يبقى قائدٌ محبوساً بانتظار نتيجةٍ قد لا تأتي أبداً. ثم يقرّر هو: **ينتظر قليلاً بعدُ** ليدع الوكيل يختم بنتائج جزئية، أو **`agent_cancel`** يُلغيه ويغطّي تلك الشريحة بطريقة أخرى. لا سقفَ يُفرَض ولا إنهاءَ تلقائياً — يبقى القرار عند القائد. والوصولات الحقيقية لها الأولوية دائماً: إن كان تقريرٌ مكتملٌ جاهزاً، أعاده `agents_await` أولاً، ولا يُظهر إشعار التوقّف إلا حين لا يصل شيء.

## بطاقة سير العمل

كل تشغيلة سير عمل تحصل على بطاقة واحدة في المحادثة. مطويةً، هي ترويسة هادئة واحدة؛ ومفتوحةً، هي التشغيلة كاملة:

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

كل رقم مأخوذ من قياسات المنصة نفسها — الحالات والتوكنات والتوقيت — لا مما يدّعيه النموذج أبدًا، فالبطاقة التي تشاهدها حيّةً هي نفسها التي تعيد فتحها الأسبوع القادم. وهي تُطبع أيضًا: تصدير المحادثة إلى PDF يعرض التشغيلة المنتهية جدولًا ثابتًا. وتغذّي القياسات نفسها **بطاقة شريحة السياق**، التي تفصّل التشغيلة قسمًا خاصًا بسير العمل — صف لكل وكيل بحالته الحية وتوكناته وتكلفته، مع مجاميع التشغيلة — ويعود مع بقية العدّاد حين تعيد فتح المحادثة.

## متى تستخدمه

<CardGroup cols={2}>
  <Card title="ابحث في عدّة أشياء" icon="magnifying-glass">
    انظر في عدّة مواضيع أو مصادر أو خيارات دفعةً واحدة — وكيل لكل خيط — ثم دع القائد يولّف النتائج.
  </Card>

  <Card title="ابنِ أو حلّل بالتوازي" icon="layer-group">
    عدّة مكوّنات أو ملفات أو تحليلات مستقلة لا يعتمد بعضها على بعض. كلٌّ منها يحصل على عمق وكيل كامل مركّز.
  </Card>

  <Card title="عمل الدفعات" icon="grip">
    العملية نفسها عبر عناصر كثيرة. وزّعها على وكلاء بدل الطحن التسلسلي.
  </Card>

  <Card title="التحقق التنازعي" icon="code-branch">
    دع وكلاء متشكّكين يهاجمون مسودة، أو شغّل مقاربات متنافسة، أو راجع ادّعاءً على عائلة نماذج مستقلة — ثم دع القائد يحكم.
  </Card>
</CardGroup>

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

<Tip>
  لا عتبة ولا معادلة. الإشارة الجيدة هي **الاستقلال**: إذا انقسمت المهمة إلى أجزاء تعمل دون انتظار بعضها بعضًا، اشترى لك وضع سير العمل السرعة (تعمل دفعةً واحدة) والعمق (كل جزء ينال الانتباه الكامل). والإشارة الثانية هي **الرهان**: العمل الذي يستحق التحقق التنازعي يحصل عليه مبنيًّا داخل التشغيلة.
</Tip>

## تفعيله

* **عامًّا:** افتح **بطاقة النموذج** بجوار حقل الإدخال — «فردي/سير عمل» صفُّ رقاقاتٍ داخلها فوق حقل البحث. يسري من رسالتك التالية، وترثه المهام المجدولة والإجراءات افتراضيًا. (وقبل الإصدار 1.0.236 كانت حبّةَ وضعٍ منفصلة على المُنشئ؛ وقد انتقلت لتجتمع كلُّ مقابض النموذج في لوحةٍ واحدة.)
* **لكل أتمتة:** كل مهمة في [صفحة نبض القلب](/ar/configuration/heartbeat) لها مفتاح فردي/سير عمل خاص بها — وهو تحت الغطاء سطر أول اختياري في متن المهمة `mode: workflow` (أو `mode: single`) يُحذف قبل وصول التعليمات إلى الوكيل. ويضبطه وولفيش بالمحادثة أيضًا حين تطلب منه جدولة شيء.
* **لكل إجراء:** كل [إجراء](/ar/configuration/procedures) محفوظ يحمل وضعه الخاص، يُبدَّل بجوار زرّ التشغيل — فيبقى موجز الصباح تشغيلةً فردية سريعة بينما يتفرّع الغوص الأسبوعي إلى وكلاء.

<Note>
  مفاتيح API للمزوّدين تسكن **الإعدادات ← النماذج**؛ ونموذج الدماغ النشط يُختار من **مبدّل النماذج** بجوار حقل الإدخال. نماذج أيّ مزوّد سحابي موصول متاحة للقائد لوكلائه — لا شيء آخر يحتاج ضبطًا.
</Note>

## مراقبة العمل على القنوات

داخل التطبيق، بطاقة سير العمل حاضرة دائمًا. على [واتساب](/ar/channels/whatsapp) و[تيليجرام](/ar/channels/telegram)، تُبلغ تشغيلات سير العمل عن تقدّمها برسائل حتمية مبنية من القياسات نفسها: رسالة عند بدء التشغيلة بخطة مراحلها، ورسالة عند اكتمال كل مرحلة، وملخّص ختامي بالمجاميع.

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

## التكلفة والقيود

<Warning>
  وضع سير العمل **للمهام المعقّدة، لا للمحادثات السريعة**. يمكنه تشغيل عدّة جلسات حيّة في الدور الواحد، فيكلّف أكثر من الوضع المفرد ويضيف عبء تنسيق. أبقِ الوضع المفرد افتراضيًا، والجأ إلى سير العمل حين تنقسم المهمة فعلًا إلى أجزاء متوازية أو تستحق تحققًا مبنيًّا في التشغيلة.
</Warning>

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

## الانتقال من وضع التنسيق

وضع سير العمل يحلّ محلّ وضع التنسيق القديم (v1.0.196–v1.0.204). إن كنت تعمل بوضع التنسيق فستُنقل إلى وضع سير العمل تلقائيًا عند أول تشغيل؛ وقد تقاعدت خانة **نموذج العامل** الثابتة ومفتاحا **الجهد الجشع** و**الاستقلالية** وصفحة **الأوضاع** ذات السحب والإفلات في الإعدادات، وتُكنس مخلّفاتها من مساحة عملك. اختيار النموذج يسكن الآن حقل إدخال المحادثة.

## انظر أيضًا

* [اختيار مزوّد](/ar/configuration/providers) — وصّل المزوّدين الذين يستطيع القائد إطلاق وكلاء على نماذجهم
* [config.json](/ar/configuration/config-json) — كيف يُخزَّن اختيارك للنموذج والوضع (`llm.mode`)
* [نبض القلب](/ar/configuration/heartbeat) — علامات فردي/سير عمل لكل مهمة مجدولة
* [الإجراءات](/ar/configuration/procedures) — وضعٌ لكل إجراء محفوظ
* [خط الأنابيب](/ar/architecture/pipeline) — كيف يتدفق الدور عبر وحدات الدماغ