دليل إعداد Hermes Agent
يتم حفظ نموذج Hermes Agent والمورد ونقطة النهاية المخصصة في ~/.hermes/config.yaml؛ وتُحفظ المعلومات الحساسة مثل API Key في ~/.hermes/.env. يستخدم ai2save واجهة OpenAI Compatible، و Base URL هو https://ai2save.com/v1.
1. إنشاء API Key
- افتح https://ai2save.com/keys.
- أنشئ مفتاحًا واختر المجموعة التي تحتوي على النموذج المستهدف.
- انسخ مفتاح
sk-...بالكامل. - سجّل معرف النموذج الحقيقي المعروض في وحدة التحكم، على سبيل المثال
gpt-5.5.
2. يُوصى باستخدام المعالج المدمج
قم بالتنفيذ في الطرفية:
hermes model
اختر حسب التعليمات:
Custom endpoint (self-hosted / vLLM / etc.)
أدخل بالترتيب:
API base URL: https://ai2save.com/v1
API key: sk-مفتاحك-الخاص
Model name: gpt-5.5
سوف يقوم الدليل بكتابة هذه القيم في ~/.hermes/config.yaml. لا تكتب Base URL في .env؛ وفقًا لاتفاق Hermes الرسمي، تأتي تكوينات نموذج endpoint من config.yaml.
3. تحرير ملفات التكوين يدويًا
تحرير ~/.hermes/config.yaml:
model:
provider: custom
default: gpt-5.5
base_url: https://ai2save.com/v1
key_env: AI2SAVE_API_KEY
توضيح الحقول:
provider: custom: استخدم أي نقطة نهاية OpenAI Compatible.default: معرف النموذج الافتراضي، يجب أن يتطابق تمامًا مع معرف النموذج المفتوح في وحدة التحكم.base_url: يجب أن يكون مع/v1، سيقوم Hermes بإجراء طلب/chat/completionsبناءً على ذلك.key_env: يشير إلى اسم متغير البيئة الذي يخزن المفتاح.
تحرير ~/.hermes/.env:
AI2SAVE_API_KEY=sk-مفتاحك-الخاص
.env حفظ المعلومات الحساسة، config.yaml حفظ تكوين النموذج غير الحساس. لا تقم بإرسال .env إلى Git.
4. استخدام أوامر التكوين للكتابة
يمكنك أيضًا استخدام أوامر Hermes المدمجة، لتجنب أخطاء YAML في المسافة البادئة:
hermes config set model.provider custom
hermes config set model.default gpt-5.5
hermes config set model.base_url https://ai2save.com/v1
hermes config set model.key_env AI2SAVE_API_KEY
hermes config set AI2SAVE_API_KEY sk-مفتاحك-الخاص
hermes config check
AI2SAVE_API_KEY هو اسم متغير بيئة بالحروف الكبيرة، وسيقوم Hermes تلقائيًا بكتابة ~/.hermes/.env.
5. إعادة التشغيل والتحقق
- قم بالخروج تمامًا من جلسة Hermes الحالية أو Gateway.
- أعد تشغيل Hermes.
- أنشئ جلسة جديدة وأرسل سؤالًا قصيرًا.
- في الجلسة، أدخل
/modelلتأكيد أن النموذج الحالي هوcustom/gpt-5.5أوgpt-5.5.
استخدام نموذج محدد مؤقتًا:
hermes chat --provider custom --model gpt-5.5
لأول تحقق، يُنصح بإغلاق المهام المتوازية والأدوات المعقدة، وإرسال نصوص قصيرة فقط. بعد التحقق من المصادقة وربط النموذج، قم تدريجيًا بفتح أدوات مثل terminal و web و file.
6. أخطاء شائعة
- 401 / invalid_api_key:
AI2SAVE_API_KEYغير موجود أو القيمة ناقصة. نفذhermes config get model.key_envلفحص المرجع. - 404 / model not found:
model.defaultليس معرف نموذج حقيقي متاح على وحدة التحكم. - فشل الاتصال: يجب أن يكون
base_urlهوhttps://ai2save.com/v1؛ لا تكتبه كـhttps://ai2save.com. - إعدادات غير مفعلة:
OPENAI_BASE_URLالقديم يؤثر فقط علىopenai-apiو Provider، ولن يتم تطبيقه تلقائيًا علىcustom؛ تحقق منconfig.yamlوmodel.base_url. - فشل تحليل YAML: تجنب وجود كتل
model:مكررة، اجمع كل الحقول في نفس الكتلة. - استثناء عند استدعاء الأدوات: تأكد أولاً من أن النموذج يدعم tool calling، واستخدم نصًا قصيرًا لإنشاء خط أساس قبل تفعيل مجموعة الأدوات.