استخدام BroadNet Inference في n8n (بيانات اعتماد OpenAI وBase URL)
آخر تحديث
في n8n، أنشئ بيانات اعتماد OpenAI تضع فيها مفتاح BroadNet في API Key وتضبط Base URL على https://inference.broadnet.ai/v1. وفي عقدة OpenAI Chat Model، غيّر وضع Model من From List إلى ID، وأدخل معرّفًا من BroadNet مثل broadnet/glm-5.3، ثم أوقف Use Responses API ليستدعي n8n مسار chat completions.
n8n أداة لأتمتة سير العمل. وتحتوي بيانات اعتماد OpenAI فيها على حقل Base URL، لذا تستطيع عقدة OpenAI Chat Model (وعقد OpenAI الأخرى التي تستخدم بيانات الاعتماد هذه) استدعاء أي واجهة API متوافقة مع OpenAI، ومنها BroadNet Inference. لا تعرض صفحة توثيق n8n الخاصة ببيانات الاعتماد حقل Base URL، لذا راجعنا أسماء الحقول أدناه في الشيفرة المصدرية لـ n8n أيضًا، والروابط في المصادر.
الإعداد
أنشئ بيانات الاعتماد. في n8n، انتقل إلى Credentials، وأنشئ بيانات اعتماد جديدة من نوع OpenAI، واملأ الحقول:
الحقل
القيمة
API Key
مفتاح BroadNet الخاص بك
Organization ID (اختياري)
اتركه فارغًا
Base URL
https://inference.broadnet.ai/v1
احفظها. يختبر n8n بيانات الاعتماد باستدعاء /models على عنوان Base URL.
أضف عقدة النموذج. أضف عقدة AI Agent أو Basic LLM Chain، ثم اربط بها عقدة فرعية OpenAI Chat Model واختر بيانات الاعتماد.
حدّد النموذج بالمعرّف. في Model، غيّر الوضع من From List إلى ID وأدخل broadnet/glm-5.3.
أوقف Use Responses API. في الشيفرة المصدرية لـ n8n، يوجد هذا الخيار بدءًا من إصدار العقدة 1.3 ويكون مفعّلًا افتراضيًا فيه. وبما أن BroadNet تقدّم chat completions، فأوقفه.
اضبط الخيارات. تحت Options، اترك Maximum Number of Tokens على قيمته الافتراضية (-1) أو اضبطه على بضعة آلاف. القيمة الافتراضية لـ Max Retries هي 2؛ ارفعها إن أردت أن يعيد n8n محاولة الاستدعاءات الفاشلة أكثر.
شغّل سير العمل مرة واحدة بأمر تجريبي.
يعرض n8n تنبيهًا حين تستخدم Base URL لا يتبع OpenAI، مفاده أن بعض النماذج قد لا تكون متوافقة مع المحادثة أو لا تدعم استدعاء الأدوات أو صيغة استجابة JSON. أما في BroadNet، فالمحادثة تعمل على كل نماذج المحادثة، لكن توثيق BroadNet يُدرج الأدوات والمخرجات المنظَّمة لنموذجَي GLM 5.3 وQwen3.8 27B فقط.
أي نموذج تختار
سير العمل
النموذج
السبب
AI Agent مع أدوات
broadnet/glm-5.3
تُدرج BroadNet له الأدوات والمخرجات المنظَّمة
الصور، والرسائل العربية
broadnet/qwen3.8-27b
أدوات، وإدخال الصور، ومُختبَر بالعربية
التصنيف بأحجام كبيرة
broadnet/gemma-4-26b-a4b
سعر منخفض لكل رمز؛ لا يُدرج له استدلال منطقي
المستندات الطويلة
broadnet/deepseek-v4.1-flash
سياق مليون رمز؛ الأدوات غير مُدرجة
قارن الأسعار في صفحة الأسعار. وللصوت، تستطيع عقدة HTTP Request في n8n إرسال الملفات إلى /v1/audio/transcriptions؛ ويعرض دليل تحويل الصوت العربي إلى نص حقول النموذج التي ترسلها.
حل المشكلات
يفشل اختبار بيانات الاعتماد. تأكّد أن Base URL ينتهي بـ /v1 دون مسار بعده. وإن كانت استدعاءات المحادثة تُرجع 401 أيضًا، فالمفتاح خاطئ أو منتهي الصلاحية أو استنفد رصيد الدفع حسب الاستخدام.
أخطاء النموذج. استخدم وضع ID وأدخل معرّف BroadNet الدقيق مع البادئة broadnet/. تحتاج نماذج GLM 5.3 وQwen3.8 27B وDeepSeek V4.1 Flash إلى شحن الرصيد؛ أما الرصيد المبدئي البالغ $5 فيغطي BroadNet Gemma 4 VL 26B.
“Bad request - please check your parameters”. يقترح توثيق n8n تكرار الاستدعاء في عقدة HTTP Request لرؤية الخطأ كاملًا. والسبب الشائع هنا هو خيار Responses API.
مخرجات فارغة. يُحتسب الاستدلال المنطقي ضمن Maximum Number of Tokens. ارفع القيمة. راجع لماذا تعود الإجابات فارغة.
الخطأ 429 في الحلقات. يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 في آنٍ واحد. ويقترح توثيق n8n استخدام Loop Over Items مع عقدة Wait لتنظيم وتيرة الدفعات. راجع الأخطاء وإعادة المحاولة.
عمليات تنفيذ متوازية على مفتاح خطة.جلسة الخطة غير المحدودة تشغّل طلبًا واحدًا في كل مرة، فتنتظر عمليات تنفيذ سير العمل المتوازية في طابور ما لم تكن لكلٍّ منها جلستها الخاصة.
تفضّل الشيفرة؟ الإعدادات نفسها تعمل في LangChain، الذي بُنيت عليه عقد الذكاء الاصطناعي في n8n.
أسئلة شائعة
لماذا يفشل AI Agent في n8n مع BroadNet؟
تأكّد أن Use Responses API متوقف في عقدة OpenAI Chat Model. ففي إصدار العقدة 1.3 يكون مفعّلًا افتراضيًا، بينما تقدّم BroadNet المسار /v1/chat/completions لا Responses API. واضبط Model أيضًا على وضع ID مع معرّف BroadNet الدقيق.
لماذا تظهر قائمة النماذج فارغة أو خاطئة؟
يقرأ وضع From List نقطة النهاية /models لدى المزوّد، ويصفها توثيق BroadNet بأنها بيانات وصفية عامة للكتالوج مخصّصة لأدوات المراقبة. غيّر Model إلى وضع ID واكتب معرّف نموذج BroadNet.
لماذا يُرجع وكيل n8n مخرجات فارغة؟
استهلك الاستدلال المنطقي قيمة Maximum Number of Tokens كلها. ارفعها، أو اتركها على القيمة الافتراضية -1.
أين حقل Base URL في بيانات اعتماد OpenAI في n8n؟
هو في بيانات اعتماد OpenAI نفسها، أسفل API Key وOrganization ID. قيمته الافتراضية https://api.openai.com/v1. ضع مكانها https://inference.broadnet.ai/v1، مع الإبقاء على /v1 ودون إضافة أي مسار بعدها.