---
title: "وكلاء الذكاء الاصطناعي طويلو التشغيل: المهلة وإعادة المحاولة"
description: "أبقِ وكيل LLM يعمل لساعات: مهلة لكل استدعاء، وبث لاكتشاف التوقف، وإعادة محاولة آمنة، وآثار جانبية للأدوات لا تتكرر، ونقطة حفظ بعد كل خطوة."
url: https://broadrouter.com/ar/blog/long-running-agents-timeouts-retries/
lang: ar
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. [اقرأ الأصل الإنجليزي](https://broadrouter.com/blog/long-running-agents-timeouts-retries/) (حُدّث في 2026-11-16).

# الوكلاء طويلو التشغيل: مهلات وإعادة محاولات ونقاط حفظ تصمد

بقلم فريق BroadNet Inference · قراءة في 4 دقائق · تاريخ النشر 2026-11-14 · آخر تحديث 2026-11-16

تعامل مع كل استدعاء للنموذج كشيء يمكن الاستغناء عنه، ومع حالة الوكيل كشيء دائم. حدّد مهلة لكل استدعاء، واستخدم البث لاكتشاف التوقف، وأعد محاولة 429 و5xx والبث المنقطع بتأخير متزايد محدود، وامنح كل أداة ذات أثر جانبي مفتاح عدم تكرار. واحفظ قائمة الرسائل بعد كل خطوة ليستأنف الوكيل بعد أي انهيار من آخر نقطة حفظ لا من البداية.

## أبرز النقاط

-   تنتهي مهلة OpenAI Python SDK بعد 10 دقائق ويعيد المحاولة مرتين افتراضيًا. حدّد القيمتين صراحةً في الوكلاء.
-   البث الذي ينتهي قبل data \[DONE\] إجابة غير مكتملة. وإعادة محاولته استدلال جديد يُحاسَب مرة أخرى في الدفع حسب الاستخدام.
-   إعادة محاولة استدعاءات النموذج آمنة. أما الآثار الجانبية للأدوات فليست كذلك، ما لم تحمل مفتاح عدم تكرار.
-   احفظ نقطة بعد كل خطوة مكتملة: قائمة الرسائل، ورقم الخطوة، ومعرّفات الآثار الجانبية المنجزة.
-   في جلسة الخطة لا تكلّف إعادة المحاولة شيئًا إضافيًا، لكنها تشغل خانة الطلب الوحيدة أثناء تنفيذها.

**في هذه الصفحة**

1.  ما الذي ينكسر حين يعمل الوكيل لساعات؟
2.  1\. كم يُسمح للاستدعاء أن يستغرق؟
3.  2\. لماذا تستخدم البث في وكيل طويل التشغيل؟
4.  3\. ما الذي يجب إعادة محاولته؟
5.  4\. كيف تجعل استدعاءات الأدوات غير قابلة للتكرار؟
6.  5\. كيف تحفظ نقاط استئناف للوكيل؟
7.  قائمة تحقق قبل تشغيل طوال الليل
8.  أين يأتي دور BroadNet Inference؟

الوكيل الذي يعمل خمس دقائق يستطيع تجاهل الفشل. أما الذي يعمل خمس ساعات فسيواجه انتهاء مهلة، و429، وبثًّا منقطعًا، وعلى الأرجح إعادة تشغيل. معظم الأدلة عن الوكلاء طويلي التشغيل تروّج لمحرّك سير عمل، وقد لا تحتاج إليه. يتناول هذا المقال خمس عادات تُبقي حلقة وكيل بسيطة حيّة لساعات، مع شيفرة لـOpenAI Python SDK.

## ما الذي ينكسر حين يعمل الوكيل لساعات؟

| الفشل | كيف يبدو | العادة التي تعالجه |
| --- | --- | --- |
| استدعاء عالق أو بطيء | لا رد لدقائق | مهلة لكل استدعاء، والبث |
| حد المعدّل أو الحمل الزائد | 429، 5xx | إعادة محاولة محدودة بتأخير متزايد |
| بث منقطع | ينتهي الاتصال قبل `[DONE]` | اعتبره غير مكتمل وأعد الاستدعاء |
| أثر جانبي مكرّر | تعمل الأداة مرتين بعد إعادة المحاولة | مفاتيح عدم التكرار |
| انهيار العملية أو نشر جديد | يعود الوكيل إلى الخطوة 1 | نقطة حفظ لكل خطوة |

## 1\. كم يُسمح للاستدعاء أن يستغرق؟

يقول ملف README في OpenAI Python SDK إن مهلة الطلبات تنتهي افتراضيًا بعد 10 دقائق، وإن أخطاء معيّنة يُعاد محاولتها مرتين. في الوكيل، حدّد القيمتين بنفسك، كي لا يتغيّر السلوك دون علمك:

```python
client = OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"],
                timeout=300, max_retries=4)
```

اختر المهلة بناءً على البيانات. سجّل مدة كل استدعاء ليوم كامل، ثم اضبط المهلة أعلى بكثير من أبطأ استدعاء ناجح. الأوامر الكبيرة تتأخر أكثر في البدء، و[نماذج الاستدلال المنطقي](https://broadrouter.com/ar/glossary/reasoning-tokens/) تفكّر قبل أن تكتب. فبسرعة نحو 100 رمز في الثانية تستغرق 8,000 رمز (توكن) إخراج أكثر من دقيقة وحدها. وأضِف ميزانية زمنية منفصلة لكل **مهمة** كي لا تستمر حلقة لا تتوقف طوال الليل.

## 2\. لماذا تستخدم البث في وكيل طويل التشغيل؟

يمنحك [البث](https://broadrouter.com/ar/glossary/streaming/) إشارة أثناء عمل النموذج. فبدونه يبدو الاستدعاء البطيء والاتصال الميت متشابهين حتى تنتهي المهلة. ومعه ترى الأجزاء تصل، وتحصل أيضًا على استهلاك الرموز في الجزء الأخير.

قواعد البث لدى BroadNet: اقرأ حتى السطر الحرفي `data: [DONE]`. إذا أُغلق الاتصال قبله فالإجابة غير مكتملة. سجّل `X-Request-ID`، ثم قرّر هل ترسل طلبًا جديدًا. [الدليل الكامل للبث](https://broadrouter.com/ar/guides/streaming-chat-completions/).

```python
def call_streaming(messages, tools=None):
    parts, done = [], False
    stream = client.chat.completions.create(
        model="broadnet/glm-5.3", messages=messages, tools=tools, stream=True,
        stream_options={"include_usage": True}, max_tokens=8000)
    for chunk in stream:
        if chunk.choices and chunk.choices[0].finish_reason:
            done = True
        if chunk.choices and chunk.choices[0].delta.content:
            parts.append(chunk.choices[0].delta.content)
    if not done:
        raise IncompleteStream()   # retry the whole call
    return "".join(parts)
```

هذا المخطط يجمع النص فقط. إذا كنت تبثّ استدعاءات الأدوات، فاجمع `delta.tool_calls` حسب الفهرس أيضًا.

## 3\. ما الذي يجب إعادة محاولته؟

يعيد الـSDK بالفعل محاولة أخطاء الاتصال و408 و409 و429 و5xx. أضِف إعادة محاولة خاصة بك فوقه فقط لما لا يراه، مثل البث غير المكتمل:

1.  **أعد المحاولة:** أخطاء الاتصال، و429، و5xx، والبث غير المكتمل. استخدم [التأخير الأسّي المتزايد](https://broadrouter.com/ar/glossary/exponential-backoff/) مع عشوائية وسقف، مثلًا 4 محاولات.
2.  **أصلح ولا تُعِد المحاولة:** 400 و401 و402 و403 و413 و422. هذه تفشل بالطريقة نفسها كل مرة. راجع [رموز الأخطاء ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).
3.  **خصّص ميزانية لإعادة المحاولة لكل مهمة**، لا لكل استدعاء فقط. عشر خطوات تعيد كل منها المحاولة أربع مرات تعني أربعين استدعاءً إضافيًا.
4.  **انتقل إلى مزود بديل حين تنفد المحاولات.** إذا كان يجب أن يصمد التشغيل أمام انقطاع لدى المزود، فحوّل أخطاء الاتصال و5xx و429 الخاصة بحد المعدّل إلى مزود ثانٍ. ويعرض مقال [التحويل التلقائي بين مزودي LLM API](https://broadrouter.com/ar/blog/llm-api-failover-fallback/) شيفرة العميل وقاطع دائرة.

في الدفع حسب الاستخدام، كل إعادة محاولة استدلال جديد يُحاسَب مرة أخرى. ومفتاح الدفع حسب الاستخدام يسمح أيضًا بـ30 طلب في الدقيقة و4 طلبات متزامنة، لذا تصطدم موجات إعادة المحاولة بـ[حد المعدّل](https://broadrouter.com/ar/glossary/rate-limit/) بسرعة؛ وتبيّن [حاسبة حدود المعدّل](https://broadrouter.com/tools/llm-rate-limit-calculator/) الهامش المتاح لوكيلك. ويشرح [مقال التعامل مع 429](https://broadrouter.com/ar/blog/handle-llm-api-429-rate-limits/) التأخير المتزايد بالتفصيل. وفي [الخطة غير المحدودة](https://broadrouter.com/ar/guides/unlimited-llm-api-sessions/) لا تكلّف إعادة المحاولة شيئًا إضافيًا، لكنها تشغل خانة الطلب الوحيدة في الجلسة أثناء تنفيذها.

## 4\. كيف تجعل استدعاءات الأدوات غير قابلة للتكرار؟

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

امنح كل استدعاء ذي أثر جانبي [مفتاح عدم تكرار](https://broadrouter.com/ar/glossary/idempotency-key/) مشتقًّا من المهمة والخطوة، وتحقّق منه قبل التنفيذ، وتخطَّ الاستدعاء إذا كان مسجَّلًا بالفعل:

```python
def run_side_effect(task_id, step, call, store):
    key = f"{task_id}:{step}:{call.id}"
    if store.done(key):
        return store.result(key)       # already ran: return the saved result
    result = execute(call)             # pass key to the API if it supports one
    store.save(key, result)
    return result
```

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

## 5\. كيف تحفظ نقاط استئناف للوكيل؟

احفظ بعد كل خطوة مكتملة: قائمة الرسائل، ورقم الخطوة، ومفاتيح الآثار الجانبية. وعند البدء، حمّل أحدث نقطة حفظ إن وُجدت.

```python
def save_checkpoint(path, step, messages):
    tmp = path + ".tmp"
    with open(tmp, "w") as f:
        json.dump({"step": step, "messages": messages}, f)
    os.replace(tmp, path)   # atomic on the same filesystem
```

الكتابة إلى ملف مؤقت ثم إعادة تسميته تعني أن الانهيار أثناء الكتابة لا يترك أبدًا نقطة حفظ ناقصة. وفي الجلسات الطويلة جدًا، احفظ أيضًا **ملخّصًا**: استبدل الأدوار القديمة بملخّص قصير كي لا يعيد الوكيل المستأنَف تحميل تاريخ ضخم. هذا يُبقيك داخل [نافذة السياق](https://broadrouter.com/ar/glossary/context-window/)، حتى مع 1,048,576 رمزًا في [DeepSeek V4.1 Flash](https://broadrouter.com/ar/models/deepseek-v4.1-flash/).

## قائمة تحقق قبل تشغيل طوال الليل

1.  المهلة و`max_retries` محدّدتان صراحةً في العميل.
2.  البث مفعّل مع `include_usage`، والبث غير المكتمل يُعاد.
3.  ميزانية لإعادة المحاولة لكل مهمة، وحد زمني.
4.  مفاتيح عدم تكرار على كل أداة تكتب أو ترسل أو تدفع.
5.  نقطة حفظ بعد كل خطوة، تُكتب بشكل ذرّي.
6.  سجلات فيها رقم الخطوة والمدة والرموز و`X-Request-ID`.

إذا كنت تشغّل عدة وكلاء جنبًا إلى جنب، فاقرأ [تشغيل وكلاء برمجة متوازين بسعر ثابت](https://broadrouter.com/ar/blog/run-parallel-coding-agents-flat-rate/) و[تكلفة أنظمة الوكلاء المتعددين](https://broadrouter.com/ar/blog/multi-agent-cost/).

## أين يأتي دور BroadNet Inference؟

تستخدم BroadNet Inference بث chat completions القياسي، وتعيد ترويسة `X-Request-ID` يمكنك تسجيلها، وتوثّق الأخطاء التي يُعاد محاولتها، فتعمل الأنماط أعلاه كما هي مكتوبة. وللوكلاء الذين يعملون طوال اليوم، تزيل الخطط غير المحدودة عدّاد الرموز على DeepSeek V4.1 Flash مقابل $60 شهريًا لكل جلسة، ما يجعل إعادة المحاولة مجانية. ضع في حسبانك أن ساعة الشهاب (Meteor) تنتهي بعد ساعة من الشراء، وأسبوع المدار (Orbit) بعد سبعة أيام، لذا يجب أن تنتهي المهمة الطويلة داخل المدة أو تنتقل إلى جلسة البدر (Full Moon) المتجددة. الخطط متاحة على [inference.broadnet.ai/plans](https://inference.broadnet.ai/plans?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-blog-long-running-agents-timeouts-retries&utm_content=body).

أدوات مجانية لهذا الموضوع (بالإنجليزية)

-   [Agent run cost estimator](https://broadrouter.com/tools/agent-run-cost-estimator/) Context growth per step, total tokens and cost of one agent run, with a DeepSeek session comparison.
-   [LLM batch job planner](https://broadrouter.com/tools/llm-batch-job-planner/) Run time, binding limit, cost per model and the flat sessions needed to finish a big job by a deadline.
-   [Flat-rate vs per-token LLM cost calculator](https://broadrouter.com/tools/flat-rate-vs-per-token-calculator/) Break-even between an unlimited plan and paying per token, per agent.
-   [LLM rate limit and concurrency calculator](https://broadrouter.com/tools/llm-rate-limit-calculator/) Which limit binds first: RPM, TPM or concurrency, with Little's law.

[أدوات مجانية (بالإنجليزية)](https://broadrouter.com/tools/)

## مصطلحات في هذا المقال

[الدفع حسب الاستخدام (Pay-as-you-go)](https://broadrouter.com/ar/glossary/pay-as-you-go/)

الدفع حسب الاستخدام هو نموذج تسعير تدفع فيه مقابل ما تستخدمه فقط، مقيسًا بوحدات مثل الرموز (التوكنات) أو الطلبات أو دقائق الصوت، دون اشتراك أو حد أدنى للالتزام. وتحتسب معظم واجهات LLM API تكلفتها بهذه الطريقة، من رصيد مدفوع مسبقًا أو بفاتورة دورية.

[الرمز (التوكن، Token)](https://broadrouter.com/ar/glossary/token/)

الرمز (التوكن) هو وحدة النص التي يقرؤها نموذج اللغة ويكتبها: كلمة، أو جزء من كلمة، أو علامة ترقيم، أو تسلسل بايتات ينتجه مجزّئ النموذج (tokenizer). وتَعُدّ واجهات LLM API الاستهلاك بالرموز، وتضع حدودها بها، وتحتسب تكلفتها بها عادةً.

[استدعاء الأدوات (Tool calling)](https://broadrouter.com/ar/glossary/tool-calling/)

استدعاء الأدوات، ويُسمّى أيضًا استدعاء الدوال (function calling)، ميزة في واجهات LLM API يُرجع فيها النموذج طلبًا منظَّمًا لتشغيل دالة عرّفها المطوّر، مع معاملات بصيغة JSON. ويشغّل التطبيق الدالة ويعيد النتيجة؛ فالنموذج لا يشغّل الشيفرة بنفسه أبدًا.

[البث المتدفق (Streaming)](https://broadrouter.com/ar/glossary/streaming/)

البث المتدفق (streaming) طريقة لإرجاع استجابة النموذج اللغوي على أجزاء صغيرة أثناء توليدها، بدل إرجاعها ردًا واحدًا في النهاية. وتبث الواجهات المتوافقة مع OpenAI عبر أحداث يرسلها الخادم (server-sent events) حين يضبط الطلب stream على true.

[التزامن (Concurrency)](https://broadrouter.com/ar/glossary/concurrency/)

التزامن (concurrency) هو عدد الطلبات التي تكون لدى العميل قيد التنفيذ في الوقت نفسه. وكثيرًا ما تضع واجهات LLM API سقفًا له لكل مفتاح أو خطة، بمعزل عن عدد الطلبات في الدقيقة، لأن كل طلب مفتوح يشغل قدرة من وحدة GPU حتى تكتمل استجابته.

[زمن الاستجابة (Latency)](https://broadrouter.com/ar/glossary/latency/)

زمن الاستجابة (latency)، في واجهات API للنماذج اللغوية، هو المدة التي يستغرقها الطلب من لحظة إرساله حتى استلام آخر رمز من المخرجات. وهو مجموع زمن أول رمز وزمن التوليد، ويُذكر عادةً بالمئينات مثل p50 وp95 لا بالمتوسط.

[حد المعدل (Rate limit)](https://broadrouter.com/ar/glossary/rate-limit/)

حد المعدل هو سقف تفرضه واجهة API على مقدار استخدام العميل لها خلال فترة زمنية، مثل عدد الطلبات في الدقيقة أو الرموز في الدقيقة. وتُرفض الطلبات التي تتجاوزه، غالبًا بالخطأ HTTP 429 Too Many Requests، إلى أن يعود الاستخدام تحت الحد.

[نافذة السياق (Context window)](https://broadrouter.com/ar/glossary/context-window/)

نافذة السياق هي الحد الأقصى لعدد الرموز (التوكنات) التي يستطيع نموذج اللغة التعامل معها في طلب واحد. وتشمل الأمر (prompt) وسجل المحادثة وتعريفات الأدوات والصور والمخرجات المولَّدة، بما فيها رموز الاستدلال المنطقي. وكل ما لا يتسع لها يجب قصّه أو تلخيصه أو توزيعه على عدة طلبات.

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

### ما المهلة التي أضبطها لاستدعاءات LLM API في الوكيل؟

طويلة بما يكفي لأبطأ استدعاء مشروع، وقصيرة بما يكفي لالتقاط الاستدعاء العالق. القيمة الافتراضية في OpenAI Python SDK هي 10 دقائق. وكثير من الوكلاء يستخدمون من 2 إلى 5 دقائق لكل استدعاء مع البث، وحدًّا زمنيًا منفصلًا لكل مهمة.

### أي أخطاء LLM API يجب أن يعيد الوكيل محاولتها؟

أعد محاولة أخطاء الاتصال و429 و5xx بتأخير أسّي متزايد ومحدود مع عشوائية. أما 400 و401 و402 و403 و413 و422 فأصلحها بدل إعادة محاولتها. وفي BroadNet سجّل أيضًا ترويسة X-Request-ID لكل فشل.

### هل إعادة محاولة طلب chat completion آمنة؟

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

### كيف أستأنف عمل الوكيل بعد انهياره؟

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

### هل يحتاج الوكلاء طويلو التشغيل إلى خطة غير محدودة؟

لا، لكن إعادة المحاولة والسياقات الطويلة تتراكم في الدفع حسب الاستخدام. وفي خطط BroadNet غير المحدودة لا يوجد عدّاد رموز على DeepSeek V4.1 Flash، فلا تكلّف إعادة المحاولة شيئًا إضافيًا، مع أن كل جلسة لا تزال تشغّل طلبًا واحدًا في كل مرة.

## تابع القراءة

-   [استدعاء الأدوات في النماذج المفتوحة: المخططات والتوازي والإعادة](https://broadrouter.com/ar/blog/tool-calling-open-models/)
-   [تكلفة الأنظمة متعددة الوكلاء: الدفع لكل رمز أم الجلسات الثابتة](https://broadrouter.com/ar/blog/multi-agent-cost/)
-   [كيف تشغّل وكلاء برمجة متوازيين على LLM API بسعر ثابت](https://broadrouter.com/ar/blog/run-parallel-coding-agents-flat-rate/)
-   [ما معنى «غير محدود» فعلًا في خطط API نماذج اللغة؟](https://broadrouter.com/ar/blog/what-unlimited-llm-api-really-means/)
-   [التحويل التلقائي في LLM API: الانتقال إلى مزوّد احتياطي في شيفرتك](https://broadrouter.com/ar/blog/llm-api-failover-fallback/)
-   [كم يكلّف تشغيل واحد لوكيل برمجة: الخطوات ونمو السياق والتخزين المؤقت](https://broadrouter.com/ar/blog/ai-coding-agent-run-cost/)
-   [Claude Code مع النماذج المفتوحة: الوكلاء ونقاط النهاية الأصلية والحدود](https://broadrouter.com/ar/blog/claude-code-with-openai-compatible-models/)
-   [دليل: رموز أخطاء BroadNet Inference ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/)
-   [دليل: البث المتدفق لإكمال المحادثات والتعامل مع انقطاع الاتصال](https://broadrouter.com/ar/guides/streaming-chat-completions/)
-   [دليل: كيف تعمل خطط LLM API غير المحدودة مع الوكلاء](https://broadrouter.com/ar/guides/unlimited-llm-api-sessions/)
-   [دليل: استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/)

جرّبه على مهامك الفعلية. تبدأ الحسابات الجديدة برصيد قدره $5 لاستخدام Gemma والتفريغ الصوتي. أما DeepSeek وGLM وQwen3.8 فتتطلب شحن الرصيد.

[ابدأ الآن](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-blog-long-running-agents-timeouts-retries&utm_content=page-cta) ·

**المصادر**

-   [ملف README في OpenAI Python SDK: إعادة المحاولة والمهلات (تاريخ المراجعة 2026-11-14)](https://github.com/openai/openai-python)
-   [المرجع التقني لواجهة BroadNet Inference: الأخطاء وإعادة المحاولة (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-blog-long-running-agents-timeouts-retries&utm_content=sources#errors)
-   [المرجع التقني لواجهة BroadNet Inference: البث والحدود (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-blog-long-running-agents-timeouts-retries&utm_content=sources#requests)
-   [خطط BroadNet Inference غير المحدودة](https://inference.broadnet.ai/ar/plans?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-blog-long-running-agents-timeouts-retries&utm_content=sources)
