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
pip install semantic-kernel
export BROADNET_API_KEY='your-broadnet-key'
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
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
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.
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 |
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_urldeğeri/v1ile bitmelidir. Model kimliğini kontrol edin. Ücretli modeller bakiye yüklemesi gerektirir; $5 kredisi yalnızcabroadnet/gemma-4-26b-a4bmodelini kapsar. - Boş yanıtlar. DeepSeek V4.1 Flash, GLM 5.3 ve Qwen3.8 27B’de akıl yürütme
max_tokenssınırına dahildir. Değeri artırın. Yanıtlar neden boş geliyor. - 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ıdeveloperrolünden söz etmez, bu yüzdeninstruction_roledeğerini varsayılanında bırakın. Ajan testimiz talimatları birsystemmesajı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 rehberine bakın.
