BroadRouter
Başlayın

Semantic Kernel'i BroadNet Inference ile kullanın

Güncellendi

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

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

Tüm modellerin fiyatları.

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.
  • 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 rehberine bakın.

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

Markdown olarak okuChatGPT asistanına sorClaude asistanına sorPerplexity asistanına sor