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
-
افتح الشريط الجانبي وانقر Settings، ثم تبويب Models.
-
انقر Configure providers، ثم Add Custom Provider في الأسفل.
-
املأ التفاصيل:
الحقل القيمة Provider Type OpenAI Compatible Display Name BroadNet Inference API URL https://inference.broadnet.ai/v1/chat/completionsAPI Key مفتاح BroadNet الخاص بك Available Models broadnet/glm-5.3, broadnet/qwen3.8-27bStreaming Support مفعّل -
انقر 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 جلسة خطة خاصة بها.
