---
title: "Semantic Kernel OpenAI bağlayıcısı ve özel uç nokta | BroadRouter"
description: "Microsoft Semantic Kernel'i BroadNet Inference'a bağlayın: Python'da AsyncOpenAI istemcisiyle, C#'ta özel uç noktayla; sohbet, eklentiler ve ajanlar için."
url: https://broadrouter.com/tr/guides/semantic-kernel-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/semantic-kernel-openai-compatible/) (güncelleme: 2026-11-16).

# Semantic Kernel'i BroadNet Inference ile kullanın

Güncellendi 2026-11-16

Python'da base\_url değeri https://inference.broadnet.ai/v1 ve BroadNet anahtarınızla bir AsyncOpenAI oluşturun, ardından bunu async\_client olarak OpenAIChatCompletion'a verin; ai\_model\_id değerini broadnet/glm-5.3 gibi bir BroadNet kimliği yapın. C#'ta AddOpenAIChatCompletion'ı bir endpoint Uri ile çağırın; Microsoft bunu deneysel (SKEXP0010) olarak işaretler. Eklentiler için GLM 5.3 veya Qwen3.8 27B kullanın.

Semantic Kernel, Microsoft’un C#, Python ve Java’da yapay zekâ uygulamaları ve ajanlar geliştirmek için sunduğu SDK’dır. OpenAI bağlayıcısı OpenAI uyumlu başka hizmetlerle de çalışır: Python kendi OpenAI istemcinizi, C# ise özel bir uç noktayı kabul eder. BroadNet Inference `https://inference.broadnet.ai/v1` adresinde standart chat completions sunar, dolayısıyla iki yol da çalışır. BroadRouter, BroadNet’in kendi sitesidir; bu rehber Microsoft’un Semantic Kernel belgelerini ve Python 1.47.0 kaynak kodunu izler.

## Python

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

```python
import asyncio, os
from openai import AsyncOpenAI
from semantic_kernel.connectors.ai.open_ai import OpenAIChatCompletion, OpenAIChatPromptExecutionSettings
from semantic_kernel.contents import ChatHistory

client = AsyncOpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])
chat = OpenAIChatCompletion(ai_model_id="broadnet/glm-5.3", async_client=client, service_id="broadnet")

async def main():
    history = ChatHistory()
    history.add_user_message("Give me three names for a billing microservice.")
    settings = OpenAIChatPromptExecutionSettings(max_tokens=4000)
    print(await chat.get_chat_message_content(chat_history=history, settings=settings))

asyncio.run(main())
```

`ai_model_id` değiştirilmeden gönderilir, bu yüzden `broadnet/` önekini koruyun. Bir istemci verdiğinizde `OpenAIChatCompletion`’ın `api_key` argümanına gerek kalmaz.

### Eklentiler ve fonksiyon çağırma

```python
from semantic_kernel import Kernel
from semantic_kernel.connectors.ai.function_choice_behavior import FunctionChoiceBehavior
from semantic_kernel.functions import kernel_function

class Weather:
    @kernel_function(description="Get the weather for a city.")
    def get_weather(self, city: str) -> str:
        return f"21C in {city}"

kernel = Kernel()
kernel.add_service(chat)
kernel.add_plugin(Weather(), plugin_name="weather")
settings = OpenAIChatPromptExecutionSettings(
    max_tokens=4000,
    function_choice_behavior=FunctionChoiceBehavior.Auto(),
)
# await chat.get_chat_message_content(chat_history=history, settings=settings, kernel=kernel)
```

Semantic Kernel eklentiyi `weather-get_weather` adlı bir araç olarak gönderir, model istediğinde çalıştırır ve sonucu geri yollar. `broadnet/glm-5.3` veya `broadnet/qwen3.8-27b` kullanın; BroadNet’in belgeleri yalnızca bu ikisi için araçları listeler.

### Ajanlar

```python
from semantic_kernel.agents import ChatCompletionAgent

agent = ChatCompletionAgent(service=chat, name="helper", instructions="Answer briefly.", plugins=[Weather()])
# response = await agent.get_response(messages="What's the weather in Dubai?")
```

## C# (.NET)

Microsoft’un belgeleri bu kalıbı “other AI service providers that support the OpenAI chat completion API” (çeviri: OpenAI sohbet tamamlama API’sini destekleyen diğer yapay zekâ hizmet sağlayıcıları) için verir. C# sürümünü biz çalıştırmadık.

```csharp
using Microsoft.SemanticKernel;

#pragma warning disable SKEXP0010
IKernelBuilder kernelBuilder = Kernel.CreateBuilder();
kernelBuilder.AddOpenAIChatCompletion(
    modelId: "broadnet/glm-5.3",
    apiKey: Environment.GetEnvironmentVariable("BROADNET_API_KEY"),
    endpoint: new Uri("https://inference.broadnet.ai/v1")
);
Kernel kernel = kernelBuilder.Build();
```

Bağlayıcıyı `dotnet add package Microsoft.SemanticKernel.Connectors.OpenAI` ile kurun.

## Hangi modeli seçmeli

| Kullanım | Model |
| --- | --- |
| Eklentiler, fonksiyon çağırma, ajanlar | `broadnet/glm-5.3` |
| Eklentiler ve görsel girdi ya da Arapça metin | `broadnet/qwen3.8-27b` |
| Araçsız sohbet ve özetler, sabit fiyatlı plan | `broadnet/deepseek-v4.1-flash` |

[Tüm modellerin fiyatları](https://broadrouter.com/tr/pricing/).

## Bunu nasıl test ettik

2026-11-15’te temiz bir sanal ortama Python için semantic-kernel 1.47.0 kurduk ve BroadNet’in chat completions yapısını konuşan yerel bir sahte sunucuya karşı düz sohbet, akış, otomatik fonksiyon çağırma ve bir `ChatCompletionAgent` çalıştırdık. Kaydedilen istekleri inceledik. Hepsi BroadNet model kimliği değiştirilmeden ve bir Bearer anahtarıyla `/v1/chat/completions` adresine gitti. `max_tokens` bu adla gönderildi, akış `stream_options.include_usage` ekledi ve fonksiyon çağırma `tool_choice: "auto"` gönderdi. Elimizde BroadNet anahtarı yoktu, bu yüzden gerçek model çıktısını test etmedik. C# parçası Microsoft’un belgelerinden alındı ve çalıştırılmadı.

## Sorun giderme

-   **401.** Anahtar yanlış, süresi dolmuş ya da kullanım hakkı tükenmiş.
-   **404.** İstemcinin `base_url` 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.
-   **Boş yanıtlar.** DeepSeek V4.1 Flash, GLM 5.3 ve Qwen3.8 27B’de akıl yürütme `max_tokens` sınırına dahildir. Değeri artırın. [Yanıtlar neden boş geliyor](https://broadrouter.com/tr/guides/reasoning-tokens-empty-response/).
-   **Akıl yürüten modeller ve roller.** Microsoft’un belgeleri OpenAI akıl yürütme modelleri için `instruction_role="developer"` önerir. BroadNet’in API referansı `developer` rolünden söz etmez, bu yüzden `instruction_role` değerini varsayılanında bırakın. Ajan testimiz talimatları bir `system` mesajında gönderdi.
-   **429.** Kullandıkça öde anahtarı dakikada 30 isteğe ve aynı anda işlemde 4 isteğe izin verir. [Hatalar ve yeniden denemeler](https://broadrouter.com/tr/guides/errors-and-retries/) rehberine bakın.

## Bu rehberdeki terimler

[Araç çağırma (tool calling)](https://broadrouter.com/tr/glossary/tool-calling/)

Araç çağırma (tool calling), fonksiyon çağırma (function calling) olarak da bilinir; modelin, geliştiricinin tanımladığı bir fonksiyonu çalıştırmak için JSON argümanlı yapılandırılmış bir istek döndürdüğü bir LLM API özelliğidir. Fonksiyonu uygulama çalıştırır ve sonucu geri gönderir; model hiçbir zaman kodu kendisi çalıştırmaz.

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

[Akış (streaming)](https://broadrouter.com/tr/glossary/streaming/)

Akış (streaming), bir dil modeli yanıtını sonda tek parça halinde değil, hâlâ üretilirken küçük parçalar halinde döndürme yöntemidir. OpenAI uyumlu API'ler, istekte stream değeri true olduğunda server-sent events (SSE) üzerinden akış yapar.

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

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

## Sık sorulan sorular

### Python için Semantic Kernel'de özel bir base URL nasıl ayarlanır?

OpenAIChatCompletion'ın 1.47 sürümünde base\_url argümanı yoktur. base\_url ve api\_key ile bir openai.AsyncOpenAI istemcisi oluşturun ve bunu async\_client olarak verin. Bu istemci her isteği BroadNet'e gönderir.

### C# özel uç noktası neden bir pragma gerektiriyor?

Microsoft'un belgeleri, OpenAI bağlayıcısıyla özel uç nokta kullanmanın deneysel olduğunu söyler; bu yüzden endpoint aşırı yüklemesi #pragma warning disable SKEXP0010 gerektirir.

### Otomatik fonksiyon çağırma BroadNet ile çalışır mı?

Chat completions üzerinden standart araç çağrıları kullanır; bu yüzden BroadNet'in araç desteğiyle listelediği bir model seçin: GLM 5.3 veya Qwen3.8 27B. Sahte sunucu testimizde Semantic Kernel eklentiyi araç olarak gönderdi ve sonucu bir tool mesajında döndürdü.

### Semantic Kernel'in ChatCompletionAgent'ı BroadNet'te çalışır mı?

Evet. Aynı OpenAIChatCompletion hizmetini alır. Python testimizde ajan talimatlarını system mesajı olarak gönderdi ve eklentiyi chat completions üzerinden çağırdı.

## İlgili rehberler

-   [OpenAI Python SDK'yı BroadNet Inference ile kullanın](https://broadrouter.com/tr/guides/openai-python-sdk/)
-   [OpenAI Agents SDK'yı BroadNet Inference üzerinde çalıştırın](https://broadrouter.com/tr/guides/openai-agents-sdk-custom-provider/)
-   [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-semantic-kernel-openai-compatible&utm_content=page-cta) ·

**Kaynaklar**

-   [Microsoft Learn, Semantic Kernel'e sohbet tamamlama hizmetleri ekleme (2026-05-26'da güncellendi, 2026-11-15 tarihinde kontrol edildi)](https://learn.microsoft.com/en-us/semantic-kernel/concepts/ai-services/chat-completion/)
-   [Semantic Kernel kaynak kodu, python-1.47.0 sürümünde Python OpenAIChatCompletion (2026-11-15 tarihinde kontrol edildi)](https://github.com/microsoft/semantic-kernel/blob/python-1.47.0/python/semantic_kernel/connectors/ai/open_ai/services/open_ai_chat_completion.py)
-   [PyPI, semantic-kernel 1.47.0 (2026-11-15 tarihinde kontrol edildi)](https://pypi.org/project/semantic-kernel/)
-   [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-semantic-kernel-openai-compatible&utm_content=sources)
