---
title: "smolagents مع OpenAIModel و api_base مخصّص | BroadRouter"
description: "اربط smolagents من Hugging Face بـ BroadNet Inference عبر OpenAIModel وapi_base، لتشغيل CodeAgent على أي نموذج أو ToolCallingAgent على GLM 5.3 وQwen3.8 27B."
url: https://broadrouter.com/ar/guides/smolagents-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/smolagents-openai-compatible/) (حُدّث في 2026-11-16).

# تشغيل smolagents على BroadNet Inference عبر OpenAIModel

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

أنشئ OpenAIModel في smolagents مع ضبط model\_id على معرّف من BroadNet مثل broadnet/glm-5.3، وapi\_base على https://inference.broadnet.ai/v1، وapi\_key على مفتاح BroadNet، ثم مرّره إلى CodeAgent أو ToolCallingAgent. يكتب CodeAgent شيفرة Python بدلًا من استدعاءات الأدوات الأصلية، لذا يمكنه العمل على DeepSeek V4.1 Flash. أما ToolCallingAgent فيحتاج إلى GLM 5.3 أو Qwen3.8 27B.

smolagents مكتبة Python صغيرة من Hugging Face لبناء الوكلاء. والصنف `OpenAIModel` فيها “connects to an OpenAI-compatible API server” (ترجمة: يتصل بخادم API متوافق مع OpenAI)، مع `api_base` لتحديد الرابط. وتقدّم BroadNet Inference واجهة chat completions على `https://inference.broadnet.ai/v1`، فيعمل الربط مباشرة. BroadRouter هو موقع BroadNet نفسها؛ ويتبع هذا الدليل توثيق smolagents 1.26.0.

## التثبيت

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

## CodeAgent

```python
import os
from smolagents import OpenAIModel, CodeAgent

model = OpenAIModel(
    model_id="broadnet/deepseek-v4.1-flash",
    api_base="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
    max_tokens=4000,
)

agent = CodeAgent(tools=[], model=model)
print(agent.run("What is 6 * 7? Use Python to check."))
```

يطلب `CodeAgent` من النموذج أن يكتب شيفرة Python بين وسمَي `<code>` ثم يشغّلها محليًا. والطلب استدعاء chat completion عادي مع تسلسلات إيقاف (stop sequences) مثل `</code>`، ومن دون حقل `tools`. أي أنه لا يعتمد على استدعاء الأدوات الأصلي، لذا يمكنه العمل على `broadnet/deepseek-v4.1-flash`، نموذج [الخطط غير المحدودة](https://broadrouter.com/ar/guides/unlimited-llm-api-sessions/) من BroadNet. لكن جودة الشيفرة تختلف من نموذج إلى آخر، فاختبر مهامك أنت.

يشغّل CodeAgent شيفرةً يكتبها النموذج. اقرأ إرشادات smolagents حول التنفيذ الآمن للشيفرة قبل أن تمنحه أدوات تصل إلى الملفات أو الشبكات أو بيانات الاعتماد.

## ToolCallingAgent

```python
from smolagents import ToolCallingAgent, tool

@tool
def get_weather(city: str) -> str:
    """Get the weather for a city.

    Args:
        city: The city name.
    """
    return f"21C in {city}"

model = OpenAIModel(
    model_id="broadnet/glm-5.3",
    api_base="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
    max_tokens=4000,
)
agent = ToolCallingAgent(tools=[get_weather], model=model)
print(agent.run("What's the weather in Riyadh?"))
```

يرسل `ToolCallingAgent` أدواتك، ومعها أداته الخاصة `final_answer`، بوصفها مخططات دوال مع `tool_choice: "required"`. استخدم `broadnet/glm-5.3` أو `broadnet/qwen3.8-27b`؛ فتوثيق BroadNet لا يُدرج الأدوات إلا لهذين النموذجين.

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

| الوكيل | النموذج |
| --- | --- |
| `CodeAgent`، تشغيل طويل على خطة بسعر ثابت | `broadnet/deepseek-v4.1-flash` |
| `ToolCallingAgent` | `broadnet/glm-5.3` |
| أيٌّ من الوكيلين مع إدخال الصور | `broadnet/qwen3.8-27b` |

جلسة الخطة تشغّل طلبًا واحدًا في كل مرة، والوكيل يرسل خطواته واحدة تلو الأخرى، لذا تناسب الجلسةُ الواحدة وكيلًا واحدًا. [أسعار كل النماذج](https://broadrouter.com/ar/pricing/).

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

في 2026-11-15 ثبّتنا smolagents 1.26.0 في بيئة افتراضية نظيفة، وشغّلنا الوكيلين كليهما على خادم وهمي محلي يتحدث بنية chat completions الخاصة بـ BroadNet. تلقّى `CodeAgent` على معرّف DeepSeek ردًا يحتوي شيفرة، فشغّلها وأعاد 42. وكانت طلباته تتضمن `max_tokens: 4000` وتسلسلات إيقاف، ولا أدوات. أما `ToolCallingAgent` فتحققنا من بنية طلبه: أُرسل معرّف النموذج دون تغيير، مع مخططَي الأداتين و`tool_choice: "required"`. ويعيد smolagents نتائج الأدوات في رسائل user، ولم يكن خادمنا الوهمي يتبع هذه الصيغة، لذا لم نشغّل ذلك الوكيل حتى إجابة نهائية. لم يكن لدينا مفتاح BroadNet، لذا لم نختبر مخرجات نموذج حقيقية.

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

-   **401.** المفتاح خاطئ أو منتهي الصلاحية أو استنفد رصيده.
-   **404.** يجب أن ينتهي `api_base` بـ `/v1`. وتحقّق من معرّف النموذج. النماذج المدفوعة تحتاج إلى شحن الرصيد؛ والرصيد البالغ $5 يغطي `broadnet/gemma-4-26b-a4b` ونموذجَي Transcribe.
-   **“Make sure to provide correct code blobs”.** (ترجمة: تأكّد من تقديم كتل شيفرة صحيحة.) لم يتضمن رد النموذج كتلة شيفرة. ارفع `max_tokens`، لأن الاستدلال يُحتسب ضمنه، أو جرّب نموذجًا آخر. راجع [لماذا تعود الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **ToolCallingAgent لا ينتهي أبدًا.** انتقل إلى `broadnet/glm-5.3` أو `broadnet/qwen3.8-27b`.
-   **429.** يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة. ويمكن لـ smolagents أن يحدّ من معدل طلباته بنفسه عبر `requests_per_minute`. راجع [الأخطاء وإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).

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

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

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

[تسلسلات التوقف (Stop sequences)](https://broadrouter.com/ar/glossary/stop-sequences/)

تسلسلات التوقف هي نصوص ترسلها مع الطلب فيتوقف النموذج عن التوليد فور أن يُنتج أحدها. تسمّي OpenAI الحقل stop وتقبل فيه 4 تسلسلات كحد أقصى، وتسمّيه Anthropic باسم stop\_sequences. وعادةً لا يُضمَّن النص المطابق في المخرجات المُعادة.

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

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

[واجهة API متوافقة مع OpenAI (OpenAI-compatible API)](https://broadrouter.com/ar/glossary/openai-compatible-api/)

واجهة API المتوافقة مع OpenAI هي واجهة HTTP تقبل صيغ الطلبات والاستجابات نفسها التي تستخدمها OpenAI API، مثل POST /v1/chat/completions، فتستطيع حزم OpenAI SDK وأدواتها استخدامها بتغيير العنوان الأساسي (base URL) ومفتاح API واسم النموذج فقط.

[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، إلى أن يعود الاستخدام تحت الحد.

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

### هل أستخدم OpenAIModel أم OpenAIServerModel؟

يوثّق smolagents 1.26 الصنف OpenAIModel لأي خادم متوافق مع OpenAI. وما زالت الحزمة تُصدّر OpenAIServerModel، لكن التوثيق يصف OpenAIModel.

### هل يمكن تشغيل smolagents على الخطة غير المحدودة من BroadNet؟

تغطي الخطط نموذج DeepSeek V4.1 Flash. ولا تُدرج BroadNet استدعاء الأدوات له، لكن CodeAgent لا يحتاج إلى استدعاءات أدوات أصلية؛ فهو يطلب من النموذج شيفرة Python. وفي اختبارنا على خادم وهمي، أرسل CodeAgent على معرّف DeepSeek طلبات محادثة عادية بلا حقل tools.

### لماذا يحتاج ToolCallingAgent إلى GLM 5.3 أو Qwen3.8 27B؟

لأنه يرسل الأدوات بوصفها مخططات دوال OpenAI مع ضبط tool\_choice على required. وتوثيق BroadNet لا يُدرج الأدوات إلا لنموذجَي GLM 5.3 وQwen3.8 27B.

### كيف أمرّر max\_tokens أو temperature؟

بوصفها وسائط مسمّاة إلى OpenAIModel. يقول توثيق smolagents إن الوسائط الإضافية تُمرَّر إلى كل استدعاء إكمال. وفي اختبارنا أُرسل max\_tokens=4000 مع كل طلب.

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

-   [استخدام 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/)
-   [رموز أخطاء 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-smolagents-openai-compatible&utm_content=page-cta) ·

**المصادر**

-   [توثيق smolagents الإصدار v1.26.0، مرجع النماذج (OpenAIModel) (رُوجع في 2026-11-15)](https://huggingface.co/docs/smolagents/reference/models)
-   [PyPI، الحزمة smolagents 1.26.0 (رُوجعت في 2026-11-15)](https://pypi.org/project/smolagents/)
-   [المرجع التقني لـ BroadNet Inference API (رُوجع في 2026-11-15) (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-smolagents-openai-compatible&utm_content=sources)
