BroadRouter
ابدأ الآن

استخدام Semantic Kernel مع BroadNet Inference

آخر تحديث

في Python، أنشئ AsyncOpenAI مع base_url بقيمة https://inference.broadnet.ai/v1 ومفتاح BroadNet، ثم مرّره بوصفه async_client إلى OpenAIChatCompletion مع ضبط ai_model_id على معرّف من BroadNet مثل broadnet/glm-5.3. وفي C#، استدعِ AddOpenAIChatCompletion مع endpoint من نوع Uri، وهو ما تصفه Microsoft بأنه تجريبي (SKEXP0010). استخدم GLM 5.3 أو Qwen3.8 27B للإضافات.

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 قيد التنفيذ. راجع الأخطاء وإعادة المحاولة.

أسئلة شائعة

كيف أضبط base URL مخصّصًا في Semantic Kernel لـ Python؟

لا يملك OpenAIChatCompletion وسيطًا باسم base_url في الإصدار 1.47. أنشئ عميل openai.AsyncOpenAI مع base_url وapi_key، ومرّره بوصفه async_client. وعندها يرسل ذلك العميل كل طلب إلى BroadNet.

لماذا تحتاج نقطة النهاية المخصّصة في C# إلى pragma؟

يقول توثيق Microsoft إن استخدام نقاط النهاية المخصّصة مع موصّل OpenAI تجريبي، لذا تحتاج دالة التحميل الزائد التي تأخذ endpoint إلى #pragma warning disable SKEXP0010.

هل يعمل استدعاء الدوال التلقائي مع BroadNet؟

يستخدم استدعاءات أدوات قياسية عبر chat completions، فاستخدم نموذجًا تُدرج له BroadNet الأدوات: GLM 5.3 أو Qwen3.8 27B. وفي اختبارنا على خادم وهمي، أرسل Semantic Kernel الإضافة بوصفها أداة وأعاد النتيجة في رسالة tool.

هل يعمل ChatCompletionAgent من Semantic Kernel على BroadNet؟

نعم. فهو يأخذ خدمة OpenAIChatCompletion نفسها. وفي اختبارنا بـ Python أرسل تعليمات الوكيل في رسالة system واستدعى الإضافة عبر chat completions.

اقرأها بصيغة Markdownاسأل ChatGPTاسأل Claudeاسأل Perplexity