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 جاری درخواستوں کی اجازت دیتی ہے۔ ایررز اور ری ٹرائی دیکھیں۔
