BroadRouter

استخدام Zed مع BroadNet Inference كمزوّد متوافق مع OpenAI

آخر تحديث

في ملف settings.json الخاص بـ Zed، أضف مزوّدًا تحت language_models.openai_compatible، مثل broadnet، واضبط api_url على https://inference.broadnet.ai/v1، واذكر في available_models معرّفات BroadNet مثل broadnet/glm-5.3 مع ضبط max_tokens على حجم السياق. يقرأ Zed المفتاح من BROADNET_API_KEY، أو يمكنك حفظه في Agent Settings.

Zed محرر شيفرة مفتوح المصدر فيه وكيل مدمج. ويتصل بأي خادم يوفّر API متوافقة مع OpenAI عبر نوع المزوّد openai_compatible. وBroadNet Inference تقدّم chat completions القياسية على https://inference.broadnet.ai/v1، لذا فهي مناسبة له. BroadRouter هو موقع BroadNet نفسها؛ والخطوات أدناه تتبع توثيق الوصول عبر الـ API في Zed كما هو في Zed 1.28.

الإعداد

  1. احصل على مفتاح. أنشئ مفتاح دفع حسب الاستخدام في لوحة تحكم BroadNet، أو استخدم مفتاح خطة غير محدودة.
  2. أضف المزوّد. إما أن تفتح 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
            }
          }
        ]
      }
    }
  }
}
  1. أعطِ Zed المفتاح. صدّره قبل تشغيل Zed، أو الصقه في المزوّد داخل Agent Settings. يخزّن Zed المفاتيح الملصوقة في سلسلة مفاتيح النظام (keychain)، لا في settings.json.
export BROADNET_API_KEY='your-broadnet-key'
  1. اختبره. افتح 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 يأتي المفتاح من سلسلة المفاتيح المحلية أو من بيئتك المحلية، لا من الجهاز البعيد.

أسئلة شائعة

ما متغير البيئة الذي يقرأ منه Zed مفتاح المزوّد المخصّص؟

يبني Zed الاسم من معرّف المزوّد بصيغة upper snake case مع اللاحقة _API_KEY. فالمزوّد المسمّى broadnet يقرأ BROADNET_API_KEY. والمتغير غير الفارغ يتقدّم على المفتاح المحفوظ في سلسلة المفاتيح (keychain).

هل يعمل نموذج BroadNet في Agent Panel في Zed؟

نعم. يغطي الوصول عبر الـ API في Zed كلًا من Zed Agent وInline Assistant ورسائل commit وملخصات المحادثات. ويفترض Zed دعم الأدوات في النماذج المتوافقة مع OpenAI، فاختر GLM 5.3 أو Qwen3.8 27B، وهما مُدرجان لدى BroadNet مع دعم الأدوات.

هل يغيّر هذا ميزة edit predictions في Zed؟

لا. يقول توثيق Zed إن لـ edit prediction إعداد مزوّد خاصًا بها تحت edit_predictions. والمزوّد في هذا الدليل مخصّص للوكيل ولميزات الذكاء الاصطناعي الأخرى في Zed.

لماذا يقول Zed إن النموذج لا يعمل إلا مع Responses API؟

لا ينبغي أن يحدث ذلك مع BroadNet. اترك capabilities.chat_completions على قيمتها الافتراضية true. فـ BroadNet تقدّم /v1/chat/completions ولا تذكر Responses API.

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