---
title: "smolagents OpenAIModel، کسٹم api_base کے ساتھ | BroadRouter"
description: "Hugging Face smolagents کو OpenAIModel اور api_base سے BroadNet Inference سے جوڑیں: کسی بھی ماڈل پر CodeAgent، یا GLM 5.3 اور Qwen3.8 27B پر ToolCallingAgent۔"
url: https://broadrouter.com/ur/guides/smolagents-openai-compatible/
lang: ur
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

یہ صفحہ انگریزی سے AI کی مدد سے ترجمہ کیا گیا ہے۔ [انگریزی اصل پڑھیں](https://broadrouter.com/guides/smolagents-openai-compatible/) (اپ ڈیٹ: 2026-11-16).

# OpenAIModel کے ساتھ smolagents کو BroadNet Inference پر چلائیں

اپ ڈیٹ 2026-11-16

smolagents کا OpenAIModel بنائیں، model\_id کو broadnet/glm-5.3 جیسے BroadNet ID، 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، ایجنٹس کے لیے Hugging Face کی چھوٹی Python لائبریری ہے۔ اس کی `OpenAIModel` کلاس “connects to an OpenAI-compatible API server” (ترجمہ: OpenAI-compatible API سرور سے جڑتی ہے)، URL کے لیے `api_base` کے ساتھ۔ BroadNet Inference، `https://inference.broadnet.ai/v1` پر chat completions فراہم کرتا ہے، اس لیے یہ براہِ راست کام کرتا ہے۔ 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` ماڈل سے `<code>` ٹیگز کے درمیان Python لکھنے کو کہتا ہے اور اسے لوکل مشین پر چلاتا ہے۔ درخواست ایک سادہ chat completion ہے، `</code>` جیسی stop sequences کے ساتھ اور `tools` فیلڈ کے بغیر۔ یعنی یہ نیٹو ٹول کالنگ پر منحصر نہیں، اس لیے یہ `broadnet/deepseek-v4.1-flash` پر چل سکتا ہے، جو BroadNet کے [لامحدود پلانز](https://broadrouter.com/ur/guides/unlimited-llm-api-sessions/) والا ماڈل ہے۔ کوڈ کا معیار پھر بھی ماڈل کے لحاظ سے بدلتا ہے، اس لیے اپنے کاموں پر ٹیسٹ کریں۔

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/ur/pricing/)۔

## ہم نے اسے کیسے ٹیسٹ کیا

2026-11-15 کو ہم نے ایک صاف ورچوئل انوائرنمنٹ میں smolagents 1.26.0 انسٹال کیا اور دونوں ایجنٹس ایک لوکل موک سرور پر چلائے جو BroadNet کی chat-completions ساخت میں جواب دیتا ہے۔ DeepSeek ID پر `CodeAgent` کو کوڈ والا جواب ملا، اس نے اسے چلایا اور 42 لوٹایا۔ اس کی درخواستوں میں `max_tokens: 4000` اور stop sequences تھیں اور کوئی ٹول نہیں تھا۔ `ToolCallingAgent` کے لیے ہم نے درخواست کی ساخت جانچی: ماڈل ID بغیر تبدیلی کے بھیجا گیا، دونوں ٹول اسکیماز اور `tool_choice: "required"` کے ساتھ۔ smolagents ٹول کے نتائج user میسجز کے طور پر واپس بھیجتا ہے۔ ہمارا موک اس فارمیٹ کی پیروی نہیں کرتا تھا، اس لیے ہم نے اس ایجنٹ کو حتمی جواب تک نہیں چلایا۔ ہمارے پاس BroadNet کلید نہیں تھی، اس لیے ہم نے حقیقی ماڈل آؤٹ پٹ ٹیسٹ نہیں کیا۔

## مسائل کا حل

-   **401۔** کلید غلط ہے، ختم ہو چکی ہے یا الاؤنس ختم ہو گیا ہے۔
-   **404۔** `api_base` کو `/v1` پر ختم ہونا چاہیے۔ ماڈل ID جانچیں۔ پیڈ ماڈلز کے لیے ٹاپ اپ چاہیے؛ $5 کریڈٹ صرف `broadnet/gemma-4-26b-a4b` اور دو Transcribe ماڈلز کا احاطہ کرتا ہے۔
-   **“Make sure to provide correct code blobs”۔** ماڈل کے جواب میں کوئی کوڈ بلاک نہیں تھا۔ `max_tokens` بڑھائیں، کیونکہ ریزننگ اس میں گنی جاتی ہے، یا کوئی دوسرا ماڈل آزمائیں۔ [جوابات خالی کیوں آتے ہیں](https://broadrouter.com/ur/guides/reasoning-tokens-empty-response/)۔
-   **ToolCallingAgent کبھی ختم نہیں ہوتا۔** `broadnet/glm-5.3` یا `broadnet/qwen3.8-27b` پر جائیں۔
-   **429۔** استعمال کے مطابق ادائیگی والی کلید فی منٹ 30 درخواستوں کی اجازت دیتی ہے۔ smolagents، `requests_per_minute` سے اپنی رفتار خود محدود کر سکتا ہے۔ [ایررز اور ری ٹرائی](https://broadrouter.com/ur/guides/errors-and-retries/) دیکھیں۔

## اس گائیڈ کی اصطلاحات

[اسٹاپ سیکوئنس (stop sequences)](https://broadrouter.com/ur/glossary/stop-sequences/)

اسٹاپ سیکوئنس وہ اسٹرنگز ہیں جو آپ درخواست کے ساتھ بھیجتے ہیں تاکہ ماڈل ان میں سے کوئی بھی لکھتے ہی جنریشن روک دے۔ OpenAI اس فیلڈ کو stop کہتا ہے اور 4 سیکوئنس تک قبول کرتا ہے؛ Anthropic اسے stop\_sequences کہتا ہے۔ ملا ہوا متن عموماً لوٹائے گئے آؤٹ پٹ میں شامل نہیں ہوتا۔

[AI ایجنٹ (AI agent)](https://broadrouter.com/ur/glossary/agent/)

AI ایجنٹ ایسا نظام ہے جس میں لینگویج ماڈل کسی ہدف کی طرف اپنے قدم خود طے کرتا ہے: کون سے ٹولز کال کرنے ہیں، یہ چنتا ہے، نتائج پڑھتا ہے اور حتمی جواب یا کسی حد تک دہراتا رہتا ہے۔ مقررہ مقامات پر ماڈل کو کال کرنے والی اسکرپٹ کو عموماً workflow کہا جاتا ہے۔

[استعمال کے مطابق ادائیگی (pay-as-you-go)](https://broadrouter.com/ur/glossary/pay-as-you-go/)

استعمال کے مطابق ادائیگی (pay-as-you-go) قیمت طے کرنے کا ایک ماڈل ہے جس میں آپ صرف اتنا دیتے ہیں جتنا استعمال کرتے ہیں، ٹوکن، درخواستوں یا آڈیو منٹ جیسی اکائیوں میں ناپ کر، بغیر سبسکرپشن یا کم از کم وابستگی کے۔ زیادہ تر LLM API اسی طرح بل بناتے ہیں، پری پیڈ بیلنس یا وقتاً فوقتاً بننے والی انوائس سے۔

[OpenAI-compatible API](https://broadrouter.com/ur/glossary/openai-compatible-api/)

OpenAI-compatible API ایسا HTTP API ہے جو OpenAI API والی ہی درخواست اور ریسپانس کی ساخت قبول کرتا ہے، جیسے POST /v1/chat/completions، تاکہ OpenAI کے SDK اور ٹولز صرف base URL، API کلید اور ماڈل کا نام بدل کر اسے استعمال کر سکیں۔

[پری پیڈ کریڈٹ (prepaid credit)](https://broadrouter.com/ur/glossary/prepaid-credit/)

پری پیڈ کریڈٹ وہ رقم ہے جو استعمال سے پہلے API اکاؤنٹ میں ڈالی جاتی ہے۔ ہر درخواست کی لاگت بیلنس سے کٹتی ہے، اور بیلنس ختم ہونے پر میٹر والی درخواستیں تب تک رک جاتی ہیں جب تک آپ ٹاپ اپ نہ کریں۔ اس سے خرچ اتنا ہی رہتا ہے جتنا آپ نے جمع کیا ہے۔

[ٹول کالنگ (tool calling)](https://broadrouter.com/ur/glossary/tool-calling/)

ٹول کالنگ، جسے function calling بھی کہتے ہیں، LLM API کی وہ سہولت ہے جس میں ماڈل ڈویلپر کے طے کردہ کسی فنکشن کو چلانے کی ایک منظم درخواست، JSON آرگیومنٹس کے ساتھ، لوٹاتا ہے۔ ایپلیکیشن فنکشن چلا کر نتیجہ واپس بھیجتی ہے؛ ماڈل خود کبھی کوڈ نہیں چلاتا۔

[ریٹ لمٹ (rate limit)](https://broadrouter.com/ur/glossary/rate-limit/)

ریٹ لمٹ وہ حد ہے جو کوئی API طے کرتا ہے کہ ایک کلائنٹ کسی مدت میں اسے کتنا استعمال کر سکتا ہے، جیسے فی منٹ درخواستیں یا فی منٹ ٹوکن۔ حد سے زیادہ درخواستیں رد کر دی جاتی ہیں، عموماً HTTP 429 Too Many Requests کے ساتھ، جب تک استعمال دوبارہ حد سے نیچے نہ آ جائے۔

[Chat Completions API](https://broadrouter.com/ur/glossary/chat-completions-api/)

Chat Completions API، OpenAI کا HTTP اینڈپوائنٹ POST /v1/chat/completions ہے، جو ایک ماڈل کا نام اور رول والے پیغامات کی فہرست لیتا ہے اور ماڈل کا اگلا پیغام لوٹاتا ہے۔ اس کی درخواست اور جواب کی ساخت وہ عام فارمیٹ بن گئی جسے OpenAI-compatible فراہم کنندگان اور SDKs اپناتے ہیں۔

## عام سوالات

### OpenAIModel استعمال کریں یا OpenAIServerModel؟

smolagents 1.26 کسی بھی OpenAI-compatible سرور کے لیے OpenAIModel دستاویز کرتا ہے۔ پیکیج اب بھی OpenAIServerModel ایکسپورٹ کرتا ہے، مگر دستاویزات OpenAIModel بیان کرتی ہیں۔

### کیا smolagents، BroadNet کے لامحدود پلان پر چل سکتا ہے؟

پلانز DeepSeek V4.1 Flash کا احاطہ کرتے ہیں۔ BroadNet اس کے لیے ٹول کالنگ درج نہیں کرتا، مگر CodeAgent کو نیٹو ٹول کالز کی ضرورت نہیں؛ یہ ماڈل سے Python کوڈ مانگتا ہے۔ ہمارے موک ٹیسٹ میں DeepSeek ID پر CodeAgent نے tools فیلڈ کے بغیر سادہ چیٹ درخواستیں بھیجیں۔

### ToolCallingAgent کو GLM 5.3 یا Qwen3.8 27B کیوں چاہیے؟

یہ ٹولز کو OpenAI فنکشن اسکیما کے طور پر بھیجتا ہے، tool\_choice کو required پر رکھ کر۔ BroadNet کی دستاویزات صرف GLM 5.3 اور Qwen3.8 27B کے لیے ٹولز درج کرتی ہیں۔

### max\_tokens یا temperature کیسے پاس کریں؟

OpenAIModel کو کی ورڈ آرگیومنٹس کے طور پر۔ smolagents کی دستاویزات کہتی ہیں کہ اضافی آرگیومنٹس ہر completion کال کو آگے بھیجے جاتے ہیں۔ ہمارے ٹیسٹ میں ہر درخواست پر max\_tokens=4000 بھیجا گیا۔

## متعلقہ گائیڈز

-   [BroadNet Inference کے ساتھ OpenAI Python SDK استعمال کریں](https://broadrouter.com/ur/guides/openai-python-sdk/)
-   [ایجنٹس کے لیے لامحدود LLM API پلانز کیسے کام کرتے ہیں](https://broadrouter.com/ur/guides/unlimited-llm-api-sessions/)
-   [ریزننگ ماڈل خالی جواب کیوں لوٹاتا ہے](https://broadrouter.com/ur/guides/reasoning-tokens-empty-response/)
-   [BroadNet Inference کے ایرر کوڈز اور دوبارہ کوشش کب کریں](https://broadrouter.com/ur/guides/errors-and-retries/)
-   [BroadNet Inference کے ساتھ کام کرنے والے تمام ٹولز (انگریزی میں)](https://broadrouter.com/integrations/): SDKs، کوڈنگ ایجنٹس، چیٹ انٹرفیس اور آٹومیشن ٹولز، ہر ایک کی درست سیٹنگز کے ساتھ

اسے اپنے اصل کام پر آزمائیں۔ نئے اکاؤنٹس Gemma اور ٹرانسکرپشن کے لیے US$5 کے کریڈٹ سے شروع ہوتے ہیں۔ DeepSeek، GLM، اور Qwen3.8 کے لیے ٹاپ اپ ضروری ہے۔

[شروع کریں](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ur-guides-smolagents-openai-compatible&utm_content=page-cta) ·

**ذرائع**

-   [smolagents دستاویزات v1.26.0، Models ریفرنس (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=ur-guides-smolagents-openai-compatible&utm_content=sources)
