BroadRouter
ابدأ الآن

إضافة BroadNet Inference إلى opencode كمزوّد مخصّص

آخر تحديث

في opencode.jsonc، أضف إدخالًا باسم broadnet تحت providers مع الحزمة @opencode/ai/providers/openai-compatible، وsettings.baseURL مضبوطًا على https://inference.broadnet.ai/v1، وenv مضبوطًا على BROADNET_API_KEY. اربط مفاتيح نماذج قصيرة بمعرّفات BroadNet عبر modelID، مثل broadnet/glm-5.3، ثم اختر النموذج بالأمر /models. وما زالت إعدادات V1 القديمة التي تستخدم npm @ai-sdk/openai-compatible وoptions.baseURL تعمل.

opencode وكيل برمجة مفتوح المصدر يعمل في الطرفية. والمزوّدون غير الموجودين في فهرسه المدمج يُضافون كمزوّدين مخصّصين في opencode.jsonc. ولأن BroadNet Inference يتعامل بصيغة إكمال المحادثات من OpenAI، فهو يستخدم حزمة التشغيل المتوافقة مع OpenAI في opencode. يتبع هذا الدليل وثائق opencode الحالية (V2).

الإعداد

  1. صدّر مفتاحك في الطرفية التي تشغّل منها opencode:
export BROADNET_API_KEY='your-broadnet-key'
  1. أنشئ ملف الإعداد. ضعه في مشروعك باسم opencode.jsonc، أو في ~/.config/opencode/opencode.jsonc لاستخدامه في كل مكان.
{
  "$schema": "https://opencode.ai/config.json",
  "model": "broadnet/glm-5.3",
  "providers": {
    "broadnet": {
      "name": "BroadNet Inference",
      "env": ["BROADNET_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": {
        "baseURL": "https://inference.broadnet.ai/v1"
      },
      "models": {
        "glm-5.3": {
          "modelID": "broadnet/glm-5.3",
          "name": "GLM 5.3",
          "capabilities": { "tools": true, "input": ["text"], "output": ["text"] },
          "limit": { "context": 1048576, "output": 16000 }
        },
        "deepseek-v4.1-flash": {
          "modelID": "broadnet/deepseek-v4.1-flash",
          "name": "DeepSeek V4.1 Flash",
          // BroadNet's docs don't list tool calling for this model: test it first
          "capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 1048576, "output": 16000 }
        },
        "qwen3.8-27b": {
          "modelID": "broadnet/qwen3.8-27b",
          "name": "Qwen3.8 27B",
          "capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 262144, "output": 16000 }
        }
      }
    }
  }
}
  1. شغّل opencode واختر النموذج بالأمر /models. المرجع هو broadnet/<map key>، مثل broadnet/glm-5.3. ويرسل opencode قيمة modelID إلى BroadNet.

تُدمَج ملفات الإعداد. يطبّق opencode الملف العام أولًا، ثم ملفات المشروع التي يجدها صعودًا من المجلد الحالي (الأبعد أولًا)، ثم أي إعداد في .opencode/، لذا يمكن لملف المشروع أن يتجاوز المزوّد العام. أما إعداد النظام المُدار، إن كانت شركتك تستخدمه، فيتقدّم على الاثنين. احتفظ بالمفتاح في متغيرات البيئة لا في الملف، حتى يمكن إدخال الإعداد في نظام التحكم بالإصدارات.

لماذا الأسماء البديلة

تحتوي معرّفات BroadNet أصلًا على شرطة مائلة (broadnet/glm-5.3). مفتاح الخريطة models هو ما يعرضه opencode ويختاره، وmodelID هو ما يرسله. والمفاتيح القصيرة تُبقي المراجع سهلة القراءة.

اضبط capabilities وlimit بنفسك. فمع نموذج خارج فهرسه، يفترض opencode دعم أدوات JSON، وإدخال النص والصور، وسياقًا من 200,000 رمز، و32,000 رمز للمخرجات. وتسمّي وثائقه هذه القيم افتراضات احتياطية لا قيمًا مكتشَفة. أما قيمة output البالغة 16000 أعلاه فهي اقتراحنا وليست حدًّا من BroadNet؛ فهي تترك مساحة للاستدلال المنطقي.

إعدادات V1 الأقدم

ما زال opencode V2 يقرأ صيغة V1، لذا تظل كتلة موجودة مثل هذه تعمل:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "broadnet": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BroadNet Inference",
      "options": {
        "baseURL": "https://inference.broadnet.ai/v1",
        "apiKey": "{env:BROADNET_API_KEY}"
      },
      "models": {
        "broadnet/glm-5.3": { "name": "GLM 5.3" }
      }
    }
  }
}

في صيغة V2 الأصلية يصبح provider هو providers، وnpm هو package (aisdk:@ai-sdk/openai-compatible إن أردت الإبقاء على حزمة AI SDK)، وينتقل options.baseURL وoptions.apiKey إلى settings. ويربط دليل الانتقال من V1 في opencode كل حقل بمقابله.

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

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

يعتمد opencode على استدعاءات الأدوات. ولا تدرج وثائق BroadNet استدعاء الأدوات لنموذج DeepSeek V4.1 Flash، لذا يَسِمه الإعداد بأنه افتراض يجب اختباره. نفّذ مهمة حقيقية خلال ساعة من خطة الشهاب (Meteor) ($1) قبل أن تشتري شهرًا من خطة البدر (Full Moon) ($60).

حل المشكلات

  • 401. المفتاح في BROADNET_API_KEY خاطئ أو منتهي الصلاحية، أو استُنفدت حصة الدفع حسب الاستخدام. تأكّد من ضبط المتغير في العملية التي تشغّل opencode.
  • النموذج غير موجود أو مرفوض. اختر مفتاح الخريطة (broadnet/glm-5.3)، وتأكّد من تطابق modelID مع معرّف BroadNet تمامًا. المراجع حساسة لحالة الأحرف. تحتاج النماذج المدفوعة إلى شحن الرصيد؛ فرصيد $5 لا يغطي إلا broadnet/gemma-4-26b-a4b ونموذجَي Transcribe.
  • إجابات فارغة. ارفع limit.output. لماذا تصل الإجابات فارغة.
  • 429. تسمح مفاتيح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 قيد التنفيذ. وإعادات المحاولة تُحتسب أيضًا. راجع الأخطاء وإعادة المحاولة.
  • وكلاء فرعيون على خطة. تعالج كل جلسة خطة طلبًا واحدًا في كل مرة، لذا تصطفّ الوكلاء الفرعية المتوازية في طابور ما لم تكن لكل منها جلسة خاصة.

أسئلة شائعة

لماذا لا يجد opencode نموذج BroadNet الخاص بي؟

يحلّ opencode المرجع بصيغة provider/مفتاح الخريطة، والمعرّفات حساسة لحالة الأحرف. مع الإعداد أدناه، اختر broadnet/glm-5.3، حيث glm-5.3 هو مفتاح الخريطة. أما قيمة modelID فهي فقط ما يُرسَل إلى BroadNet.

يستخدم إعدادي provider وnpm مع @ai-sdk/openai-compatible. هل هذا خطأ؟

لا. هذه صيغة V1، ويقول دليل الانتقال في opencode إنها ما زالت مدعومة. وفي صيغة V2 الأصلية يصبح provider هو providers، وnpm هو package (aisdk:@ai-sdk/openai-compatible)، وoptions.baseURL هو settings.baseURL.

لماذا تصل ردود opencode فارغة؟

أنفق النموذج ميزانية المخرجات على الاستدلال المنطقي. ارفع limit.output للنموذج. فالاستدلال المنطقي يُحتسب ضمن max_tokens في BroadNet.

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