الانتقال إلى المحتوى الرئيسي
استخدم CometAPI كمزوّد model لـ Hermes Agent من خلال دعم Hermes لنقطة نهاية مخصّصة متوافقة مع OpenAI.

​
المتطلبات الأساسية

  • Git
  • حساب CometAPI مع مفتاح API نشط
  • طرفية على macOS أو Linux أو WSL2

​
التثبيت

1

احصل على مفتاح API الخاص بـ CometAPI

سجّل الدخول إلى لوحة CometAPI. انقر على Add API Key وانسخ مفتاح <COMETAPI_KEY> الخاص بك.
لوحة تحكم CometAPI تعرض زر Add API Key
تفاصيل مفتاح API في CometAPI مع عرض base URL
2

ثبّت Hermes Agent

يشغّل الأمر التالي أداة التثبيت الرسمية:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
إذا لم يتعرّف shell الحالي على الأمر hermes بعد، فأعد تحميل إعدادات shell:
source ~/.zshrc
# or
source ~/.bashrc
يخزّن Hermes الإعدادات في ~/.hermes/، ويربط الأمر hermes في ~/.local/bin، وقد يضيف ~/.local/bin إلى PATH الخاصة بـ shell.

​
الإعداد

1

خزّن مفتاح CometAPI الخاص بك

افتح ~/.hermes/.env وأضف السطر التالي:
OPENAI_API_KEY=<COMETAPI_KEY>
يستخدم Hermes المتغيّر OPENAI_API_KEY كخيار مصادقة احتياطي لنقاط النهاية المخصّصة المتوافقة مع OpenAI.
2

أعد تكوين نقطة نهاية CometAPI

افتح ~/.hermes/config.yaml وتأكد من أن قسم model يبدو كالتالي:
model:
  provider: custom
  default: your-model-id
  base_url: https://api.cometapi.com/v1
استبدل your-model-id بـ model ID حالي لنموذج نصي من صفحة نماذج CometAPI.
احتفظ بمفتاح API في ~/.hermes/.env. لا تضع الأسرار مباشرة داخل config.yaml.
يضبط هذا الإعداد نموذج الدردشة الرئيسي. يمكن لـ Hermes استخدام نماذج مساعدة منفصلة لمهام مثل الرؤية أو استخراج الويب.

​
التحقق

1

تحقق من الإعداد

تؤكد الأوامر التالية أن Hermes يمكنه قراءة الإعداد ومفتاح API:
hermes config check
hermes doctor
hermes status
إذا أبلغ hermes config check عن خيارات مفقودة بعد تحديث، فشغّل hermes config migrate ثم تحقّق مرة أخرى.
2

شغّل اختبار دردشة حقيقي

يرسل الأمر التالي طلبًا حقيقيًا عبر CometAPI:
hermes chat -q "Reply with the single word CONNECTED."
يعيد الإعداد الناجح CONNECTED من دون أخطاء مصادقة أو أخطاء في نقطة النهاية.

​
إعداد اختياري

إذا كنت تستبدل تثبيت Hermes أقدم، فاستخدم أولًا أداة إلغاء التثبيت المدمجة:
hermes uninstall
في أداة إلغاء التثبيت، اختر Full uninstall لإزالة CLI وإدخال PATH وبيانات ~/.hermes/. ثم أعد تشغيل خطوة التثبيت وتابع باستخدام إعداد CometAPI نفسه.
إذا كنت تفضّل التدفق التفاعلي، فشغّل hermes model واختر Custom endpoint.ثم أدخل القيم التالية:
  • Base URL: https://api.cometapi.com/v1
  • API key: مفتاح API الخاص بـ CometAPI
  • Model: model ID حالي لنموذج نصي في CometAPI
يكتب هذا التدفق إعدادات provider نفسها داخل config.yaml.