Zed محرر شيفرة مفتوح المصدر فيه وكيل مدمج. ويتصل بأي خادم يوفّر API متوافقة مع OpenAI عبر نوع المزوّد openai_compatible. وBroadNet Inference تقدّم chat completions القياسية على https://inference.broadnet.ai/v1، لذا فهي مناسبة له. BroadRouter هو موقع BroadNet نفسها؛ والخطوات أدناه تتبع توثيق الوصول عبر الـ API في Zed كما هو في Zed 1.28.
الإعداد
- احصل على مفتاح. أنشئ مفتاح دفع حسب الاستخدام في لوحة تحكم BroadNet، أو استخدم مفتاح خطة غير محدودة.
- أضف المزوّد. إما أن تفتح Agent Settings بالأمر
agent: open settingsوتنقر Add Provider في قسم LLM Providers، وإما أن تعدّلsettings.jsonمباشرة:
{
"language_models": {
"openai_compatible": {
"broadnet": {
"api_url": "https://inference.broadnet.ai/v1",
"available_models": [
{
"name": "broadnet/glm-5.3",
"display_name": "GLM 5.3 (BroadNet)",
"max_tokens": 1048576,
"max_output_tokens": 16000,
"capabilities": {
"tools": true,
"images": false,
"parallel_tool_calls": false,
"prompt_cache_key": false,
"chat_completions": true,
"interleaved_reasoning": false,
"max_tokens_parameter": true
}
},
{
"name": "broadnet/qwen3.8-27b",
"display_name": "Qwen3.8 27B (BroadNet)",
"max_tokens": 262144,
"max_output_tokens": 16000,
"capabilities": {
"tools": true,
"images": true,
"parallel_tool_calls": false,
"prompt_cache_key": false,
"chat_completions": true,
"interleaved_reasoning": false,
"max_tokens_parameter": true
}
}
]
}
}
}
}
- أعطِ Zed المفتاح. صدّره قبل تشغيل Zed، أو الصقه في المزوّد داخل Agent Settings. يخزّن Zed المفاتيح الملصوقة في سلسلة مفاتيح النظام (keychain)، لا في
settings.json.
export BROADNET_API_KEY='your-broadnet-key'
- اختبره. افتح Agent Panel، واختر GLM 5.3 (BroadNet) من قائمة النماذج، واطرح سؤالًا صغيرًا عن ملف مفتوح. إن وصلتك إجابة فالاتصال يعمل.
معنى الإعدادات
nameهو معرّف النموذج الذي يرسله Zed. استخدم معرّف BroadNet كما هو تمامًا، مع البادئةbroadnet/.max_tokensفي مخطط Zed هو نافذة السياق، لا حد المخرجات. استخدم 1,048,576 لـ GLM 5.3 وDeepSeek V4.1 Flash، و262,144 لـ Qwen3.8 27B.max_output_tokensيحدّ طول الرد. والقيمة 16,000 أعلاه اقتراح منّا، لا حد من BroadNet. والاستدلال يُحتسب ضمنها، فلا تضبطها على قيمة منخفضة.max_tokens_parameter: trueيجعل Zed يرسل حد المخرجات فيmax_tokensبدلًا منmax_completion_tokens. ويصف المرجع التقني لـ BroadNet الحقلmax_tokens.imagesقيمته الافتراضية false في النماذج المتوافقة مع OpenAI. فعّله فقط للنماذج التي تقبل الصور: Qwen3.8 27B وDeepSeek V4.1 Flash وBroadNet Gemma 4 VL 26B.reasoning_effortاختياري. ويقترح توثيق BroadNet القيمةlowإن أردت تفكيرًا أقصر.
أي نموذج تختار
| الاستخدام | النموذج | السبب |
|---|---|---|
| تعديلات الوكيل مع الأدوات | broadnet/glm-5.3 |
تُدرج BroadNet له الأدوات والمخرجات المهيكلة؛ سياق مليون رمز |
| لقطات الشاشة والنص العربي | broadnet/qwen3.8-27b |
أدوات مع إدخال الصور؛ سياق 262K |
| محادثات طويلة على خطة بسعر ثابت | broadnet/deepseek-v4.1-flash |
نموذج الخطة غير المحدودة؛ يقبل الصور؛ لا تُدرج BroadNet له الأدوات |
يفترض Zed القيمة tools: true للنماذج المتوافقة مع OpenAI. ولا يذكر توثيق BroadNet استدعاء الأدوات (tool calling) لـ DeepSeek V4.1 Flash، فاختبر مهمة وكيل حقيقية عليه قبل أن تعتمد عليه. وساعة من الشهاب (Meteor) بسعر $1 طريقة رخيصة لتجربته قبل شهر من البدر (Full Moon) بسعر $60.
حل المشكلات
- 401. المفتاح خاطئ أو منتهي الصلاحية أو استُنفد رصيده. إن ضبطت
BROADNET_API_KEYفهو يتقدّم على سلسلة المفاتيح؛ ألغِ ضبطه وأعد تشغيل Zed لاستخدام المفتاح المحفوظ بدلًا منه. - 404 على كل طلب. تأكّد أن
api_urlينتهي بـ/v1. ثم تأكّد أنnameيطابق معرّف BroadNet تمامًا. النماذج المدفوعة تحتاج إلى شحن الرصيد؛ فالرصيد المبدئي البالغ $5 يغطيbroadnet/gemma-4-26b-a4bونموذجَي Transcribe. - ردود فارغة. استهلك النموذج ميزانية مخرجاته في الاستدلال. ارفع
max_output_tokensأو اضبطreasoning_effortعلىlow. لماذا تعود الإجابات فارغة. - 429. يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 قيد التنفيذ في آن واحد. وجلسة الخطة تشغّل طلبًا واحدًا في كل مرة. راجع الأخطاء وإعادة المحاولة.
- المشاريع البعيدة (Remote projects). يهيّئ Zed المزوّدين في التطبيق المحلي، لذا عند العمل عبر SSH يأتي المفتاح من سلسلة المفاتيح المحلية أو من بيئتك المحلية، لا من الجهاز البعيد.
