Hermes Agent مع 9Router: الإعداد والنماذج والإصلاحات

ما هو 9Router

يصف README الخاص به 9Router بأنه موجّه ذكي: تتحدث أداتك مع نقطة نهاية محلية واحدة، ويرسل 9Router كل طلب إلى مزوّد ربطته في لوحة تحكمه. وهو يترجم بين صيغ الطلبات (يذكر README صيغ OpenAI وClaude وGemini وغيرها)، ويتتبع الحصة، ويجدد رموز تسجيل الدخول للحسابات التي تربطها. المشروع بترخيص MIT.

• عنوان واحد. واجهة API المتوافقة مع OpenAI على http://localhost:20128/v1 ولوحة التحكم على http://localhost:20128/dashboard.
• المزوّدون في لوحة التحكم. تربط حسابات اشتراك أو مفاتيح API مدفوعة أو الخيارات المجانية التي يسردها README. أيّ هذه الخيارات موجود، وبأي شروط، أمر يعود لكل مزوّد ويتغير بمرور الوقت.
• التركيبات (Combos). التركيبة قائمة مسماة من النماذج. يضع مثال README نموذج اشتراك أولًا، ونموذجًا أرخص ثانيًا، ونموذجًا مجانيًا أخيرًا، ويقول إن 9Router ينتقل إلى الإدخال التالي عندما تنفد الحصة أو يقع خطأ. ثم تستخدم اسم التركيبة كاسم للنموذج.
• توفير الرموز. يصف README ميزة اسمها RTK تضغط مخرجات الأدوات قبل إرسالها، وهي مفعّلة افتراضيًا. يستدعي Hermes أدوات كثيرة، فهذا يستحق أن تعرفه.

ثبّته بالأمر npm install -g 9router، ثم شغّل 9router. ويوثّق README أيضًا صورة Docker وإعدادًا على VPS. وحجة README نفسه تدور حول توفير المال وتجنب بلوغ الحدود؛ تعامل مع ذلك على أنه وصف المشروع لنفسه، لا وعدًا بما ستحصل عليه.

وجّه Hermes إلى 9Router

تقول وثائق Hermes إنه يعمل مع أي نقطة نهاية API متوافقة مع OpenAI تنفّذ /v1/chat/completions، وتذكر الموجّهات متعددة المزوّدين بين الأمثلة. و9Router ينطبق عليه هذا الوصف. تحتاج إلى ثلاث قيم:

تخبر البادئة قبل الشرطة المائلة 9Router بأي اتصال مزوّد يستخدم. تعرض قوائم النماذج في README البوادئ cc/ وgh/ وkr/ وoc/ وvertex/ وغيرها. وما تستطيع استخدامه يعتمد على ما ربطته، فانسخ الأسماء الدقيقة من 9Router الخاص بك.

أسرع طريق هو معالج الإعداد، شغّله في الطرفية خارج أي محادثة:

hermes model

اختر خيار نقطة النهاية المخصصة وأدخل العنوان الأساسي والمفتاح واسم النموذج عندما يُطلب منك. وتوصي وثائق Hermes بهذا المعالج لنقاط النهاية المخصصة. أما داخل محادثة قيد التشغيل، فيستطيع /model التبديل فقط بين مزوّدين أعددتهم من قبل.

شكل config.yaml

يمكن كتابة الإعداد نفسه يدويًا. تعرض وثائق Hermes هذا الشكل لنقطة نهاية مخصصة واحدة، مع key_env بديلًا عن وضع المفتاح في الملف:

# ~/.hermes/config.yaml
model:
  default: my-combo
  provider: custom
  base_url: http://localhost:20128/v1
  key_env: NINE_ROUTER_API_KEY

هنا يمثل my-combo اسم النموذج أو التركيبة الذي اخترته، ويذهب المفتاح نفسه في متغير البيئة الذي يسميه key_env.

إذا كانت لديك أكثر من نقطة نهاية، فتصف وثائق Hermes مزوّدين مخصصين مسمّين تحت مفتاح providers: في المستوى الأعلى، لكل إدخال عنوانه الخاص وkey_env. وتستخدم README الإضافة هذا الشكل لـ 9Router، بالاسم 9router:

providers:
  9router:
    base_url: http://127.0.0.1:20128/v1
    key_env: NINE_ROUTER_API_KEY

تلك الكتلة هي مثال README الإضافة. وتذكر وثائق Hermes base_url اسمًا بديلًا مقبولًا للحقل api في إدخال مسمّى، فهي تطابق الشكل الموثّق؛ قارنها بقسم المزوّد المخصص في وثائق Hermes لإصدارك قبل الاعتماد عليها. ومع مزوّد مسمّى، تعرض الوثائق التبديل داخل المحادثة بالصيغة /model custom:name:model.

يستطيع 9Router وHermes كلاهما الرجوع إلى بديل، وقد يختلط الأمر. تركيبة 9Router تغيّر المزوّد داخل 9Router، ويرى Hermes نقطة نهاية واحدة. أما قائمة fallback_providers الخاصة بـ Hermes فتنتقل إلى مزوّد Hermes آخر عندما يفشل الرئيسي، وتقبل نقطة نهاية مخصصة أيضًا مع base_url وkey_env.

تحقق من أنه يعمل

ابدأ بالموجّه وحده. يقول README إن GET /v1/models يعيد كل النماذج والتركيبات بصيغة OpenAI، فمن الجهاز الذي يعمل عليه Hermes:

curl http://localhost:20128/v1/models

إذا كان 9Router لديك يتطلب مفتاحًا، فأضف ترويسة Authorization: Bearer به. قائمة JSON بالنماذج تعني أن العنوان صحيح ويمكن الوصول إليه من هناك. وتقدم وثائق Hermes النصيحة نفسها لأي خادم نماذج محلي: إذا عرض ذلك الاستدعاء نماذجك، فاضبط base_url على http://localhost:20128/v1، دون /models في النهاية.

ثم شغّل Hermes وأرسل رسالة قصيرة. تقول وثائق Hermes إن /model custom دون اسم نموذج يسأل قائمة نماذج نقطة النهاية ويختار النموذج إذا كان واحد فقط متاحًا. وعادةً يعرض 9Router كثيرًا منها، فسمِّ النموذج بنفسك. الرد يثبت أن Hermes تلقى إجابة. وراجع عرض الاستخدام في لوحة تحكم 9Router لتتأكد أن 9Router عالج الطلب وأي مزوّد استخدم؛ وإذا أعددت مزوّدًا احتياطيًا في Hermes، فقد يكون هو من أجاب.

إضافة لوحة التحكم hermes-9router

توجد أيضًا إضافة مجتمعية اسمها hermes-9router، من تطوير aligundogar، مدرجة في كتالوج إضافات Hermes. تضيف تبويبًا إلى لوحة تحكم Hermes لمراقبة بوابة 9Router، وتتطلب Hermes 0.23.0 أو أحدث. ثبّتها بالأمر:

hermes plugins install https://github.com/aligundogar/hermes-9router

تتوقع كتلة المزوّد 9router من القسم السابق، والمفتاح في NINE_ROUTER_API_KEY، وإعادة تشغيل لوحة التحكم بعد التثبيت. وضبط NINE_ROUTER_ADMIN_PASSWORD اختياري ويفتح بيانات الاتصال وفترات التهدئة. وللوحة التحكم نفسها، راجع لوحة تحكم Hermes Agent؛ ولإضافات أخرى، إضافات Hermes Agent.

ما يعرضه التبويب، بحسب README وإدخال الكتالوج:

• نماذج الموجّه مجمّعة حسب بادئة المسار، مع آخر نتيجة اختبار لكل منها.
• زمن استجابة الاستدعاء /models.
• مع كلمة مرور المسؤول: صحة الاتصال وأعداد فترات التهدئة.
• زر Test group يعيد اختبار مجموعة واحدة في كل مرة. ويبقى التوجيه وموازنة الأحمال في 9Router.

إفصاح الإضافة نفسها يستحق القراءة قبل أن تضغط أي شيء:

• تستدعي عنوان 9Router الموجود في إعداداتك فقط. وليس لها عمل في الخلفية ولا قياس عن بُعد.
• اختبار المجموعة يرسل طلبات chat/completions حقيقية بحد صغير للمخرجات، حتى 25 نموذجًا في كل ضغطة، فقد يستهلك رصيدًا أو حصة.
• تُقرأ الأسرار عبر Hermes ولا تُخزَّن. ومع كلمة مرور المسؤول، لا يصل إلى لوحة التحكم إلا اسم الاتصال والمزوّد وحالة النشاط وحالة الاختبار. وتُحفظ النتائج في ملف داخل مجلد Hermes الرئيسي لديك.

هي إضافة مجتمعية بالإصدار 0.1.0، وليست شيئًا تصونه Nous Research، فاقرأها كما تقرأ أي شفرة تثبّتها.

المشكلات الشائعة

• غياب /v1. عنوان API هو http://localhost:20128/v1، بينما http://localhost:20128 هو لوحة التحكم. استخدم العنوان الذي ينتهي بـ /v1 عنوانًا أساسيًا. (بالنسبة إلى مزوّد Actual تقول وثائق Hermes إن المضيف المجرد يُضاف إليه /v1 تلقائيًا؛ لا تعتمد على ذلك مع نقطة نهاية مخصصة.)
• مفتاح خاطئ أو مفقود. استخدم المفتاح من لوحة تحكم 9Router، وتأكد أن المتغير المسمى في key_env مضبوط في البيئة التي يعمل فيها Hermes، لا في الطرفية الحالية فقط. يقول README إن فرض المفتاح على /v1 معطّل افتراضيًا ويمكن تشغيله بـ REQUIRE_API_KEY.
• رفض اسم النموذج. انسخ الاسم تمامًا من /v1/models، مع البادئة. اسم النموذج دون بادئته سلسلة مختلفة. وتُستخدم التركيبة باسمها.
• 9Router لا يعمل. هو عملية على جهازك، فإذا توقف يتلقى Hermes أخطاء اتصال. شغّله من جديد بـ 9router، أو أعد تشغيل حاويته.
• Hermes و9Router على جهازين مختلفين أو في Docker. localhost تعني الجهاز أو الحاوية التي يعمل فيها البرنامج. تصف وثائق Hermes هذا في WSL2، حيث يحتاج WSL2 في وضع NAT الافتراضي إلى عنوان مضيف Windows للوصول إلى خادم نماذج على Windows، بينما يدعم الوضع المعكوس localhost. وينطبق المنطق نفسه على حاوية Hermes التي تصل إلى 9Router في مكان آخر. أمر Docker في README ينشر المنفذ 20128 بالخيار -p. راجع Hermes Agent في Docker لجانب الحاوية.
• أخطاء المزوّد خلف الموجّه. إذا بلغ حساب مرتبط حصته أو انتهى تسجيل دخوله، فالخطأ يأتي من ذلك المزوّد عبر 9Router. وتشير ملاحظات استكشاف الأخطاء في README إلى متتبع الحصة، أو تركيبة فيها بدائل، أو إعادة ربط المزوّد في لوحة التحكم.

لمشكلات النماذج المحلية عمومًا، مثل استدعاءات الأدوات المطبوعة كنص أو نافذة سياق أصغر من اللازم، لدى وثائق Hermes قسم لاستكشاف الأخطاء، وتغطي صفحتنا Hermes Agent مع Ollama الجانب المحلي.

ما يجب أن تزنه قبل الاعتماد عليه

• تمر طلباتك عبر أطراف أكثر. الطلبات المرسلة عبر عنوان 9Router لديك تُحوَّل إلى المزوّد الذي يختاره إعداد التوجيه. راجع ما تضمّنه في تلك الطلبات، وشروط المزوّد المختار.
• تحقق من شروط كل مزوّد. اقرأ شروط المزوّد قبل ربط حساب اشتراك.
• الطبقات المجانية والحصص تتغير. يلاحظ README نفسه أن بعض الطبقات المجانية أُوقفت وأن قائمة النماذج المجانية تتقلب. لا تبنِ شيئًا مهمًا على مسار مجاني دون بديل مدفوع. وتغطي صفحتنا هل Hermes Agent مجاني جانب التكلفة.
• أمّنه إن خرج من جهازك. يوصي README بفرض مفتاح API في عمليات النشر المكشوفة على الإنترنت، ويقول إن كلمة مرور أول تسجيل دخول تعود إلى 123456 عندما لا يُضبط INITIAL_PASSWORD. اضبط الاثنين قبل كشفه.
• هو شيء آخر عليك إبقاؤه قيد التشغيل. إذا توقف 9Router فإن الطلبات عبر ذلك العنوان تفشل؛ وقد يتيح مزوّد احتياطي في Hermes، إن أعددته، للوكيل أن يواصل العمل.

9Router وReadyHermes

لم نختبر 9Router مع ReadyHermes ولا نقدمه كمزوّد. يعمل 9Router على جهازك الخاص، بينما يعمل مساعد ReadyHermes على خوادمنا ولا يستطيع الوصول إلى 9Router على localhost في حاسوبك. يقبل تبويب مفتاح النموذج مفتاحًا من مزوّد مدرج وليس فيه حقل لعنوان أساسي مخصص. ولا ننصح بكشف 9Router على الإنترنت كي يمكن الوصول إليه.

يتضمن ReadyHermes الذكاء الاصطناعي بالفعل، بقيمة US$1 منه كل شهر على Lite وUS$3 على Pro، على الخطط التي تبدأ من US$3.99 شهريًا، ويقبل مفتاح مزوّدك الخاص. راجع استضافة Hermes Agent المُدارة أو الاستضافة الذاتية مقابل الاستضافة المُدارة لتقرر أيهما يناسبك.