---
title: "إعداد base_url مخصّص متوافق مع OpenAI في CrewAI | BroadRouter"
description: "وجّه وكلاء CrewAI إلى BroadNet Inference عبر LLM(custom_openai=True, base_url=...)، ثم اختر النماذج للأدوات والسياق الطويل والخطة ثابتة السعر."
url: https://broadrouter.com/ar/guides/crewai-custom-openai-endpoint/
lang: ar
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. [اقرأ الأصل الإنجليزي](https://broadrouter.com/guides/crewai-custom-openai-endpoint/) (حُدّث في 2026-11-16).

# استخدام CrewAI مع BroadNet Inference كنقطة نهاية OpenAI مخصّصة

آخر تحديث 2026-11-16

أنشئ النموذج بالفئة LLM في crewai، ومرّر model بمعرّف من BroadNet مثل broadnet/glm-5.3، وcustom\_openai=True، وbase\_url بقيمة https://inference.broadnet.ai/v1، وapi\_key بمفتاح BroadNet، ثم أعطِ هذا الـ LLM لكل Agent. يستخدم CrewAI عميل OpenAI الأصلي وchat completions، فلا حاجة إلى تثبيت LiteLLM.

CrewAI إطار عمل بلغة Python لفرق الوكلاء. ويعرض توثيقه نمط **نقطة نهاية مخصّصة متوافقة مع OpenAI**: كائن `LLM` مع `custom_openai=True` و`base_url`. وBroadNet Inference تخدم chat completions القياسية على `https://inference.broadnet.ai/v1`، فتندمج هنا مباشرة. BroadRouter هو موقع BroadNet نفسها؛ ويتبع هذا الدليل توثيق CrewAI وشيفرته المصدرية حتى الإصدار 1.15.41.

## التثبيت

```bash
pip install crewai
export BROADNET_API_KEY='your-broadnet-key'
```

## الاتصال

```python
import os
from crewai import LLM, Agent

llm = LLM(
    model="broadnet/glm-5.3",
    custom_openai=True,
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
    max_tokens=4000,  # reasoning counts toward this limit
)

# Quick test: one call straight to the model
print(llm.call("Say hello in five words."))

analyst = Agent(
    role="Analyst",
    goal="Summarize incidents",
    backstory="You write short incident summaries.",
    llm=llm,
)
print(analyst.kickoff("Summarize: the API returned 503 for four minutes after a deploy."))
```

إن طبع `llm.call` إجابة، فالمفتاح والعنوان ومعرّف النموذج صحيحة.

## كيف يوجّه CrewAI الطلب

تحدد الشيفرة المصدرية لـ CrewAI ترتيبًا: يأتي `custom_openai=True` أولًا ويفرض مزوّد OpenAI الأصلي، متجاوزًا أي شيء يوحي به اسم النموذج. كما يرفع خطأً ما لم تُضبط نقطة نهاية مخصّصة عبر `base_url` أو `api_base` أو `OPENAI_BASE_URL` أو `OPENAI_API_BASE`. ويُرسَل اسم النموذج كما هو، فيصل `broadnet/glm-5.3` إلى BroadNet دون تغيير.

ومن دون `custom_openai`، سيُقرأ اسم مثل `broadnet/glm-5.3` على أنه المزوّد `broadnet`، وهو مزوّد لا يعرفه CrewAI، فيعود إلى LiteLLM. والبديل الموثّق هو `model="openai/broadnet/glm-5.3"` مع `base_url`: إذ يحذف CrewAI البادئة `openai/` ويرسل الباقي.

وأمران آخران من شيفرة CrewAI وتوثيقه:

-   **حقل حد الرموز.** عندما تمرّر `max_tokens`، يرسل العميل الأصلي `max_tokens` في chat completions، وهو الحقل الذي يصفه المرجع التقني لـ BroadNet API. وإن مرّرت `max_completion_tokens`، فهو الذي يُرسَل بدلًا منه.
-   **ابقَ على chat completions.** يعرض توثيق CrewAI الخيار `api="responses"` للتبديل إلى Responses API. لا تضبطه؛ فـ BroadNet لا تُدرج هذه الواجهة.

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

| الوكيل | النموذج | السبب |
| --- | --- | --- |
| وكلاء يستخدمون الأدوات | `broadnet/glm-5.3` | تُدرج BroadNet الأدوات والمخرجات المنظَّمة؛ سياق 1M |
| إدخال صور أو نص عربي، مع الأدوات | `broadnet/qwen3.8-27b` | الأدوات مع الصور؛ سياق 262K |
| مهام قراءة طويلة، خطة ثابتة السعر | `broadnet/deepseek-v4.1-flash` | خطط غير محدودة؛ لا تُدرج BroadNet الأدوات له |

يمكن لفريق الوكلاء أن يمزج بينها: أعطِ كل `Agent` كائن `LLM` خاصًا به.

## حل المشكلات

-   **401.** المفتاح خاطئ أو منتهي الصلاحية أو استنفد رصيده. وإن لم تمرّر `api_key`، فقد قرأ CrewAI المتغير `OPENAI_API_KEY`، الذي قد يحمل مفتاح OpenAI.
-   **“custom\_openai=True requires base\_url”.** مرّر `base_url`، أو اضبط `OPENAI_BASE_URL`.
-   **النموذج غير موجود.** تأكّد أن المعرّف يطابق معرّف BroadNet تمامًا. النماذج المدفوعة تحتاج إلى شحن الرصيد؛ والرصيد البالغ $5 يغطي `broadnet/gemma-4-26b-a4b` ونموذجَي Transcribe.
-   **`EmptyLLMResponseError`.** يعيد CrewAI المحاولة مرة واحدة عند الإجابة الفارغة، ثم يرفع هذا الخطأ. ارفع `max_tokens`. راجع [لماذا تعود الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **429 مع عدة وكلاء.** يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 قيد التنفيذ، وجلسة الخطة تشغّل طلبًا واحدًا في كل مرة. راجع [الأخطاء وإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).

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

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

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

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

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

[Chat Completions API (واجهة إكمال المحادثة)](https://broadrouter.com/ar/glossary/chat-completions-api/)

Chat Completions API هي نقطة نهاية HTTP لدى OpenAI، أي POST /v1/chat/completions، تستقبل اسم نموذج وقائمة رسائل موسومة بأدوارها وتُرجع الرسالة التالية من النموذج. وصارت بنية طلبها واستجابتها الصيغة المشتركة التي يعيد استخدامها المزوّدون المتوافقون مع OpenAI وحزم SDK.

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

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

[الرصيد المدفوع مسبقًا (Prepaid credit)](https://broadrouter.com/ar/glossary/prepaid-credit/)

الرصيد المدفوع مسبقًا هو مال يُضاف إلى حساب API قبل الاستخدام. يُخصم من الرصيد ثمن كل طلب، وعندما ينفد الرصيد تتوقف الطلبات المحتسبة بالاستهلاك حتى تشحن رصيدك. وهو يحصر الإنفاق في حدود ما دفعته.

[العنوان الأساسي (Base URL)](https://broadrouter.com/ar/glossary/base-url/)

العنوان الأساسي (base URL) هو الجذر الثابت لعنوان الواجهة، مثل https://api.example.com/v1، الذي يضعه العميل قبل كل مسار نقطة نهاية، مثل /chat/completions. وفي حزم SDK المتوافقة مع OpenAI، يكفي تغيير العنوان الأساسي، مع مفتاح API ومعرّف النموذج، لتوجيه الشيفرة نفسها إلى مزوّد آخر.

[حد المعدل (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) وسجل المحادثة وتعريفات الأدوات والصور والمخرجات المولَّدة، بما فيها رموز الاستدلال المنطقي. وكل ما لا يتسع لها يجب قصّه أو تلخيصه أو توزيعه على عدة طلبات.

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

### ماذا يفعل custom\_openai=True في CrewAI؟

تقول الشيفرة المصدرية لـ CrewAI إنه يفرض مزوّد OpenAI الأصلي أيًّا كان شكل اسم النموذج، ويتطلب base\_url أو api\_base أو OPENAI\_BASE\_URL أو OPENAI\_API\_BASE. ويُرسَل اسم النموذج كما هو، فيصل broadnet/glm-5.3 إلى BroadNet دون تغيير.

### هل يمكنني كتابة model="openai/broadnet/glm-5.3" بدلًا من ذلك؟

نعم. مع base\_url مخصّص، يوجّه CrewAI البادئة openai/ إلى عميل OpenAI الأصلي ويحذفها، فتتلقى BroadNet المعرّف broadnet/glm-5.3. لكن custom\_openai=True هو الصيغة الأوضح.

### لماذا يفشل فريق الوكلاء بالخطأ EmptyLLMResponseError؟

يعيد CrewAI المحاولة مرة واحدة عندما تصل إجابة فارغة، أي بلا محتوى وبلا استدعاءات أدوات، ويرفع هذا الخطأ إذا جاءت الإعادة فارغة أيضًا. ومع نماذج الاستدلال في BroadNet يعني ذلك عادةً أن الاستدلال المنطقي استنفد ميزانية المخرجات. ارفع max\_tokens.

### أي نموذج من BroadNet يناسب وكلاء CrewAI؟

GLM 5.3 للوكلاء الذين يستخدمون الأدوات، لأن BroadNet تُدرج له الأدوات والمخرجات المنظَّمة. ونموذج Qwen3.8 27B يدعم الأدوات أيضًا ويقبل الصور.

## أدلة ذات صلة

-   [استخدام Pydantic AI مع BroadNet Inference (OpenAICompatibleProvider)](https://broadrouter.com/ar/guides/pydantic-ai-openai-compatible/)
-   [استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/)
-   [لماذا يعيد نموذج الاستدلال إجابة فارغة؟](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/)
-   [رموز أخطاء BroadNet Inference ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/)
-   [كل الأدوات التي تعمل مع BroadNet Inference (بالإنجليزية)](https://broadrouter.com/integrations/): حِزم SDK ووكلاء البرمجة وواجهات الدردشة وأدوات الأتمتة، مع الإعدادات الدقيقة لكل منها

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

[ابدأ الآن](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-crewai-custom-openai-endpoint&utm_content=page-cta) ·

**المصادر**

-   [توثيق CrewAI، النماذج اللغوية (OpenAI ونقطة نهاية مخصّصة متوافقة مع OpenAI) (رُوجع في 2026-11-15)](https://docs.crewai.com/en/concepts/llms)
-   [الشيفرة المصدرية لـ CrewAI، توجيه LLM مع custom\_openai (llm.py) (رُوجع في 2026-11-15)](https://github.com/crewAIInc/crewAI/blob/main/lib/crewai/src/crewai/llm.py)
-   [PyPI، الحزمة crewai 1.15.41، من Python 3.10 إلى 3.13 (رُوجع في 2026-11-15)](https://pypi.org/project/crewai/)
-   [المرجع التقني لـ BroadNet Inference API (رُوجع في 2026-11-15) (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-crewai-custom-openai-endpoint&utm_content=sources)
