BroadRouter
شروع کریں

Semantic Kernel کو BroadNet Inference کے ساتھ استعمال کریں

اپ ڈیٹ

Python میں base_url https://inference.broadnet.ai/v1 اور اپنی BroadNet کلید کے ساتھ AsyncOpenAI بنائیں، پھر اسے async_client کے طور پر OpenAIChatCompletion کو دیں، اور ai_model_id کو broadnet/glm-5.3 جیسے BroadNet ID پر رکھیں۔ C# میں endpoint Uri کے ساتھ AddOpenAIChatCompletion کال کریں، جسے Microsoft تجرباتی (SKEXP0010) قرار دیتا ہے۔ پلگ انز کے لیے GLM 5.3 یا Qwen3.8 27B لیں۔

Semantic Kernel، C#، Python اور Java میں AI ایپس اور ایجنٹس بنانے کے لیے Microsoft کا SDK ہے۔ اس کا OpenAI کنیکٹر دوسری OpenAI-compatible سروسز کے ساتھ بھی کام کرتا ہے: Python آپ کا اپنا OpenAI کلائنٹ لیتا ہے، اور C# ایک کسٹم endpoint۔ BroadNet Inference، https://inference.broadnet.ai/v1 پر معیاری chat completions فراہم کرتا ہے، اس لیے دونوں راستے کام کرتے ہیں۔ BroadRouter، BroadNet کی اپنی سائٹ ہے؛ یہ گائیڈ Microsoft کی Semantic Kernel دستاویزات اور Python 1.47.0 کے سورس پر مبنی ہے۔

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 بغیر تبدیلی کے بھیجا جاتا ہے، اس لیے broadnet/ پری فکس رہنے دیں۔ جب آپ کلائنٹ دیتے ہیں تو OpenAIChatCompletion کے api_key آرگیومنٹ کی ضرورت نہیں۔

پلگ انز اور فنکشن کالنگ

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 پلگ ان کو weather-get_weather نام کے ٹول کے طور پر بھیجتا ہے، ماڈل کے مانگنے پر اسے چلاتا ہے، اور نتیجہ واپس بھیجتا ہے۔ broadnet/glm-5.3 یا broadnet/qwen3.8-27b استعمال کریں؛ BroadNet کی دستاویزات صرف ان دونوں کے لیے ٹولز درج کرتی ہیں۔

ایجنٹس

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 کی دستاویزات یہ طریقہ “other AI service providers that support the OpenAI chat completion API” (ترجمہ: ایسے دوسرے AI سروس فراہم کنندگان جو OpenAI chat completion API سپورٹ کرتے ہیں) کے لیے دیتی ہیں۔ ہم نے C# ورژن نہیں چلایا۔

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();

کنیکٹر dotnet add package Microsoft.SemanticKernel.Connectors.OpenAI سے انسٹال کریں۔

کون سا ماڈل چنیں

استعمال ماڈل
پلگ انز، فنکشن کالنگ، ایجنٹس broadnet/glm-5.3
پلگ انز کے ساتھ تصویری ان پٹ یا عربی متن broadnet/qwen3.8-27b
ٹولز کے بغیر چیٹ اور خلاصے، فلیٹ قیمت والا پلان broadnet/deepseek-v4.1-flash

ہر ماڈل کی قیمتیں۔

ہم نے اسے کیسے ٹیسٹ کیا

2026-11-15 کو ہم نے ایک صاف ورچوئل انوائرنمنٹ میں Python کے لیے semantic-kernel 1.47.0 انسٹال کیا اور سادہ چیٹ، اسٹریمنگ، خودکار فنکشن کالنگ اور ایک ChatCompletionAgent ایک لوکل موک سرور پر چلائے جو BroadNet کی chat-completions ساخت میں جواب دیتا ہے۔ ہم نے لاگ کی گئی درخواستیں پڑھیں۔ سب /v1/chat/completions پر گئیں، BroadNet ماڈل ID بغیر تبدیلی کے اور Bearer کلید کے ساتھ۔ max_tokens اسی نام سے بھیجا گیا، اسٹریمنگ نے stream_options.include_usage شامل کیا، اور فنکشن کالنگ نے tool_choice: "auto" بھیجا۔ ہمارے پاس BroadNet کلید نہیں تھی، اس لیے ہم نے حقیقی ماڈل آؤٹ پٹ ٹیسٹ نہیں کیا۔ C# کوڈ Microsoft کی دستاویزات سے ہے اور چلایا نہیں گیا۔

مسائل کا حل

  • 401۔ کلید غلط ہے، ختم ہو چکی ہے یا الاؤنس ختم ہو گیا ہے۔
  • 404۔ کلائنٹ کا base_url، /v1 پر ختم ہونا چاہیے۔ ماڈل ID جانچیں۔ پیڈ ماڈلز کے لیے ٹاپ اپ چاہیے؛ $5 کریڈٹ صرف broadnet/gemma-4-26b-a4b اور دو Transcribe ماڈلز کا احاطہ کرتا ہے۔
  • خالی جوابات۔ DeepSeek V4.1 Flash، GLM 5.3 اور Qwen3.8 27B پر ریزننگ max_tokens میں گنی جاتی ہے۔ اسے بڑھائیں۔ جوابات خالی کیوں آتے ہیں۔
  • ریزننگ ماڈلز اور رولز۔ Microsoft کی دستاویزات OpenAI کے ریزننگ ماڈلز کے لیے instruction_role="developer" تجویز کرتی ہیں۔ BroadNet کا API ریفرنس developer رول کا ذکر نہیں کرتا، اس لیے instruction_role کو ڈیفالٹ پر رہنے دیں۔ ہمارے ایجنٹ ٹیسٹ نے ہدایات system میسج میں بھیجیں۔
  • 429۔ استعمال کے مطابق ادائیگی والی کلید فی منٹ 30 درخواستوں اور بیک وقت 4 جاری درخواستوں کی اجازت دیتی ہے۔ ایررز اور ری ٹرائی دیکھیں۔

عام سوالات

Python والے Semantic Kernel میں کسٹم base URL کیسے سیٹ کریں؟

ورژن 1.47 میں OpenAIChatCompletion کا کوئی base_url آرگیومنٹ نہیں۔ base_url اور api_key کے ساتھ ایک openai.AsyncOpenAI کلائنٹ بنائیں اور اسے async_client کے طور پر دیں۔ پھر وہ کلائنٹ ہر درخواست BroadNet کو بھیجتا ہے۔

C# کسٹم endpoint کو pragma کیوں چاہیے؟

Microsoft کی دستاویزات کہتی ہیں کہ OpenAI کنیکٹر کے ساتھ کسٹم endpoints استعمال کرنا تجرباتی ہے، اس لیے endpoint والے overload کو #pragma warning disable SKEXP0010 چاہیے۔

کیا BroadNet کے ساتھ خودکار فنکشن کالنگ چلتی ہے؟

یہ chat completions پر معیاری ٹول کالز استعمال کرتی ہے، اس لیے ایسا ماڈل لیں جسے BroadNet ٹولز کے ساتھ درج کرتا ہے: GLM 5.3 یا Qwen3.8 27B۔ ہمارے موک ٹیسٹ میں Semantic Kernel نے پلگ ان کو ٹول کے طور پر بھیجا اور نتیجہ tool میسج میں لوٹایا۔

کیا Semantic Kernel کا ChatCompletionAgent، BroadNet پر چلتا ہے؟

ہاں۔ یہ وہی OpenAIChatCompletion سروس لیتا ہے۔ ہمارے Python ٹیسٹ میں اس نے ایجنٹ کی ہدایات system میسج کے طور پر بھیجیں اور chat completions کے ذریعے پلگ ان کال کیا۔

Markdown میں پڑھیںChatGPT سے پوچھیںClaude سے پوچھیںPerplexity سے پوچھیں