---
title: "OpenAIChatGenerator في Haystack مع api_base_url مخصّص"
description: "وجّه OpenAIChatGenerator في Haystack إلى BroadNet Inference عبر api_base_url ومعرّف نموذج BroadNet ومفتاح Secret، للخطوط (pipelines) والأدوات والتدفق والوكلاء."
url: https://broadrouter.com/ar/guides/haystack-openai-compatible/
lang: ar
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# استخدام خطوط Haystack ووكلائه مع BroadNet Inference

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

ثبّت haystack-ai وأنشئ OpenAIChatGenerator مع ضبط api\_base\_url على https://inference.broadnet.ai/v1، وapi\_key على Secret يُقرأ من BROADNET\_API\_KEY، وmodel على معرّف من BroadNet مثل broadnet/glm-5.3. استخدمه في الخطوط (pipelines) أو في Agent من Haystack. مرّر max\_tokens في generation\_kwargs، واستخدم GLM 5.3 أو Qwen3.8 27B حين يحمل المولّد أدوات.

Haystack إطار عمل مفتوح المصدر من deepset لبناء خطوط RAG والوكلاء. ويتصل المكوّن `OpenAIChatGenerator` فيه بأي خادم متوافق مع OpenAI عبر `api_base_url`. وبما أن BroadNet Inference تقدّم chat completions القياسية على `https://inference.broadnet.ai/v1`، فهذا هو المكوّن المناسب. BroadRouter هو موقع BroadNet نفسها؛ ويتبع هذا الدليل توثيق Haystack 3.5.

## التثبيت

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

## الاتصال

```python
from haystack.components.generators.chat import OpenAIChatGenerator
from haystack.dataclasses import ChatMessage
from haystack.utils import Secret

generator = OpenAIChatGenerator(
    api_base_url="https://inference.broadnet.ai/v1",
    api_key=Secret.from_env_var("BROADNET_API_KEY"),
    model="broadnet/glm-5.3",
    generation_kwargs={"max_tokens": 4000},
)

reply = generator.run([ChatMessage.from_user("Name three uses of a RAG pipeline.")])
print(reply["replies"][0].text)
```

-   **`model`** يُرسَل كما هو. استخدم معرّف BroadNet مع البادئة `broadnet/`.
-   **`api_key`** كائن `Secret` من Haystack. ومن دونه يبحث Haystack عن `OPENAI_API_KEY`.
-   **`generation_kwargs`** تُمرَّر إلى طلب chat completion. اضبط `max_tokens` على قيمة تكفي للاستدلال المنطقي (انظر أدناه).

## تدفق الإجابة (streaming)

```python
from haystack.components.generators.utils import print_streaming_chunk

generator = OpenAIChatGenerator(
    api_base_url="https://inference.broadnet.ai/v1",
    api_key=Secret.from_env_var("BROADNET_API_KEY"),
    model="broadnet/glm-5.3",
    streaming_callback=print_streaming_chunk,
)
```

عندها يرسل Haystack `stream: true` مع `stream_options.include_usage`، فتصل أعداد الرموز في آخر جزء من التدفق. ويصف توثيق BroadNet الخيار نفسه.

## الأدوات والوكلاء

```python
from haystack.components.agents import Agent
from haystack.tools import Tool

def get_weather(city: str) -> str:
    return f"21C in {city}"

weather = Tool(
    name="get_weather",
    description="Get the weather for a city",
    parameters={"type": "object", "properties": {"city": {"type": "string"}}, "required": ["city"]},
    function=get_weather,
)

chat = OpenAIChatGenerator(
    api_base_url="https://inference.broadnet.ai/v1",
    api_key=Secret.from_env_var("BROADNET_API_KEY"),
    model="broadnet/glm-5.3",
    tools=[weather],
)
agent = Agent(chat_generator=chat, tools=[weather])
result = agent.run(messages=[ChatMessage.from_user("What's the weather in Riyadh?")])
print(result["messages"][-1].text)
```

يُدرج توثيق BroadNet الأدوات والمخرجات المنظَّمة لـ `broadnet/glm-5.3` و`broadnet/qwen3.8-27b` فقط. أبقِ `tools_strict` على قيمته الافتراضية `False` ما لم تكن قد اختبرت المخططات الصارمة.

## أي نموذج تختار

| الخط (pipeline) | النموذج |
| --- | --- |
| الوكلاء واستدعاءات الأدوات | `broadnet/glm-5.3` |
| RAG على صفحات ممسوحة ضوئيًا أو نصوص عربية، مع الأدوات | `broadnet/qwen3.8-27b` |
| الإجابة بسياق طويل على خطة بسعر ثابت | `broadnet/deepseek-v4.1-flash` |
| التجربة بالرصيد المبدئي المجاني | `broadnet/gemma-4-26b-a4b` (سياق 32,768 رمزًا) |

قد يكون السياق المسترجَع كبيرًا. يقبل GLM 5.3 وDeepSeek V4.1 Flash سياقًا من 1,048,576 رمزًا، أما سياق Gemma البالغ 32,768 فيمتلئ بسرعة. [أسعار كل النماذج](https://broadrouter.com/ar/pricing/).

## كيف اختبرنا هذا

في 2026-11-15 ثبّتنا haystack-ai 3.5.0 في بيئة افتراضية نظيفة، وشغّلنا الأمثلة أعلاه، العادي والمتدفق والأدوات وAgent، على خادم وهمي (mock) محلي يتحدث بنية chat completions الخاصة بـ BroadNet، ثم قرأنا الطلبات المسجّلة. ذهبت كلها إلى `/v1/chat/completions` بمعرّف النموذج دون تغيير، ومفتاح Bearer، و`max_tokens` من `generation_kwargs`، ومع الأدوات مخطط الدالة. ويرسل Haystack أيضًا `n: 1`. لم يكن لدينا مفتاح BroadNet، لذا لم نختبر مخرجات نموذج حقيقية.

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

-   **401.** المفتاح خاطئ أو منتهي الصلاحية أو استنفد رصيده، أو أن `BROADNET_API_KEY` غير مضبوط في العملية التي تشغّل الخط.
-   **404.** يجب أن ينتهي `api_base_url` بـ `/v1`، وأن يطابق معرّف النموذج معرّف BroadNet تمامًا. النماذج المدفوعة تحتاج إلى شحن الرصيد؛ والرصيد البالغ $5 يغطي `broadnet/gemma-4-26b-a4b` ونموذجَي Transcribe.
-   **ردود فارغة.** نماذج DeepSeek V4.1 Flash وGLM 5.3 وQwen3.8 27B تستدل قبل أن تجيب، والاستدلال المنطقي يُحتسب ضمن `max_tokens`. ارفعه. راجع [لماذا تعود الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **429 أثناء الفهرسة الدفعية أو التقييم.** يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 قيد التنفيذ. استخدم المُعامل `max_retries` في المولّد، وراجع [الأخطاء وإعادة المحاولة](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 تكلفتها بهذه الطريقة، من رصيد مدفوع مسبقًا أو بفاتورة دورية.

[البث المتدفق (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 حتى تكتمل استجابته.

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

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

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

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

[RAG (التوليد المعزّز بالاسترجاع)](https://broadrouter.com/ar/glossary/rag/)

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

[التقييم (Eval)](https://broadrouter.com/ar/glossary/eval/)

التقييم (eval، اختصار evaluation) اختبار قابل للتكرار لنموذج لغوي أو أمر: مجموعة ثابتة من المدخلات، ووصف لما تبدو عليه المخرجات الجيدة، ومصحِّح (شيفرة أو إنسان أو نموذج آخر) يمنح كل مخرج درجة حتى يمكن المقارنة بين الإصدارات.

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

### أي مُعامل في Haystack يضبط عنوان BroadNet؟

المُعامل api\_base\_url في OpenAIChatGenerator. يصفه توثيق Haystack بأنه طريقة الوصول إلى عمليات النشر المخصّصة. اضبطه على https://inference.broadnet.ai/v1.

### هل أستخدم OpenAIResponsesChatGenerator مع BroadNet؟

لا. هذا المكوّن يستدعي Responses API من OpenAI، وBroadNet لا تُدرجها. استخدم OpenAIChatGenerator، فهو يستدعي chat completions.

### لماذا يفشل Haystack بسبب غياب OPENAI\_API\_KEY؟

القيمة الافتراضية لـ api\_key هي Secret.from\_env\_var("OPENAI\_API\_KEY"). مرّر api\_key=Secret.from\_env\_var("BROADNET\_API\_KEY") ليقرأ Haystack مفتاح BroadNet بدلًا منه.

### هل يستطيع Agent في Haystack استدعاء الأدوات على BroadNet؟

نعم، مع نموذج تُدرج له BroadNet الأدوات، أي GLM 5.3 أو Qwen3.8 27B. وفي اختبارنا على خادم وهمي (mock)، أرسل الوكيل مخطط الأداة عبر chat completions واستعاد استدعاء الأداة.

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

-   [استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/)
-   [استخدام LlamaIndex مع BroadNet Inference عبر OpenAILike](https://broadrouter.com/ar/guides/llamaindex-openailike/)
-   [لماذا يعيد نموذج الاستدلال إجابة فارغة؟](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-haystack-openai-compatible&utm_content=page-cta) ·

**المصادر**

-   [توثيق Haystack 3.5، صفحة OpenAIChatGenerator (رُوجع في 2026-11-15)](https://docs.haystack.deepset.ai/docs/openaichatgenerator)
-   [PyPI، الحزمة haystack-ai 3.5.0، تتطلب Python 3.11 أو أحدث (رُوجع في 2026-11-15)](https://pypi.org/project/haystack-ai/)
-   [المرجع التقني لـ BroadNet Inference API (رُوجع في 2026-11-15) (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-haystack-openai-compatible&utm_content=sources)
