Kilo Code وكيل برمجة مفتوح المصدر يعمل في VS Code وفي الطرفية. ويمكن إضافة أي مزوّد يوفّر OpenAI Chat Completions API بوصفه مزوّدًا مخصّصًا (custom provider). وBroadNet Inference تقدّم هذه الصيغة على https://inference.broadnet.ai/v1. BroadRouter هو موقع BroadNet نفسها؛ ويتبع هذا الدليل توثيق Kilo للمزوّدين كما كان في 15 نوفمبر 2026.
الإعداد في VS Code
-
احصل على مفتاح. أنشئ مفتاح دفع حسب الاستخدام في لوحة تحكم BroadNet، أو استخدم مفتاح خطة غير محدودة.
-
افتح Settings (أيقونة الترس) واذهب إلى تبويب Providers.
-
انتقل إلى الأسفل وانقر Custom provider.
-
املأ النافذة:
الحقل القيمة Provider ID broadnetDisplay name BroadNet Inference Provider API OpenAI Compatible Base URL https://inference.broadnet.ai/v1API key مفتاح BroadNet الخاص بك Models أضف broadnet/glm-5.3يدويًا (انظر أدناه) -
انقر Submit. يظهر النموذج في قائمة اختيار النماذج.
-
اختبر الإعداد. ابدأ مهمة مثل “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 مسموح بها، فأضف عنوان جهازك.
