---
title: "smolagents OpenAIModel ve özel api_base ayarı | BroadRouter"
description: "Hugging Face smolagents'ı OpenAIModel ve api_base ile BroadNet Inference'a bağlayın: CodeAgent her modelde, ToolCallingAgent GLM 5.3 ve Qwen3.8 27B'de çalışır."
url: https://broadrouter.com/tr/guides/smolagents-openai-compatible/
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/smolagents-openai-compatible/) (güncelleme: 2026-11-16).

# smolagents'ı OpenAIModel ile BroadNet Inference'ta çalıştırın

Güncellendi 2026-11-16

smolagents'ın OpenAIModel sınıfını model\_id değeri broadnet/glm-5.3 gibi bir BroadNet kimliği, api\_base değeri https://inference.broadnet.ai/v1 ve api\_key değeri BroadNet anahtarınız olacak şekilde oluşturun, ardından CodeAgent veya ToolCallingAgent'a verin. CodeAgent yerel araç çağrıları yerine Python yazar, bu yüzden DeepSeek V4.1 Flash'ta çalışabilir. ToolCallingAgent için GLM 5.3 veya Qwen3.8 27B gerekir.

smolagents, Hugging Face’in ajanlar için küçük Python kütüphanesidir. `OpenAIModel` sınıfı “connects to an OpenAI-compatible API server” (çeviri: OpenAI uyumlu bir API sunucusuna bağlanır) ve URL için `api_base` kullanır. BroadNet Inference `https://inference.broadnet.ai/v1` adresinde chat completions sunar, bu yüzden doğrudan çalışır. BroadRouter, BroadNet’in kendi sitesidir; bu rehber smolagents 1.26.0 belgelerini izler.

## Kurulum

```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`, modelden `<code>` etiketleri arasında Python yazmasını ister ve kodu yerelde çalıştırır. İstek, `</code>` gibi durdurma dizileri içeren ve `tools` alanı olmayan düz bir chat completion’dır. Yani yerel araç çağırmaya bağlı değildir; bu sayede BroadNet’in [sınırsız planlarındaki](https://broadrouter.com/tr/guides/unlimited-llm-api-sessions/) model olan `broadnet/deepseek-v4.1-flash` üzerinde çalışabilir. Kod kalitesi yine de modele göre değişir, kendi görevlerinizle test edin.

CodeAgent, modelin yazdığı kodu çalıştırır. Dosyalara, ağlara veya kimlik bilgilerine dokunan araçlar vermeden önce smolagents’ın güvenli kod çalıştırma rehberini okuyun.

## 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`, sizin araçlarınızı ve kendi `final_answer` aracını `tool_choice: "required"` ile fonksiyon şemaları olarak gönderir. `broadnet/glm-5.3` veya `broadnet/qwen3.8-27b` kullanın; BroadNet’in belgeleri araçları yalnızca bu iki model için listeler.

## Hangi modeli seçmeli

| Ajan | Model |
| --- | --- |
| `CodeAgent`, sabit fiyatlı planda uzun çalışmalar | `broadnet/deepseek-v4.1-flash` |
| `ToolCallingAgent` | `broadnet/glm-5.3` |
| Görsel girdili her iki ajan | `broadnet/qwen3.8-27b` |

Bir plan oturumu aynı anda tek istek çalıştırır ve bir ajan adımlarını art arda gönderir; dolayısıyla bir oturum bir ajana yeter. [Tüm modellerin fiyatları](https://broadrouter.com/tr/pricing/).

## Bunu nasıl test ettik

2026-11-15’te temiz bir sanal ortama smolagents 1.26.0 kurduk ve iki ajanı da BroadNet’in chat completions yapısını konuşan yerel bir sahte sunucuya karşı çalıştırdık. DeepSeek kimliğiyle çalışan `CodeAgent` bir kod yanıtı aldı, onu çalıştırdı ve 42 döndürdü. İsteklerinde `max_tokens: 4000`, durdurma dizileri vardı ve araç yoktu. `ToolCallingAgent` için istek yapısını kontrol ettik: model kimliği değiştirilmeden, iki araç şemasıyla ve `tool_choice: "required"` ile gönderildi. smolagents araç sonuçlarını user mesajları olarak geri gönderir. Sahte sunucumuz bu biçimi izlemediği için o ajanı nihai yanıta kadar çalıştırmadık. Elimizde BroadNet anahtarı yoktu, bu yüzden gerçek model çıktısını test etmedik.

## Sorun giderme

-   **401.** Anahtar yanlış, süresi dolmuş ya da kullanım hakkı tükenmiş.
-   **404.** `api_base` değeri `/v1` ile bitmelidir. Model kimliğini kontrol edin. Ücretli modeller bakiye yüklemesi gerektirir; $5 kredisi yalnızca `broadnet/gemma-4-26b-a4b` modelini kapsar.
-   **“Make sure to provide correct code blobs”.** Modelin yanıtında kod bloğu yoktu. Akıl yürütme `max_tokens` sınırına dahil olduğu için değeri artırın ya da başka bir model deneyin. [Yanıtlar neden boş geliyor](https://broadrouter.com/tr/guides/reasoning-tokens-empty-response/).
-   **ToolCallingAgent hiç bitmiyor.** `broadnet/glm-5.3` veya `broadnet/qwen3.8-27b` modeline geçin.
-   **429.** Kullandıkça öde anahtarı dakikada 30 isteğe izin verir. smolagents `requests_per_minute` ile kendi hızını sınırlayabilir. [Hatalar ve yeniden denemeler](https://broadrouter.com/tr/guides/errors-and-retries/) rehberine bakın.

## Bu rehberdeki terimler

[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.

[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.

[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.

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

OpenAI uyumlu API, POST /v1/chat/completions gibi OpenAI API'siyle aynı istek ve yanıt biçimlerini kabul eden bir HTTP API'sidir; böylece OpenAI SDK'ları ve araçları yalnızca base URL, API anahtarı ve model adı değiştirilerek onu kullanabilir.

## Sık sorulan sorular

### OpenAIModel mi, OpenAIServerModel mi?

smolagents 1.26, OpenAI uyumlu her sunucu için OpenAIModel'i belgeler. OpenAIServerModel paket tarafından hâlâ dışa aktarılır ama belgeler OpenAIModel'i anlatır.

### smolagents BroadNet sınırsız planında çalışır mı?

Planlar DeepSeek V4.1 Flash'ı kapsar. BroadNet bu model için araç çağırmayı listelemez, ancak CodeAgent yerel araç çağrılarına ihtiyaç duymaz; modelden Python kodu ister. Sahte sunucu testimizde DeepSeek kimliğiyle çalışan bir CodeAgent, tools alanı olmayan düz sohbet istekleri gönderdi.

### ToolCallingAgent neden GLM 5.3 veya Qwen3.8 27B gerektiriyor?

Araçları tool\_choice değeri required olan OpenAI fonksiyon şemaları olarak gönderir. BroadNet'in belgeleri araçları yalnızca GLM 5.3 ve Qwen3.8 27B için listeler.

### max\_tokens veya temperature nasıl verilir?

OpenAIModel'e anahtar kelime argümanı olarak. smolagents'ın belgeleri ek argümanların her completion çağrısına iletildiğini söyler. Testimizde max\_tokens=4000 her istekte gönderildi.

## İ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/)
-   [BroadNet Inference hata kodları ve ne zaman yeniden denenmeli](https://broadrouter.com/tr/guides/errors-and-retries/)
-   [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-smolagents-openai-compatible&utm_content=page-cta) ·

**Kaynaklar**

-   [smolagents belgeleri v1.26.0, modeller referansı (OpenAIModel) (2026-11-15 tarihinde kontrol edildi)](https://huggingface.co/docs/smolagents/reference/models)
-   [PyPI, smolagents 1.26.0 (2026-11-15 tarihinde kontrol edildi)](https://pypi.org/project/smolagents/)
-   [BroadNet Inference API referansı (2026-11-15 tarihinde kontrol edildi) (İngilizce)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-guides-smolagents-openai-compatible&utm_content=sources)
