BroadRouter

ربط Langflow بـ BroadNet Inference (مكوّن OpenAI)

آخر تحديث

في Langflow، أضف مكوّن OpenAI من حزمة OpenAI. اكتب معرّفًا من BroadNet مثل broadnet/glm-5.3 في Model Name، والصق مفتاح BroadNet، ثم اضبط OpenAI API Base في الإعدادات المتقدمة على https://inference.broadnet.ai/v1. لا تستخدم مزوّد النماذج OpenAI Compatible، فهو يجلب النماذج من /v1/models، والمسار في BroadNet لا يُدرج إلا نموذجَي التفريغ الصوتي.

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.

الإعداد

  1. أضف المكوّن. في المسار (flow)، افتح لوحة المكوّنات وأضف OpenAI من حزمة OpenAI. يثبّت Langflow 1.13.2 هذه الحزمة مع الحزمة الرئيسية.

  2. Model Name. انقر الحقل واكتب broadnet/glm-5.3. فهو يقبل قيمًا مخصّصة، فلست مقيّدًا بنماذج OpenAI الموجودة في القائمة.

  3. OpenAI API Key. الصق مفتاح BroadNet، أو اختر متغيرًا عامًا (global variable) يحمله.

  4. الإعدادات المتقدمة. افتح عناصر التحكم في المكوّن واضبط:

    الحقل القيمة
    OpenAI API Base https://inference.broadnet.ai/v1
    Max Tokens 4000
  5. شغّله. اربط 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 قيد التنفيذ. راجع الأخطاء وإعادة المحاولة.

أسئلة شائعة

لماذا لا يُظهر مزوّد OpenAI Compatible نموذج GLM 5.3 أو Qwen؟

يقول توثيق Langflow إن هذا المزوّد يكتشف النماذج من المسار /v1/models في نقطة النهاية. وحين تحققنا في 16 نوفمبر 2026، لم يُدرج المسار /v1/models في BroadNet إلا نموذجَي التفريغ الصوتي، فلا تظهر نماذج المحادثة أبدًا. استخدم بدلًا منه مكوّن OpenAI مع اسم نموذج مكتوب يدويًا.

هل يمكنني كتابة نموذج غير موجود في قائمة مكوّن OpenAI؟

نعم. حقل Model Name من نوع combobox، وهذا يعني في تعريفات المدخلات في Langflow أن المستخدم يستطيع إدخال قيمة مخصّصة. اكتب معرّف BroadNet كاملًا، مثل broadnet/glm-5.3.

لماذا يرفض Langflow إرسال مفتاحي إلى BroadNet؟

لا يرسل Langflow 1.13 مفتاح API مصدره بيئة الخادم إلى نقطة نهاية مخصّصة ما لم يسمح المشغّل بالمضيف. اضبط LANGFLOW_PROVIDER_CREDENTIAL_ALLOWED_HOSTS=inference.broadnet.ai، أو الصق المفتاح في المكوّن نفسه.

هل يستخدم مكوّن OpenAI في Langflow واجهة Responses API؟

لا. فهو يبني ChatOpenAI من LangChain، الذي يستدعي chat completions في الطلبات العادية. وفي اختبارنا استدعى /v1/chat/completions.

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