ai2saveai2save

دليل إعداد Hermes Agent

يتم حفظ نموذج Hermes Agent والمورد ونقطة النهاية المخصصة في ~/.hermes/config.yaml؛ وتُحفظ المعلومات الحساسة مثل API Key في ~/.hermes/.env. يستخدم ai2save واجهة OpenAI Compatible، و Base URL هو https://ai2save.com/v1.

1. إنشاء API Key

  1. افتح https://ai2save.com/keys.
  2. أنشئ مفتاحًا واختر المجموعة التي تحتوي على النموذج المستهدف.
  3. انسخ مفتاح sk-... بالكامل.
  4. سجّل معرف النموذج الحقيقي المعروض في وحدة التحكم، على سبيل المثال 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. إعادة التشغيل والتحقق

  1. قم بالخروج تمامًا من جلسة Hermes الحالية أو Gateway.
  2. أعد تشغيل Hermes.
  3. أنشئ جلسة جديدة وأرسل سؤالًا قصيرًا.
  4. في الجلسة، أدخل /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، واستخدم نصًا قصيرًا لإنشاء خط أساس قبل تفعيل مجموعة الأدوات.