---
title: "OpenAI Agents SDK ile özel OpenAI uyumlu sağlayıcı | BroadRouter"
description: "Python için OpenAI Agents SDK'yı AsyncOpenAI ve OpenAIChatCompletionsModel ile BroadNet Inference'a bağlayın, OpenAI anahtarı isteyen tracing'i kapatın."
url: https://broadrouter.com/tr/guides/openai-agents-sdk-custom-provider/
lang: tr
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

İngilizceden yapay zekâ desteğiyle çevrilmiştir. [İngilizce aslını okuyun](https://broadrouter.com/guides/openai-agents-sdk-custom-provider/) (güncelleme: 2026-11-16).

# OpenAI Agents SDK'yı BroadNet Inference üzerinde çalıştırın

Güncellendi 2026-11-16

base\_url değeri https://inference.broadnet.ai/v1 ve BroadNet anahtarınızla bir AsyncOpenAI istemcisi oluşturun, bunu broadnet/glm-5.3 gibi bir model kimliğiyle OpenAIChatCompletionsModel içine sarın ve bu modeli Agent'a verin. Tracing için ayrı bir OpenAI anahtarınız yoksa set\_tracing\_disabled(True) çağırın.

OpenAI Agents SDK; araçlar, devirler (handoffs) ve korkuluklar (guardrails) içeren ajanlar için bir Python çerçevesidir. Belgeleri, OpenAI dışı sağlayıcıların nasıl bağlanacağını anlatır. BroadNet Inference gibi OpenAI uyumlu bir API için SDK’ya kendi `AsyncOpenAI` istemcinizi verir ve Chat Completions model sınıfını kullanırsınız. SDK varsayılan olarak Responses API’yi kullanır; pek çok sağlayıcı ise bu API’yi sunmaz.

## Kurulum

1.  **SDK’yı kurun.** Python 3.10 veya daha yenisi gerekir.

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

2.  **İstemciyi, modeli ve ajanı oluşturun.**

```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.  **Çalıştırın.** Ajan `get_order_status` aracını çağırmalı ve yanıtını bu aracın sonucuna dayandırmalıdır.

## Sağlayıcıyı bağlamanın üç yolu

SDK belgeleri şu yerleşik seçenekleri listeler:

-   **Ajan başına:** yukarıdaki gibi `OpenAIChatCompletionsModel`’i `Agent.model` olarak verin. Farklı ajanlar farklı sağlayıcılar kullanıyorsa bunu tercih edin.
-   **Genel varsayılan:** `set_default_openai_client(client)` istemcinizi varsayılan yapar. Bunu `set_default_openai_api("chat_completions")` ile birlikte kullanın.
-   **Çalıştırma başına:** `RunConfig(model_provider=...)` içinde özel bir `ModelProvider` verin.

Genel varsayılan şöyle görünür:

```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")
```

Yalnızca ortam değişkenleriyle çalışacaksanız `OPENAI_BASE_URL=https://inference.broadnet.ai/v1` ayarlayın ve `OPENAI_API_KEY` değişkenine BroadNet anahtarınızı yazın; ardından aynı `set_default_openai_api` ve `set_tracing_disabled` çağrılarını yapın.

SDK belgelerine göre Chat Completions üzerinden yönlendirdiğinizde SDK, yalnızca Responses’a özgü `previous_response_id`, `conversation_id` ve `prompt` gibi alanları sessizce düşürür. Bunun yerine hata almak için `OpenAIProvider` üzerinde `strict_feature_validation=True` ayarlayın. Konuşma durumunu kendi kodunuzda tutun; örneğin önceki sonucun girdi listesini bir sonraki çalıştırmaya aktarın. Web araması ve dosya araması gibi OpenAI’nin barındırdığı araçlar başka sağlayıcılarda yoktur. Ajanın çağırması gereken her şey için `function_tool` kullanın.

## Tracing

Tracing varsayılan olarak açıktır ve izleri OpenAI’ye gönderir. SDK belgeleri, platform.openai.com’dan alınmış bir API anahtarınız yoksa tracing’i `set_tracing_disabled()` ile kapatmanızı ya da farklı bir tracing işlemcisi kurmanızı söyler. Bir OpenAI anahtarınız varsa tracing’i açık bırakıp bu anahtarı `set_tracing_export_api_key(...)` ile verebilirsiniz. SDK onu yalnızca izleri yüklemek için kullanır. BroadNet anahtarınız bu iş için çalışmaz.

## Hangi modeli seçmeli

| Ajan türü | Model | Notlar |
| --- | --- | --- |
| Araç kullanan ajanlar | [GLM 5.3](https://broadrouter.com/tr/models/glm-5.3/) | Araçlar ve yapılandırılmış çıktı listeleniyor; 1M bağlam |
| Araçlarla görsel girdi | [Qwen3.8 27B](https://broadrouter.com/tr/models/qwen3.8-27b/) | 262K bağlam; Arapçada test edildi |
| Sabit fiyatla uzun süre çalışan ajanlar | [DeepSeek V4.1 Flash](https://broadrouter.com/tr/models/deepseek-v4.1-flash/) | Sınırsız planlar; araçlar BroadNet tarafından listelenmiyor |

SDK belgeleri, bazı sağlayıcıların JSON şemalı yapılandırılmış çıktıları desteklemediği konusunda uyarır. Bir ajanda `output_type` ayarlıyorsanız GLM 5.3 veya Qwen3.8 27B kullanın. Fiyatları [fiyatlandırma sayfasında](https://broadrouter.com/tr/pricing/) karşılaştırın.

## Sorun giderme

-   **401.** BroadNet anahtarı yanlış, süresi dolmuş veya kullandıkça öde hakkı tükenmiş. Günlüklerdeki tracing hataları ayrı bir konudur: tracing’in OpenAI anahtarı olmadan hâlâ açık olduğunu gösterir.
-   **404 veya “not found”.** Büyük olasılıkla Responses API’yi kullanıyorsunuz. `OpenAIChatCompletionsModel` ya da `set_default_openai_api("chat_completions")` kullanın. Bu zaten ayarlıysa model kimliğinin BroadNet’inkiyle birebir aynı olduğunu kontrol edin. Ücretli modeller bakiye yüklemesi gerektirir; $5 kredi yalnızca Gemma 4 VL 26B modelini kapsar.
-   **Boş `final_output`.** Akıl yürütme `max_tokens` sınırına dahildir. `ModelSettings(max_tokens=...)` ayarladıysanız değeri yükseltin. [Yanıtlar neden boş geliyor](https://broadrouter.com/tr/guides/reasoning-tokens-empty-response/).
-   **429.** Kullandıkça öde anahtarı dakikada 30 isteğe ve aynı anda 4 isteğe izin verir. Her araç gidiş-dönüşü yeni bir istektir. [Hatalar ve yeniden denemeler](https://broadrouter.com/tr/guides/errors-and-retries/) rehberine bakın.
-   **Bir planda paralel ajanlar.** Bir [sınırsız plan oturumu](https://broadrouter.com/tr/guides/unlimited-llm-api-sessions/) aynı anda tek istek çalıştırır. `asyncio.gather` ile birlikte başlatılan ajanların her biri ayrı bir oturum ister, aksi halde sıraya girerler. [Sabit fiyatla paralel ajan çalıştırma](https://broadrouter.com/tr/blog/run-parallel-coding-agents-flat-rate/) yazısına bakın.

## Bu rehberdeki terimler

[Kullandıkça öde (pay-as-you-go)](https://broadrouter.com/tr/glossary/pay-as-you-go/)

Kullandıkça öde, abonelik veya asgari taahhüt olmadan yalnızca kullandığınız kadar ödediğiniz, token, istek veya ses dakikası gibi birimler üzerinden ölçülen bir fiyatlandırma modelidir. LLM API'lerinin çoğu bu şekilde, ön ödemeli bir bakiyeden veya dönemsel faturayla ücretlendirir.

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

Chat Completions API, OpenAI'nin bir model adı ile rollerle etiketlenmiş mesaj listesini alıp modelin sonraki mesajını döndüren HTTP uç noktasıdır: POST /v1/chat/completions. İstek ve yanıt yapısı, OpenAI uyumlu sağlayıcıların ve SDK'ların yeniden kullandığı ortak format hâline geldi.

[Eşzamanlılık (concurrency)](https://broadrouter.com/tr/glossary/concurrency/)

Eşzamanlılık (concurrency), bir istemcinin aynı anda işlemde olan istek sayısıdır. LLM API'leri bunu genellikle dakikadaki istek sayısından ayrı olarak anahtar veya plan başına sınırlar, çünkü açık her istek yanıtı bitene kadar GPU kapasitesi tutar.

[Guardrails (koruma bariyerleri)](https://broadrouter.com/tr/glossary/guardrails/)

Guardrails (koruma bariyerleri), bir uygulamanın dil modeli çağrısını belirlenen sınırlar içinde tutmak için çağrının etrafında çalıştırdığı denetimlerdir. Girdi guardrail'leri modele gireni, çıktı guardrail'leri modelden çıkanı denetler, araç guardrail'leri ise eylemleri çalışmadan önce doğrular. Başarısız bir denetim isteği engeller, yeniden yazar veya işaretler.

[Hız sınırı (rate limit)](https://broadrouter.com/tr/glossary/rate-limit/)

Hız sınırı (rate limit), bir API'nin bir istemcinin belirli bir zaman aralığındaki kullanımına koyduğu üst sınırdır; örneğin dakika başına istek veya dakika başına token. Sınırı aşan istekler, kullanım tekrar sınırın altına inene kadar genellikle HTTP 429 Too Many Requests ile reddedilir.

[Yapılandırılmış çıktı (structured output)](https://broadrouter.com/tr/glossary/structured-output/)

Yapılandırılmış çıktı, modelin yanıtını geliştiricinin belirlediği bir biçimle, genellikle bir JSON Schema ile sınırlayan bir LLM API özelliğidir; böylece kod yanıtı güvenilir şekilde ayrıştırabilir. Geçerli JSON'u garanti eden ama belirli bir yapıyı garanti etmeyen JSON modundan daha katıdır.

## Sık sorulan sorular

### Agents SDK özel base URL ile neden 404 hatası veriyor?

SDK varsayılan olarak Responses API'yi kullanır, BroadNet ise chat completions sunar. OpenAIChatCompletionsModel kullanın ya da istemciyi ortam değişkenleriyle yapılandırıyorsanız set\_default\_openai\_api("chat\_completions") çağırın.

### Agents SDK neden tracing hatası veriyor?

Tracing verileri OpenAI'ye yükler ve platform.openai.com'dan alınmış bir anahtar ister. SDK belgeleri, böyle bir anahtarınız yoksa set\_tracing\_disabled() kullanmanızı ya da farklı bir tracing işlemcisi kurmanızı önerir.

### Agents SDK'yı yalnızca ortam değişkenleriyle yapılandırabilir miyim?

Evet. OPENAI\_BASE\_URL'yi https://inference.broadnet.ai/v1, OPENAI\_API\_KEY'i BroadNet anahtarınız olarak ayarlayın, ardından set\_default\_openai\_api("chat\_completions") ve set\_tracing\_disabled(True) çağırın. OPENAI\_DEFAULT\_MODEL, model belirtmeyen ajanların modelini belirler.

### Çok ajanlı bir çalıştırma için kaç plan oturumu gerekir?

Aynı anda çalışan her istek için bir oturum. Devirlerde (handoff) ajanlar birbiri ardına çalışır, bu yüzden tek oturum yeterlidir. asyncio.gather ile paralel çalışan ajanların her biri ayrı bir oturum ister.

## İlgili rehberler

-   [OpenAI Python SDK'yı BroadNet Inference ile kullanın](https://broadrouter.com/tr/guides/openai-python-sdk/)
-   [Ajanlar için sınırsız LLM API planları nasıl çalışır?](https://broadrouter.com/tr/guides/unlimited-llm-api-sessions/)
-   [Akıl yürüten model neden boş yanıt döndürür?](https://broadrouter.com/tr/guides/reasoning-tokens-empty-response/)
-   [LiteLLM'i BroadNet Inference'a yönlendirin (SDK ve proxy)](https://broadrouter.com/tr/guides/litellm-proxy-custom-provider/)
-   [BroadNet Inference ile çalışan tüm araçlar (İngilizce)](https://broadrouter.com/integrations/): SDK'lar, kodlama ajanları, sohbet arayüzleri ve otomasyon araçları, her biri için tam ayarlarıyla

Gerçek iş yükünüzle deneyin. Yeni hesaplar şunlar için US$5 kredi ile başlar: Gemma ve transkripsiyon. Bakiye yüklemesi gerekenler: DeepSeek, GLM ve Qwen3.8.

[Başlayın](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-guides-openai-agents-sdk-custom-provider&utm_content=page-cta) ·

**Kaynaklar**

-   [OpenAI Agents SDK belgeleri, Models (OpenAI dışı sağlayıcılar) (2026-11-14 tarihinde kontrol edildi)](https://openai.github.io/openai-agents-python/models/)
-   [PyPI, openai-agents paketi (0.24, Python 3.10+, 2026-11-14 tarihinde kontrol edildi)](https://pypi.org/project/openai-agents/)
-   [BroadNet Inference API referansı (İngilizce)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-guides-openai-agents-sdk-custom-provider&utm_content=sources)
