---
title: "OpenAI Agents SDK مع مزوّد مخصّص متوافق مع OpenAI | BroadRouter"
description: "استخدم OpenAI Agents SDK لـ Python مع BroadNet Inference عبر AsyncOpenAI وOpenAIChatCompletionsModel، وأوقف التتبّع الذي يحتاج إلى مفتاح OpenAI."
url: https://broadrouter.com/ar/guides/openai-agents-sdk-custom-provider/
lang: ar
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# تشغيل OpenAI Agents SDK على BroadNet Inference

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

أنشئ عميل AsyncOpenAI مع ضبط base\_url على https://inference.broadnet.ai/v1 ووضع مفتاح BroadNet، ثم غلّفه في OpenAIChatCompletionsModel مع معرّف نموذج مثل broadnet/glm-5.3، ومرّر هذا النموذج إلى Agent. استدعِ set\_tracing\_disabled(True) ما لم يكن لديك مفتاح OpenAI منفصل للتتبّع.

OpenAI Agents SDK إطار عمل بلغة Python لبناء وكلاء يستخدمون الأدوات وعمليات التسليم (handoffs) وضوابط الحماية (guardrails). وتشرح وثائقه كيفية ربط مزوّدين من غير OpenAI. ومع واجهة API متوافقة مع OpenAI مثل BroadNet Inference، تعطي SDK عميل `AsyncOpenAI` خاصًا بك وتستخدم صنف نموذج Chat Completions. فالحزمة تستخدم Responses API افتراضيًا، وهي واجهة لا يقدّمها كثير من المزوّدين.

## الإعداد

1.  **ثبّت الحزمة.** تحتاج إلى Python 3.10 أو أحدث.

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

2.  **أنشئ العميل والنموذج والوكيل.**

```python
import asyncio
import os

from agents import (
    Agent,
    AsyncOpenAI,
    OpenAIChatCompletionsModel,
    Runner,
    function_tool,
    set_tracing_disabled,
)

set_tracing_disabled(disabled=True)  # tracing needs a platform.openai.com key

client = AsyncOpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)

model = OpenAIChatCompletionsModel(model="broadnet/glm-5.3", openai_client=client)

@function_tool
def get_order_status(order_id: str) -> str:
    """Look up an order."""
    return f"Order {order_id}: shipped"

agent = Agent(
    name="Support agent",
    instructions="Answer briefly. Use tools when you need order data.",
    model=model,
    tools=[get_order_status],
)

async def main():
    result = await Runner.run(agent, "Where is order 4471?")
    print(result.final_output)

asyncio.run(main())
```

3.  **شغّله.** يُفترض أن يستدعي الوكيل `get_order_status` ثم يجيب بناءً على نتيجتها.

## ثلاث طرق لربط المزوّد

تذكر وثائق SDK هذه الخيارات المدمجة:

-   **لكل وكيل:** مرّر `OpenAIChatCompletionsModel` في `Agent.model` كما في المثال أعلاه. استخدم هذه الطريقة عندما يستخدم كل وكيل مزوّدًا مختلفًا.
-   **افتراضي عام:** تجعل `set_default_openai_client(client)` عميلك هو العميل الافتراضي. استخدمها مع `set_default_openai_api("chat_completions")`.
-   **لكل تشغيل:** مرّر `ModelProvider` مخصّصًا في `RunConfig(model_provider=...)`.

وهكذا يبدو الإعداد الافتراضي العام:

```python
import os
from agents import (
    Agent,
    AsyncOpenAI,
    set_default_openai_api,
    set_default_openai_client,
    set_tracing_disabled,
)

client = AsyncOpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])
set_default_openai_client(client, use_for_tracing=False)
set_default_openai_api("chat_completions")
set_tracing_disabled(True)

agent = Agent(name="Assistant", instructions="Be brief.", model="broadnet/glm-5.3")
```

وإذا كنت تكتفي بمتغيرات البيئة، فاضبط `OPENAI_BASE_URL=https://inference.broadnet.ai/v1` واضبط `OPENAI_API_KEY` على مفتاح BroadNet، ثم نفّذ استدعاءَي `set_default_openai_api` و`set_tracing_disabled` نفسيهما.

عند التوجيه عبر Chat Completions، تقول وثائق SDK إنها تُسقط بصمت الحقول الخاصة بـ Responses فقط، مثل `previous_response_id` و`conversation_id` و`prompt`. وللحصول على خطأ بدلًا من ذلك، اضبط `strict_feature_validation=True` على `OpenAIProvider`. احتفظ بحالة المحادثة في شيفرتك، كأن تمرّر قائمة المدخلات من النتيجة السابقة إلى التشغيل التالي. أما أدوات OpenAI المستضافة، مثل البحث في الويب والبحث في الملفات، فلا وجود لها لدى المزوّدين الآخرين. استخدم `function_tool` لكل ما يجب أن يستدعيه الوكيل.

## التتبّع

التتبّع (tracing) مفعّل افتراضيًا ويرسل البيانات إلى OpenAI. وتقول وثائق SDK إنه إن لم يكن لديك مفتاح API من platform.openai.com فعليك تعطيله بـ `set_tracing_disabled()` أو إعداد معالج تتبّع آخر. وإذا كان لديك مفتاح OpenAI، فيمكنك إبقاء التتبّع مفعّلًا وتمرير ذلك المفتاح عبر `set_tracing_export_api_key(...)`. لا تستخدمه SDK إلا لرفع بيانات التتبّع، ولن يعمل مفتاح BroadNet لهذا الغرض.

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

| نوع الوكيل | النموذج | ملاحظات |
| --- | --- | --- |
| وكلاء يستخدمون الأدوات | [GLM 5.3](https://broadrouter.com/ar/models/glm-5.3/) | الأدوات والمخرجات المنظَّمة مدرجة؛ سياق 1M |
| إدخال الصور مع الأدوات | [Qwen3.8 27B](https://broadrouter.com/ar/models/qwen3.8-27b/) | سياق 262K؛ مُختبَر بالعربية |
| وكلاء طويلو التشغيل بسعر ثابت | [DeepSeek V4.1 Flash](https://broadrouter.com/ar/models/deepseek-v4.1-flash/) | خطط غير محدودة؛ لا يدرج BroadNet الأدوات له |

تحذّر وثائق SDK من أن بعض المزوّدين لا يدعمون المخرجات المنظَّمة وفق JSON schema. فإذا ضبطت `output_type` على وكيل، فاستخدم GLM 5.3 أو Qwen3.8 27B. قارن الأسعار في [صفحة الأسعار](https://broadrouter.com/ar/pricing/).

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

-   **401.** مفتاح BroadNet خاطئ أو منتهي الصلاحية، أو استُنفدت حصة الدفع حسب الاستخدام. أما أخطاء التتبّع في السجلات فأمر منفصل: تعني أن التتبّع ما زال مفعّلًا دون مفتاح OpenAI.
-   **404 أو “not found”.** الأرجح أنك تستخدم Responses API. استخدم `OpenAIChatCompletionsModel` أو `set_default_openai_api("chat_completions")`. وإذا كان ذلك مضبوطًا، فتأكّد من تطابق معرّف النموذج مع معرّف BroadNet تمامًا. تحتاج النماذج المدفوعة إلى شحن الرصيد؛ فرصيد $5 لا يغطي إلا Gemma 4 VL 26B ونموذجَي Transcribe.
-   **`final_output` فارغ.** يُحتسب الاستدلال المنطقي ضمن `max_tokens`. إذا ضبطت `ModelSettings(max_tokens=...)`، فارفع القيمة. [لماذا تصل الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **429.** يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 في آنٍ واحد. وكل جولة استدعاء أداة طلب جديد. راجع [الأخطاء وإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).
-   **وكلاء متوازون على خطة.** تشغّل [جلسة الخطة غير المحدودة](https://broadrouter.com/ar/guides/unlimited-llm-api-sessions/) طلبًا واحدًا في كل مرة. فالوكلاء الذين يُطلَقون معًا عبر `asyncio.gather` يحتاج كل منهم إلى جلسة، وإلا اصطفّوا في طابور. راجع [تشغيل وكلاء متوازين بسعر ثابت](https://broadrouter.com/ar/blog/run-parallel-coding-agents-flat-rate/).

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

[استدعاء الأدوات (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 تكلفتها بهذه الطريقة، من رصيد مدفوع مسبقًا أو بفاتورة دورية.

[ضوابط الحماية (Guardrails)](https://broadrouter.com/ar/glossary/guardrails/)

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

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

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

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

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

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

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

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

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

[مخطط JSON (JSON Schema)](https://broadrouter.com/ar/glossary/json-schema/)

JSON Schema (مخطط JSON) مفردات مكتوبة بصيغة JSON لوصف بنية بيانات JSON والتحقق منها: الأنواع والحقول الإلزامية والقيم المسموحة والتداخل. والإصدار الحالي هو 2020-12. وتستخدمه واجهات LLM API لتعريف معاملات الأدوات والبنية الدقيقة التي يجب أن تتبعها المخرجات المنظَّمة.

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

### لماذا تظهر أخطاء 404 من Agents SDK عند استخدام base URL مخصّص؟

تستخدم حزمة SDK الواجهة Responses API افتراضيًا، بينما يقدّم BroadNet إكمال المحادثات (chat completions). استخدم OpenAIChatCompletionsModel، أو استدعِ set\_default\_openai\_api("chat\_completions") إذا كنت تضبط العميل عبر متغيرات البيئة.

### لماذا تشتكي Agents SDK من التتبّع (tracing)؟

يرفع التتبّع البيانات إلى OpenAI ويحتاج إلى مفتاح من platform.openai.com. وتوصي وثائق SDK باستدعاء set\_tracing\_disabled() إن لم يكن لديك مفتاح، أو باستخدام معالج تتبّع آخر.

### هل يمكنني إعداد Agents SDK بمتغيرات البيئة فقط؟

نعم. اضبط OPENAI\_BASE\_URL على https://inference.broadnet.ai/v1 وOPENAI\_API\_KEY على مفتاح BroadNet، ثم استدعِ set\_default\_openai\_api("chat\_completions") وset\_tracing\_disabled(True). ويحدّد OPENAI\_DEFAULT\_MODEL النموذج للوكلاء الذين لا يسمّون نموذجًا.

### كم جلسة من جلسات الخطة يحتاج تشغيل متعدد الوكلاء؟

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

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

-   [استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/)
-   [كيف تعمل خطط LLM API غير المحدودة مع الوكلاء](https://broadrouter.com/ar/guides/unlimited-llm-api-sessions/)
-   [لماذا يعيد نموذج الاستدلال إجابة فارغة؟](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/)
-   [توجيه LiteLLM إلى BroadNet Inference (عبر SDK والوكيل)](https://broadrouter.com/ar/guides/litellm-proxy-custom-provider/)
-   [كل الأدوات التي تعمل مع 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-openai-agents-sdk-custom-provider&utm_content=page-cta) ·

**المصادر**

-   [وثائق OpenAI Agents SDK، صفحة Models (المزوّدون من غير OpenAI) (رُوجعت في 2026-11-14)](https://openai.github.io/openai-agents-python/models/)
-   [PyPI، الحزمة openai-agents (الإصدار 0.24، Python 3.10 فأحدث، رُوجعت في 2026-11-14)](https://pypi.org/project/openai-agents/)
-   [المرجع التقني لـ BroadNet Inference API (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-openai-agents-sdk-custom-provider&utm_content=sources)
