BroadRouter
ابدأ الآن

استخدام Kilo Code مع BroadNet Inference (مزوّد OpenAI Compatible)

آخر تحديث

في Kilo Code، افتح Settings، واذهب إلى Providers وانقر Custom provider. اختر OpenAI Compatible في Provider API، واضبط Base URL على https://inference.broadnet.ai/v1، والصق مفتاح BroadNet، وأضف يدويًا معرّف نموذج مثل broadnet/glm-5.3. وفي kilo.json، استخدم npm @ai-sdk/openai-compatible مع options.baseURL، واضبط limit.context وlimit.output.

Kilo Code وكيل برمجة مفتوح المصدر يعمل في VS Code وفي الطرفية. ويمكن إضافة أي مزوّد يوفّر OpenAI Chat Completions API بوصفه مزوّدًا مخصّصًا (custom provider). وBroadNet Inference تقدّم هذه الصيغة على https://inference.broadnet.ai/v1. BroadRouter هو موقع BroadNet نفسها؛ ويتبع هذا الدليل توثيق Kilo للمزوّدين كما كان في 15 نوفمبر 2026.

الإعداد في VS Code

  1. احصل على مفتاح. أنشئ مفتاح دفع حسب الاستخدام في لوحة تحكم BroadNet، أو استخدم مفتاح خطة غير محدودة.

  2. افتح Settings (أيقونة الترس) واذهب إلى تبويب Providers.

  3. انتقل إلى الأسفل وانقر Custom provider.

  4. املأ النافذة:

    الحقل القيمة
    Provider ID broadnet
    Display name BroadNet Inference
    Provider API OpenAI Compatible
    Base URL https://inference.broadnet.ai/v1
    API key مفتاح BroadNet الخاص بك
    Models أضف broadnet/glm-5.3 يدويًا (انظر أدناه)
  5. انقر Submit. يظهر النموذج في قائمة اختيار النماذج.

  6. اختبر الإعداد. ابدأ مهمة مثل “explain this file”. إن أجاب، فالاتصال يعمل.

يحاول Kilo ملء قائمة النماذج من /v1/models الخاص بنقطة النهاية. ويصف توثيق BroadNet هذا المسار بأنه بيانات وصفية للكتالوج مخصّصة لأدوات المراقبة، وحين تحققنا منه في 15 نوفمبر 2026 لم يُدرج إلا نموذجَي التفريغ الصوتي. اكتب معرّفات نماذج المحادثة بنفسك، ولا تختر نماذج التفريغ الصوتي.

الإعداد في kilo.json (لواجهة CLI، أو لضبط الحدود وخيارات الأدوات)

نافذة Kilo لا تضبط حدود الرموز ولا استدعاء الأدوات، ويحيل توثيقه في ذلك إلى ملف الإعداد: ~/.config/kilo/kilo.json، أو ./kilo.json داخل المشروع.

{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "broadnet/glm-5.3",
  "provider": {
    "broadnet": {
      "npm": "@ai-sdk/openai-compatible",
      "env": ["BROADNET_API_KEY"],
      "options": {
        "baseURL": "https://inference.broadnet.ai/v1"
      },
      "models": {
        "glm-5.3": {
          "id": "broadnet/glm-5.3",
          "name": "GLM 5.3",
          "tool_call": true,
          "reasoning": true,
          "limit": { "context": 1048576, "output": 16000 }
        },
        "qwen3.8-27b": {
          "id": "broadnet/qwen3.8-27b",
          "name": "Qwen3.8 27B",
          "tool_call": true,
          "reasoning": true,
          "modalities": { "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 262144, "output": 16000 }
        },
        "deepseek-v4.1-flash": {
          "id": "broadnet/deepseek-v4.1-flash",
          "name": "DeepSeek V4.1 Flash",
          "reasoning": true,
          "limit": { "context": 1048576, "output": 16000 }
        }
      }
    }
  }
}
export BROADNET_API_KEY='your-broadnet-key'
  • قيمة model في المستوى الأعلى، broadnet/glm-5.3، هي اسم المزوّد مضافًا إليه مفتاح الخريطة (glm-5.3)، وليست معرّف BroadNet. أما الحقل id فهو معرّف النموذج الذي يرسله Kilo إلى BroadNet. ويقول توثيق Kilo إن id يأخذ قيمة مفتاح الخريطة افتراضيًا، لذا اضبطه كلما لم يكن المفتاح هو معرّف BroadNet الكامل، كما في المفاتيح القصيرة هنا.
  • اضبط دائمًا limit.context وlimit.output. فبحسب توثيق Kilo، إن لم يطابق النموذج المخصّص أي نموذج في الكتالوج، صارت القيمتان 0، وهذا يعطّل الإدارة التلقائية للسياق. والقيمة 16,000 للمخرجات اقتراح منا؛ فهي تترك مساحة للاستدلال المنطقي.
  • تُرك tool_call خارج DeepSeek V4.1 Flash عن قصد: فتوثيق BroadNet لا يُدرج استدعاء الأدوات له. أضفه بعد أن تختبره.

أي نموذج تختار

المهمة النموذج ملاحظات
برمجة بالوكلاء مع الأدوات GLM 5.3 الأدوات والمخرجات المنظَّمة مُدرجة؛ سياق 1M
لقطات الشاشة، والعربية Qwen3.8 27B الأدوات والصور؛ سياق 262K
جلسات طويلة بسعر ثابت DeepSeek V4.1 Flash الخطط غير المحدودة؛ الأدوات غير مُدرجة لدى BroadNet

جرّب الخطة غير المحدودة بساعة من الشهاب (Meteor) ($1) قبل شهر من البدر (Full Moon) ($60).

حل المشكلات

  • “Invalid API Key” أو 401. الصق المفتاح من جديد. وتحقّق من أن للمفتاح رصيدًا متبقيًا، وأن BROADNET_API_KEY مضبوط في العملية التي تشغّل Kilo.
  • “Model Not Found”. تحقّق من أن المعرّف يطابق معرّف BroadNet تمامًا، مع البادئة broadnet/. النماذج المدفوعة تحتاج إلى شحن الرصيد؛ والرصيد البالغ $5 يغطي broadnet/gemma-4-26b-a4b ونموذجَي Transcribe.
  • إجابة فارغة أو رسالة “response may be incomplete”. (ترجمة: قد تكون الاستجابة ناقصة.) ينبّه Kilo حين ينفق نموذج استدلالي كامل المخرجات على الاستدلال المنطقي. ارفع limit.output. راجع لماذا تعود الإجابات فارغة.
  • 429. يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 قيد التنفيذ. راجع الأخطاء وإعادة المحاولة.
  • الوكلاء الفرعيون المتوازيون على مفتاح خطة واحد ينتظرون أو يفشلون. تشغّل جلسة الخطة طلبًا واحدًا في كل مرة، فأعطِ كل وكيل فرعي متوازٍ جلسته الخاصة.
  • أخطاء الاتصال. يجب أن ينتهي Base URL بـ /v1. وإن كان لمفتاحك قائمة عناوين IP مسموح بها، فأضف عنوان جهازك.

أسئلة شائعة

لماذا لا يعرض Kilo Code نماذج المحادثة من BroadNet بعد إدخال Base URL؟

يجلب Kilo النماذج من قائمة /v1/models الخاصة بنقطة النهاية. وحين تحققنا في 15 نوفمبر 2026، لم يُدرج المسار العام /v1/models في BroadNet إلا نموذجَي التفريغ الصوتي، فأضف معرّفات نماذج المحادثة يدويًا.

ما قيمة limit.context لنماذج BroadNet؟

1048576 لنموذجَي GLM 5.3 وDeepSeek V4.1 Flash، و262144 لنموذج Qwen3.8 27B، و32768 لنموذج BroadNet Gemma 4 VL 26B. ويقول توثيق Kilo إن غياب الحد يجعل قيمته 0 للنماذج المخصّصة، وهذا يعطّل الإدارة التلقائية للسياق.

هل يمكن استخدام Kilo Code على الخطة غير المحدودة من BroadNet؟

نعم. تغطي الخطط نموذج DeepSeek V4.1 Flash بالمعرّف broadnet/deepseek-v4.1-flash. استخدم مفتاح الخطة مفتاحًا لـ API. ولا يُدرج توثيق BroadNet استدعاء الأدوات لهذا النموذج، فاختبر مهمة وكيل أولًا.

هل أختار OpenAI Compatible أم OpenAI Responses في Provider API؟

اختر OpenAI Compatible. تقدّم BroadNet chat completions على /v1/chat/completions، ولا تُدرج Responses API.

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