استخدام Muapi مع Hermes Agent

أعدّ Muapi كنقطة نهاية مخصصة متوافقة مع OpenAI لاستخدام نماذجها النصية في Hermes Agent.

1. أنشئ مفتاحًا واختر نموذجًا

أنشئ مفتاح API من لوحة تحكم Muapi واعرض النماذج النصية:

curl -s "https://api.muapi.ai/v1/models?type=text" \
  -H "Authorization: Bearer $MUAPI_API_KEY"

اختر نموذجًا مع capabilities.tools: true. تتطلب مهام Hermes نافذة سياق لا تقل عن 64,000 رمز؛ تحقق من حد النموذج قبل اختياره.

2. إعداد Hermes Agent

شغّل معالج إعداد النموذج:

hermes model

اختر Custom endpoint وأدخل عنوان API الأساسي https://api.muapi.ai/v1، ومفتاح Muapi، ومعرّف النموذج الدقيق.

أو اضبط ~/.hermes/config.yaml:

model:
  default: YOUR_MODEL_ID
  provider: custom
  base_url: https://api.muapi.ai/v1
  key_env: MUAPI_API_KEY

احفظ المفتاح في ~/.hermes/.env:

MUAPI_API_KEY=your-muapi-api-key

استبدل YOUR_MODEL_ID بالمعرّف الدقيق من قائمة Muapi.

3. تشغيل Hermes Agent

hermes
# أو:
hermes --tui

اختبر مهمة صغيرة تستخدم أداة. بعد نجاح النموذج، اربط منصات المراسلة باستخدام hermes gateway setup.

استكشاف الأخطاء وإصلاحها

  • تحقق من أن العنوان ينتهي بـ /v1 وأن المفتاح متاح ومعرّف النموذج صحيح.
  • لاستخدام الأدوات، اختر نموذجًا يدعم capabilities.tools: true.
  • يتطلب Hermes سياقًا لا يقل عن 64K رمزًا.
  • ابدأ بمهمة صغيرة وتحقق من الاستخدام في لوحة Muapi.

راجع توثيق مزوّدي Hermes Agent ودليل الإعداد.