BroadRouter

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

آخر تحديث

في goose، أضف مزوّدًا مخصّصًا من نوع OpenAI Compatible، بعنوان API هو https://inference.broadnet.ai/v1/chat/completions، ومفتاح BroadNet، ونماذج متاحة مثل broadnet/glm-5.3. استخدم زر Add Custom Provider في goose Desktop، أو goose configure في الطرفية، أو ملف JSON في ~/.config/goose/custom_providers/. يعتمد goose على استدعاء الأدوات، فابدأ بـ GLM 5.3 أو Qwen3.8 27B.

goose وكيل ذكاء اصطناعي مفتوح المصدر، له تطبيق سطح مكتب وواجهة سطر أوامر (CLI). والخدمات غير المدمجة فيه تُضاف بوصفها مزوّدين مخصّصين (custom providers)، وgoose يدعم المزوّدين المتوافقين مع OpenAI. وبما أن BroadNet Inference تقدّم chat completions القياسية، فهي تعمل بهذه الطريقة. BroadRouter هو موقع BroadNet نفسها؛ وتتبع الخطوات توثيق goose للمزوّدين كما هو في goose 1.59.

ينبّه توثيق goose إلى أنه “extensively uses tool calling” (ترجمة: يستخدم استدعاء الأدوات بكثافة)، وإلى أن النماذج التي لا تدعمه لا تستطيع إلا المحادثة مع تعطيل كل الإضافات. وBroadNet تُدرج استدعاء الأدوات لنموذجَي GLM 5.3 وQwen3.8 27B، فاستخدم أحدهما لعمل الوكلاء.

الخيار 1: goose Desktop

  1. افتح الشريط الجانبي وانقر Settings، ثم تبويب Models.

  2. انقر Configure providers، ثم Add Custom Provider في الأسفل.

  3. املأ التفاصيل:

    الحقل القيمة
    Provider Type OpenAI Compatible
    Display Name BroadNet Inference
    API URL https://inference.broadnet.ai/v1/chat/completions
    API Key مفتاح BroadNet الخاص بك
    Available Models broadnet/glm-5.3, broadnet/qwen3.8-27b
    Streaming Support مفعّل
  4. انقر Create Provider، ثم اختره واختر نموذجًا.

الخيار 2: واجهة goose CLI

شغّل goose configure، واختر Custom Providers، ثم Add A Custom Provider، وأجب عن الأسئلة بالقيم نفسها: نوع API هو OpenAI Compatible، وعنوان API أعلاه، والمصادقة Yes بمفتاح API ثابت، وقائمة النماذج مفصولة بفواصل، والتدفق (streaming) مفعّل.

الخيار 3: ملف JSON

أنشئ الملف ~/.config/goose/custom_providers/broadnet.json (وعلى Windows في %APPDATA%\Block\goose\config\custom_providers\):

{
  "name": "broadnet",
  "engine": "openai",
  "display_name": "BroadNet Inference",
  "description": "BroadNet Inference, OpenAI-compatible",
  "api_key_env": "BROADNET_API_KEY",
  "base_url": "https://inference.broadnet.ai/v1/chat/completions",
  "models": [
    { "name": "broadnet/glm-5.3", "context_limit": 1048576 },
    { "name": "broadnet/qwen3.8-27b", "context_limit": 262144 },
    { "name": "broadnet/deepseek-v4.1-flash", "context_limit": 1048576 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}

ثم ابدأ جلسة به:

export BROADNET_API_KEY='your-broadnet-key'
goose session start --provider broadnet

يمكن وضع الملف في مستودع ليستخدمه فريقك، لأن المفتاح يبقى في متغيرات البيئة.

اختبر الإعداد

ابدأ بسؤال بسيط، مثل “what can you do?”. إن جاءت إجابة، فالاتصال يعمل. ثم اطلب شيئًا يحتاج إلى إحدى الإضافات المفعّلة لديك. إن استدعى goose الأداة، فاستدعاء الأدوات يعمل أيضًا. وإن اكتفى بالرد نصًا ولم يستدعِ أي أداة، فانتقل إلى broadnet/glm-5.3.

الأسعار في goose

يستطيع goose تقدير التكلفة إن كان لكل نموذج في ملف JSON الحقلان input_token_cost وoutput_token_cost بالدولار الأمريكي لكل رمز (token). خذ الأرقام من صفحة الأسعار في BroadNet، واقسم سعر المليون رمز على 1,000,000. ومن دون الحقلين كليهما، يرجع goose إلى أسعار الكتالوج الخاص به، وقد لا تطابق أسعار BroadNet.

حل المشكلات

  • 401. المفتاح خاطئ أو منتهي الصلاحية أو استنفد رصيده، أو أن BROADNET_API_KEY غير مضبوط في الطرفية التي تشغّل goose.
  • 404. تحقّق من عنوان API؛ يجب أن يكون https://inference.broadnet.ai/v1/chat/completions. وتحقّق من أن معرّف النموذج يطابق معرّف BroadNet تمامًا. النماذج المدفوعة تحتاج إلى شحن الرصيد؛ والرصيد البالغ $5 يغطي broadnet/gemma-4-26b-a4b ونموذجَي Transcribe، وسياق Gemma البالغ 32,768 رمزًا صغير على عمل الوكلاء.
  • إجابات فارغة. يُحتسب الاستدلال المنطقي ضمن حد المخرجات في DeepSeek V4.1 Flash وGLM 5.3 وQwen3.8 27B. راجع لماذا تعود الإجابات فارغة.
  • 429. يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 قيد التنفيذ. راجع الأخطاء وإعادة المحاولة.
  • تنتظر الطلبات أو تفشل مع جلستين من goose على مفتاح خطة واحد. تشغّل جلسة الخطة طلبًا واحدًا في كل مرة، فأعطِ كل جلسة من goose جلسة خطة خاصة بها.

أسئلة شائعة

هل ينتهي عنوان API في goose بـ /v1 أم بـ /v1/chat/completions؟

يستخدم مثال goose نفسه للمزوّد المخصّص عنوان chat completions الكامل، فاستخدم https://inference.broadnet.ai/v1/chat/completions. وهذا يُبقي goose أيضًا على chat completions، وهو ما تقدّمه BroadNet.

ما أفضل نموذج من BroadNet للعمل مع goose؟

GLM 5.3 (broadnet/glm-5.3). يقول توثيق goose إنه يستخدم استدعاء الأدوات بكثافة، وBroadNet لا تُدرج الأدوات إلا لنموذجَي GLM 5.3 وQwen3.8 27B.

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

تغطي الخطط نموذج DeepSeek V4.1 Flash فقط، ولا يُدرج توثيق BroadNet استدعاء الأدوات له. ويقول goose إن النماذج التي لا تدعم استدعاء الأدوات لا تستطيع إلا المحادثة مع تعطيل الإضافات، فاختبره قبل شراء شهر.

أين يحفظ goose مفتاح API؟

في سلسلة مفاتيح النظام (keychain)، أو في secrets.yaml إن كانت سلسلة المفاتيح معطّلة. ومع ملف JSON، يقرأ goose بدلًا من ذلك المتغير المسمّى في api_key_env.

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