---
title: "إعداد مزوّد مخصّص متوافق مع OpenAI في goose | BroadRouter"
description: "اربط وكيل الذكاء الاصطناعي goose بـ BroadNet Inference كمزوّد مخصّص من نوع OpenAI Compatible، من goose Desktop أو goose configure أو ملف JSON."
url: https://broadrouter.com/ar/guides/goose-custom-provider/
lang: ar
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. [اقرأ الأصل الإنجليزي](https://broadrouter.com/guides/goose-custom-provider/) (حُدّث في 2026-11-16).

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

آخر تحديث 2026-11-16

في 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 للمزوّدين](https://goose-docs.ai/docs/getting-started/providers/) كما هو في 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\`):

```json
{
  "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
}
```

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

```bash
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). خذ الأرقام من [صفحة الأسعار](https://broadrouter.com/ar/pricing/) في 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. راجع [لماذا تعود الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **429.** يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 قيد التنفيذ. راجع [الأخطاء وإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).
-   **تنتظر الطلبات أو تفشل مع جلستين من goose على مفتاح خطة واحد.** تشغّل [جلسة الخطة](https://broadrouter.com/ar/guides/unlimited-llm-api-sessions/) طلبًا واحدًا في كل مرة، فأعطِ كل جلسة من goose جلسة خطة خاصة بها.

## مصطلحات في هذا الدليل

[استدعاء الأدوات (Tool calling)](https://broadrouter.com/ar/glossary/tool-calling/)

استدعاء الأدوات، ويُسمّى أيضًا استدعاء الدوال (function calling)، ميزة في واجهات LLM API يُرجع فيها النموذج طلبًا منظَّمًا لتشغيل دالة عرّفها المطوّر، مع معاملات بصيغة JSON. ويشغّل التطبيق الدالة ويعيد النتيجة؛ فالنموذج لا يشغّل الشيفرة بنفسه أبدًا.

[الرمز (التوكن، Token)](https://broadrouter.com/ar/glossary/token/)

الرمز (التوكن) هو وحدة النص التي يقرؤها نموذج اللغة ويكتبها: كلمة، أو جزء من كلمة، أو علامة ترقيم، أو تسلسل بايتات ينتجه مجزّئ النموذج (tokenizer). وتَعُدّ واجهات LLM API الاستهلاك بالرموز، وتضع حدودها بها، وتحتسب تكلفتها بها عادةً.

[البث المتدفق (Streaming)](https://broadrouter.com/ar/glossary/streaming/)

البث المتدفق (streaming) طريقة لإرجاع استجابة النموذج اللغوي على أجزاء صغيرة أثناء توليدها، بدل إرجاعها ردًا واحدًا في النهاية. وتبث الواجهات المتوافقة مع OpenAI عبر أحداث يرسلها الخادم (server-sent events) حين يضبط الطلب stream على true.

[الدفع حسب الاستخدام (Pay-as-you-go)](https://broadrouter.com/ar/glossary/pay-as-you-go/)

الدفع حسب الاستخدام هو نموذج تسعير تدفع فيه مقابل ما تستخدمه فقط، مقيسًا بوحدات مثل الرموز (التوكنات) أو الطلبات أو دقائق الصوت، دون اشتراك أو حد أدنى للالتزام. وتحتسب معظم واجهات LLM API تكلفتها بهذه الطريقة، من رصيد مدفوع مسبقًا أو بفاتورة دورية.

[التزامن (Concurrency)](https://broadrouter.com/ar/glossary/concurrency/)

التزامن (concurrency) هو عدد الطلبات التي تكون لدى العميل قيد التنفيذ في الوقت نفسه. وكثيرًا ما تضع واجهات LLM API سقفًا له لكل مفتاح أو خطة، بمعزل عن عدد الطلبات في الدقيقة، لأن كل طلب مفتوح يشغل قدرة من وحدة GPU حتى تكتمل استجابته.

[الرصيد المدفوع مسبقًا (Prepaid credit)](https://broadrouter.com/ar/glossary/prepaid-credit/)

الرصيد المدفوع مسبقًا هو مال يُضاف إلى حساب API قبل الاستخدام. يُخصم من الرصيد ثمن كل طلب، وعندما ينفد الرصيد تتوقف الطلبات المحتسبة بالاستهلاك حتى تشحن رصيدك. وهو يحصر الإنفاق في حدود ما دفعته.

[حد المعدل (Rate limit)](https://broadrouter.com/ar/glossary/rate-limit/)

حد المعدل هو سقف تفرضه واجهة API على مقدار استخدام العميل لها خلال فترة زمنية، مثل عدد الطلبات في الدقيقة أو الرموز في الدقيقة. وتُرفض الطلبات التي تتجاوزه، غالبًا بالخطأ HTTP 429 Too Many Requests، إلى أن يعود الاستخدام تحت الحد.

[مفتاح API (API key)](https://broadrouter.com/ar/glossary/api-key/)

مفتاح API هو سلسلة نصية سرية تعرّف العميل الذي يستدعي الواجهة وتخوّله. تتوقعه واجهات LLM API عادةً في الترويسة Authorization: Bearer، وكل من يملك المفتاح يستطيع إرسال طلبات تُحتسب تكلفتها على الحساب المالك له.

## أسئلة شائعة

### هل ينتهي عنوان 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.

## أدلة ذات صلة

-   [استخدام Kilo Code مع BroadNet Inference (مزوّد OpenAI Compatible)](https://broadrouter.com/ar/guides/kilo-code-openai-compatible/)
-   [إضافة BroadNet Inference إلى opencode كمزوّد مخصّص](https://broadrouter.com/ar/guides/opencode-custom-provider/)
-   [كيف تعمل خطط LLM API غير المحدودة مع الوكلاء](https://broadrouter.com/ar/guides/unlimited-llm-api-sessions/)
-   [رموز أخطاء BroadNet Inference ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/)
-   [كل الأدوات التي تعمل مع BroadNet Inference (بالإنجليزية)](https://broadrouter.com/integrations/): حِزم SDK ووكلاء البرمجة وواجهات الدردشة وأدوات الأتمتة، مع الإعدادات الدقيقة لكل منها

جرّبه على مهامك الفعلية. تبدأ الحسابات الجديدة برصيد قدره $5 لاستخدام Gemma والتفريغ الصوتي. أما DeepSeek وGLM وQwen3.8 فتتطلب شحن الرصيد.

[ابدأ الآن](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-goose-custom-provider&utm_content=page-cta) ·

**المصادر**

-   [توثيق goose، صفحة Model providers وConfigure Custom Provider (رُوجع في 2026-11-15)](https://goose-docs.ai/docs/getting-started/providers/)
-   [goose على GitHub (aaif-goose/goose)، وأحدث إصدار v1.59.1 (رُوجع في 2026-11-15)](https://github.com/aaif-goose/goose)
-   [المرجع التقني لـ BroadNet Inference API (رُوجع في 2026-11-15) (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-goose-custom-provider&utm_content=sources)
