---
title: "OpenAI Agents SDK میں کسٹم OpenAI-compatible پرووائیڈر"
description: "AsyncOpenAI اور OpenAIChatCompletionsModel کے ذریعے Python والے OpenAI Agents SDK کو BroadNet Inference سے جوڑیں، اور OpenAI کلید مانگنے والی ٹریسنگ بند کریں۔"
url: https://broadrouter.com/ur/guides/openai-agents-sdk-custom-provider/
lang: ur
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# BroadNet Inference پر OpenAI Agents SDK چلائیں

اپ ڈیٹ 2026-11-16

base\_url https://inference.broadnet.ai/v1 اور اپنی BroadNet کلید کے ساتھ ایک AsyncOpenAI کلائنٹ بنائیں، اسے broadnet/glm-5.3 جیسے ماڈل ID کے ساتھ OpenAIChatCompletionsModel میں لپیٹیں اور وہ ماڈل اپنے Agent کو دیں۔ جب تک ٹریسنگ کے لیے آپ کے پاس الگ OpenAI کلید نہ ہو، set\_tracing\_disabled(True) کال کریں۔

OpenAI Agents SDK، ٹولز، ہینڈ آف اور گارڈ ریلز والے ایجنٹس بنانے کا Python فریم ورک ہے۔ اس کی دستاویزات بتاتی ہیں کہ non-OpenAI پرووائیڈرز کیسے جوڑے جائیں۔ BroadNet Inference جیسے OpenAI-compatible API کے لیے آپ SDK کو اپنا `AsyncOpenAI` کلائنٹ دیتے ہیں اور Chat Completions والی ماڈل کلاس استعمال کرتے ہیں۔ SDK ڈیفالٹ طور پر Responses API استعمال کرتا ہے، جو کئی پرووائیڈرز فراہم نہیں کرتے۔

## سیٹ اپ

1.  **SDK انسٹال کریں۔** اس کے لیے 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")` بھی لگائیں۔
-   **ہر رن کے لیے:** `RunConfig(model_provider=...)` میں ایک کسٹم `ModelProvider` دیں۔

گلوبل ڈیفالٹ ایسا دکھتا ہے:

```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` کالز کریں۔

SDK کی دستاویزات کہتی ہیں کہ Chat Completions کے ذریعے چلانے پر وہ صرف Responses والے فیلڈز، جیسے `previous_response_id`، `conversation_id` اور `prompt`، بغیر بتائے چھوڑ دیتا ہے۔ اس کی جگہ ایرر لینے کے لیے `OpenAIProvider` پر `strict_feature_validation=True` سیٹ کریں۔ گفتگو کی حالت اپنے کوڈ میں رکھیں، مثلاً پچھلے نتیجے کی ان پٹ لسٹ اگلے رن میں دے کر۔ OpenAI کے ہوسٹڈ ٹولز، جیسے ویب سرچ اور فائل سرچ، دوسرے پرووائیڈرز پر موجود نہیں ہیں۔ ایجنٹ جو کچھ بھی کال کرے، اس کے لیے `function_tool` استعمال کریں۔

## ٹریسنگ

ٹریسنگ ڈیفالٹ طور پر آن رہتی ہے اور ٹریسز OpenAI کو بھیجتی ہے۔ SDK کی دستاویزات کہتی ہیں کہ platform.openai.com کی API کلید نہ ہو تو اسے `set_tracing_disabled()` سے بند کریں یا کوئی دوسرا ٹریسنگ پراسیسر سیٹ کریں۔ اگر آپ کے پاس OpenAI کلید ہے تو ٹریسنگ آن رکھ کر وہ کلید `set_tracing_export_api_key(...)` سے دے سکتے ہیں۔ SDK اسے صرف ٹریسز اپ لوڈ کرنے کے لیے استعمال کرتا ہے۔ آپ کی BroadNet کلید اس کام کے لیے نہیں چلے گی۔

## کون سا ماڈل چنیں

| ایجنٹ کی قسم | ماڈل | نوٹس |
| --- | --- | --- |
| ٹولز استعمال کرنے والے ایجنٹس | [GLM 5.3](https://broadrouter.com/ur/models/glm-5.3/) | ٹولز اور اسٹرکچرڈ آؤٹ پٹ درج؛ 1M کانٹیکسٹ |
| ٹولز کے ساتھ امیج ان پٹ | [Qwen3.8 27B](https://broadrouter.com/ur/models/qwen3.8-27b/) | 262K کانٹیکسٹ؛ عربی میں ٹیسٹ کیا گیا |
| مقررہ ریٹ پر دیر تک چلنے والے ایجنٹس | [DeepSeek V4.1 Flash](https://broadrouter.com/ur/models/deepseek-v4.1-flash/) | لامحدود پلانز؛ BroadNet ٹولز درج نہیں کرتا |

SDK کی دستاویزات خبردار کرتی ہیں کہ کچھ پرووائیڈرز JSON-schema والا اسٹرکچرڈ آؤٹ پٹ سپورٹ نہیں کرتے۔ اگر آپ کسی ایجنٹ پر `output_type` سیٹ کرتے ہیں تو GLM 5.3 یا Qwen3.8 27B استعمال کریں۔ قیمتوں کا موازنہ [پرائسنگ صفحے](https://broadrouter.com/ur/pricing/) پر کریں۔

## مسائل کا حل

-   **401۔** BroadNet کلید غلط ہے، اس کی میعاد ختم ہو گئی ہے، یا استعمال کے مطابق ادائیگی والا الاؤنس ختم ہو گیا ہے۔ لاگز میں ٹریسنگ کی ایررز الگ معاملہ ہیں: ان کا مطلب ہے کہ ٹریسنگ اب بھی OpenAI کلید کے بغیر آن ہے۔
-   **404 یا “not found”۔** غالباً آپ Responses API پر ہیں۔ `OpenAIChatCompletionsModel` یا `set_default_openai_api("chat_completions")` استعمال کریں۔ اگر یہ سیٹ ہے تو جانچیں کہ ماڈل ID بالکل BroadNet والے ID جیسا ہے۔ پیڈ ماڈلز کے لیے ٹاپ اپ چاہیے؛ $5 کریڈٹ Gemma 4 VL 26B اور دو Transcribe ماڈلز کو کور کرتا ہے۔
-   **خالی `final_output`۔** ریزننگ `max_tokens` میں گنی جاتی ہے۔ اگر آپ نے `ModelSettings(max_tokens=...)` سیٹ کیا ہے تو اسے بڑھائیں۔ [جوابات خالی کیوں آتے ہیں](https://broadrouter.com/ur/guides/reasoning-tokens-empty-response/)۔
-   **429۔** استعمال کے مطابق ادائیگی والی کلید فی منٹ 30 درخواستوں اور بیک وقت 4 درخواستوں کی اجازت دیتی ہے۔ ہر ٹول راؤنڈ ٹرپ ایک نئی درخواست ہے۔ [ایررز اور دوبارہ کوشش](https://broadrouter.com/ur/guides/errors-and-retries/) دیکھیں۔
-   **پلان پر متوازی ایجنٹس۔** ایک [لامحدود پلان سیشن](https://broadrouter.com/ur/guides/unlimited-llm-api-sessions/) ایک وقت میں ایک ہی درخواست چلاتا ہے۔ `asyncio.gather` سے اکٹھے شروع کیے گئے ایجنٹس میں سے ہر ایک کو الگ سیشن چاہیے، ورنہ وہ قطار میں لگتے ہیں۔ [مقررہ ریٹ پر متوازی ایجنٹس چلانے](https://broadrouter.com/ur/blog/run-parallel-coding-agents-flat-rate/) کے بارے میں پڑھیں۔

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

[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 اسی طرح بل بناتے ہیں، پری پیڈ بیلنس یا وقتاً فوقتاً بننے والی انوائس سے۔

[اسٹرکچرڈ آؤٹ پٹ (structured output)](https://broadrouter.com/ur/glossary/structured-output/)

اسٹرکچرڈ آؤٹ پٹ LLM API کا ایک فیچر ہے جو ماڈل کے جواب کو ڈویلپر کے طے کردہ فارمیٹ، عموماً JSON Schema، تک محدود کرتا ہے، تاکہ کوڈ اسے قابلِ اعتماد طریقے سے پارس کر سکے۔ یہ JSON mode سے زیادہ سخت ہے، جو درست JSON کی ضمانت دیتا ہے، لیکن کسی خاص ساخت کی نہیں۔

[کنکرنسی (concurrency)](https://broadrouter.com/ur/glossary/concurrency/)

کنکرنسی، کسی کلائنٹ کی بیک وقت چل رہی (in-flight) درخواستوں کی تعداد ہے۔ LLM APIs اکثر اس کی حد ہر کلید یا پلان پر، فی منٹ درخواستوں سے الگ رکھتے ہیں، کیونکہ ہر کھلی درخواست جواب مکمل ہونے تک GPU کی گنجائش گھیرے رکھتی ہے۔

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

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

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

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

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

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

[API کلید (API key)](https://broadrouter.com/ur/glossary/api-key/)

API کلید ایک خفیہ اسٹرنگ ہے جو API کال کرنے والے کلائنٹ کی شناخت کرتی اور اسے اجازت دیتی ہے۔ LLM API عموماً اسے Authorization: Bearer ہیڈر میں چاہتے ہیں، اور جس کے پاس بھی یہ کلید ہو وہ ایسی درخواستیں کر سکتا ہے جن کا بل کلید والے اکاؤنٹ پر بنتا ہے۔

## عام سوالات

### کسٹم base URL کے ساتھ Agents SDK سے 404 ایررز کیوں آتے ہیں؟

SDK ڈیفالٹ طور پر Responses API استعمال کرتا ہے، جبکہ BroadNet چیٹ کمپلیشنز فراہم کرتا ہے۔ OpenAIChatCompletionsModel استعمال کریں، یا اگر آپ کلائنٹ کو انوائرنمنٹ ویری ایبلز سے کنفیگر کرتے ہیں تو set\_default\_openai\_api("chat\_completions") کال کریں۔

### Agents SDK ٹریسنگ کے بارے میں شکایت کیوں کرتا ہے؟

ٹریسنگ، ڈیٹا 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 سے طے ہوتا ہے۔

### ملٹی ایجنٹ رن کے لیے کتنے پلان سیشن چاہییں؟

بیک وقت چلنے والی ہر درخواست کے لیے ایک۔ ہینڈ آف میں ایجنٹس ایک کے بعد ایک چلتے ہیں، اس لیے ایک سیشن کافی ہے۔ asyncio.gather سے متوازی چلنے والے ایجنٹس میں سے ہر ایک کو الگ سیشن چاہیے۔

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

-   [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/)
-   [LiteLLM کو BroadNet Inference پر روٹ کریں (SDK اور پراکسی)](https://broadrouter.com/ur/guides/litellm-proxy-custom-provider/)
-   [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-openai-agents-sdk-custom-provider&utm_content=page-cta) ·

**ذرائع**

-   [OpenAI Agents SDK دستاویزات، Models (non-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=ur-guides-openai-agents-sdk-custom-provider&utm_content=sources)
