Semantic Kernel هي حزمة SDK من Microsoft لبناء تطبيقات الذكاء الاصطناعي والوكلاء بلغات C# وPython وJava. ويعمل موصّل OpenAI فيها مع خدمات أخرى متوافقة مع OpenAI: ففي Python يأخذ عميل OpenAI الخاص بك، وفي C# يأخذ نقطة نهاية مخصّصة. وتقدّم BroadNet Inference واجهة chat completions القياسية على https://inference.broadnet.ai/v1، فيعمل الطريقان كلاهما. 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/. ولا حاجة إلى الوسيط api_key في OpenAIChatCompletion حين تمرّر عميلًا.
الإضافات واستدعاء الدوال
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 الإضافة (plugin) بوصفها أداة باسم 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” (ترجمة: مزوّدي خدمات الذكاء الاصطناعي الآخرين الذين يدعمون 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 ثبّتنا semantic-kernel 1.47.0 لـ Python في بيئة افتراضية نظيفة، وشغّلنا محادثة عادية وبثًا متدفقًا واستدعاء دوال تلقائيًا وChatCompletionAgent على خادم وهمي محلي يتحدث بنية chat completions الخاصة بـ BroadNet. وقرأنا الطلبات المسجّلة: ذهبت كلها إلى /v1/chat/completions بمعرّف نموذج BroadNet دون تغيير ومفتاح Bearer. وأُرسل max_tokens بهذا الاسم، وأضاف البث المتدفق stream_options.include_usage، وأرسل استدعاء الدوال tool_choice: "auto". لم يكن لدينا مفتاح BroadNet، لذا لم نختبر مخرجات نموذج حقيقية. ومقتطف C# مأخوذ من توثيق Microsoft ولم يُشغَّل.
حل المشكلات
- 401. المفتاح خاطئ أو منتهي الصلاحية أو استنفد رصيده.
- 404. يجب أن ينتهي
base_urlفي العميل بـ/v1. وتحقّق من معرّف النموذج. النماذج المدفوعة تحتاج إلى شحن الرصيد؛ والرصيد البالغ $5 يغطيbroadnet/gemma-4-26b-a4bونموذجَي Transcribe. - ردود فارغة. يُحتسب الاستدلال ضمن
max_tokensفي DeepSeek V4.1 Flash وGLM 5.3 وQwen3.8 27B، فارفعه. راجع لماذا تعود الإجابات فارغة. - نماذج الاستدلال والأدوار. يقترح توثيق Microsoft ضبط
instruction_role="developer"لنماذج الاستدلال من OpenAI. لكن المرجع التقني لـ BroadNet API لا يذكر الدورdeveloper، فاتركinstruction_roleعلى قيمته الافتراضية. وقد أرسل اختبارنا للوكيل التعليمات في رسالةsystem. - 429. يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 قيد التنفيذ. راجع الأخطاء وإعادة المحاولة.
