Langflow أداة مرئية مفتوحة المصدر لبناء الوكلاء ومسارات RAG. ولمكوّن OpenAI فيها حقل OpenAI API Base يتيح، بعبارة المكوّن نفسه، “use other APIs” (ترجمة: استخدام واجهات API أخرى). وبما أن BroadNet Inference تقدّم chat completions على https://inference.broadnet.ai/v1، فإن هذا المكوّن يعمل مع معرّف نموذج من BroadNet تكتبه يدويًا. BroadRouter هو موقع BroadNet نفسها؛ وتتبع الخطوات توثيق Langflow 1.13.x والشيفرة المصدرية للمكوّن في v1.13.2.
الإعداد
-
أضف المكوّن. في المسار (flow)، افتح لوحة المكوّنات وأضف OpenAI من حزمة OpenAI. يثبّت Langflow 1.13.2 هذه الحزمة مع الحزمة الرئيسية.
-
Model Name. انقر الحقل واكتب
broadnet/glm-5.3. فهو يقبل قيمًا مخصّصة، فلست مقيّدًا بنماذج OpenAI الموجودة في القائمة. -
OpenAI API Key. الصق مفتاح BroadNet، أو اختر متغيرًا عامًا (global variable) يحمله.
-
الإعدادات المتقدمة. افتح عناصر التحكم في المكوّن واضبط:
الحقل القيمة OpenAI API Base https://inference.broadnet.ai/v1Max Tokens 4000 -
شغّله. اربط Chat Input وChat Output، وافتح Playground وأرسل رسالة. إن جاء رد، فالإعدادات صحيحة.
فحصان في Langflow قد يحجبان BroadNet
الحماية من SSRF مفعّلة افتراضيًا في Langflow 1.13. وتهمّك قاعدتان:
-
المفاتيح القادمة من بيئة الخادم. إذا جاء مفتاح API من بيئة الخادم (مثل متغير عام يُحمَّل من متغير بيئة)، يرفض Langflow إرساله إلى نقطة نهاية غير افتراضية ما لم يكن المضيف في قائمة السماح. يضبط المشغّل:
export LANGFLOW_PROVIDER_CREDENTIAL_ALLOWED_HOSTS=inference.broadnet.aiأما المفتاح المكتوب داخل المكوّن فلا يتأثر.
-
العناوين الخاصة. عناوين loopback وعناوين IP الخاصة محجوبة ما لم تكن في
LANGFLOW_SSRF_ALLOWED_HOSTS. وBroadNet مضيف HTTPS عام، فلا يهمّك هذا إلا إذا مرّرت الطلبات عبر وكيل (proxy) محلي.
لماذا لا نستخدم مزوّد OpenAI Compatible؟
في Langflow 1.13 أيضًا مزوّد نماذج باسم OpenAI Compatible تحت Settings → Model Providers. ويقول توثيقه إنه يتحقق من الاتصال عبر المسار /v1/models في نقطة النهاية ويعرض النماذج التي يجدها. وحين تحققنا في 16 نوفمبر 2026، لم يُدرج المسار /v1/models في BroadNet إلا broadnet/cohere-transcribe-arabic وbroadnet/cohere-transcribe، فلا يمكن اختيار نماذج المحادثة هناك. أما اسم النموذج المكتوب يدويًا في مكوّن OpenAI فيتجاوز هذه المشكلة.
أي نموذج تختار
| المسار | النموذج |
|---|---|
| مكوّن Agent مع الأدوات | broadnet/glm-5.3 |
| مسارات فيها صور أو نصوص عربية، مع الأدوات | broadnet/qwen3.8-27b |
| مسارات المستندات الطويلة، على خطة بسعر ثابت | broadnet/deepseek-v4.1-flash |
| تجربة Langflow بالرصيد المبدئي | broadnet/gemma-4-26b-a4b (سياق 32,768 رمزًا) |
يُدرج توثيق BroadNet الأدوات والمخرجات المنظَّمة لنموذجَي GLM 5.3 وQwen3.8 27B فقط. يرسل خيار JSON Mode في المكوّن response_format: {"type": "json_object"}؛ فاستخدمه مع هذين النموذجين. أسعار كل النماذج.
كيف اختبرنا هذا
لم نشغّل واجهة Langflow. في 2026-11-15 ثبّتنا lfx 1.13.2 وحزمة lfx-openai، التي يطابق ملف مكوّن OpenAI فيها الشيفرة المصدرية في v1.13.2، وبنينا المكوّن بلغة Python مقابل خادم وهمي (mock) محلي يتحدث بنية chat completions الخاصة بـ BroadNet. مع مفتاح مكتوب في المكوّن وضبط LANGFLOW_SSRF_ALLOWED_HOSTS للخادم الوهمي المحلي، ذهب الطلب إلى /v1/chat/completions بمعرّف النموذج broadnet/glm-5.3 دون تغيير، ومفتاح Bearer، وtemperature: 0.1، وقيمة seed. وأُرسلت قيمة Max Tokens في الحقل max_completion_tokens، بينما يصف المرجع التقني لـ BroadNet الحقل max_tokens. أما المفتاح المنسوخ من بيئة الخادم فرُفض حتى ضبطنا LANGFLOW_PROVIDER_CREDENTIAL_ALLOWED_HOSTS أيضًا. لم يكن لدينا مفتاح BroadNet، لذا لم نختبر مخرجات نموذج حقيقية.
حل المشكلات
- “Refusing to send a server-provisioned API credential” (ترجمة: رفض إرسال بيانات اعتماد API مصدرها الخادم). أضف
inference.broadnet.aiإلىLANGFLOW_PROVIDER_CREDENTIAL_ALLOWED_HOSTS، أو اكتب المفتاح في المكوّن. - 401. المفتاح خاطئ، أو منتهي الصلاحية، أو استنفد رصيده.
- 404. يجب أن ينتهي OpenAI API Base بـ
/v1، وأن يطابق Model Name معرّف BroadNet تمامًا. النماذج المدفوعة تحتاج إلى شحن الرصيد؛ والرصيد البالغ $5 يغطيbroadnet/gemma-4-26b-a4bونموذجَي Transcribe فقط. - ردود فارغة. يُحتسب الاستدلال المنطقي ضمن حد المخرجات في DeepSeek V4.1 Flash وGLM 5.3 وQwen3.8 27B. ارفع Max Tokens. راجع لماذا تعود الإجابات فارغة.
- 429. يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 قيد التنفيذ. راجع الأخطاء وإعادة المحاولة.
