استخدم Hermes Agent مع CometAPI

استخدم CometAPI كمزوّد model لـ Hermes Agent. يدعم Hermes مسارين عبر CometAPI في هذا الدليل: endpoint عام متوافق مع OpenAI لمعظم نماذج النصوص، ومسار Claude عبر Anthropic Messages.

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

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

التثبيت

احصل على CometAPI API key الخاص بك

سجّل الدخول إلى لوحة تحكم CometAPI. انقر على Add API Key وانسخ CometAPI API key الخاص بك.

ثبّت 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.

الإعداد

اختر مسار CometAPI الذي يطابق عائلة model:

عائلة model	إعداد Hermes	مسار CometAPI
نماذج النصوص المتوافقة مع OpenAI	`model.provider: custom` مع `base_url: https://api.cometapi.com/v1`	`/v1/chat/completions`
نماذج Claude	موفّر مسمّى مع `transport: anthropic_messages`	`/v1/messages`
نماذج Gemini في Hermes	استخدم الإعداد المتوافق مع OpenAI	`/v1/chat/completions`
استدعاءات Gemini API المباشرة	استخدم واجهة Gemini `generateContent` API خارج Hermes	`/v1beta` `generateContent`

لا تُعِد Hermes باستخدام https://api.cometapi.com/v1beta كموفّر Gemini أصلي مخصّص. استخدم إعداد Hermes المتوافق مع OpenAI لنماذج Gemini. أما لاستدعاءات Gemini API المباشرة، فاستخدم واجهة Gemini generateContent API.

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

افتح ~/.hermes/.env وأضف القيم التالية:

COMETAPI_KEY=<COMETAPI_KEY>
OPENAI_API_KEY=<COMETAPI_KEY>

يُستخدم COMETAPI_KEY بواسطة موفّر Claude المسمّى. ويحافظ OPENAI_API_KEY على عمل نقطة النهاية الاحتياطية المخصّصة والمتوافقة مع OpenAI في Hermes.

اضبط المسار المتوافق مع OpenAI

استخدم هذا المسار لمعظم نماذج النصوص في CometAPI، بما في ذلك نماذج Gemini المستخدمة من Hermes. افتح ~/.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 استخدام نماذج مساعدة منفصلة لمهام مثل الرؤية أو استخراج الويب.

اضبط مسار Claude Messages

استخدم هذا المسار عندما تريد أن يستدعي Hermes نماذج Claude عبر Anthropic Messages. افتح ~/.hermes/config.yaml واستخدم موفّرًا مسمّى:

model:
  provider: cometapi-claude
  default: your-claude-model-id

providers:
  cometapi-claude:
    base_url: https://api.cometapi.com
    key_env: COMETAPI_KEY
    transport: anthropic_messages
    default_model: your-claude-model-id

استبدل your-claude-model-id بـ model ID حالي لنموذج Claude من صفحة نماذج CometAPI.

أبقِ base_url على https://api.cometapi.com لهذا المسار. يستخدم Hermes نقل Anthropic Messages من الموفّر المسمّى.

التحقق

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

يؤكد الأمر التالي أن Hermes يمكنه قراءة الإعداد ومفتاح API:

hermes config check

إذا أبلغ hermes config check عن خيارات مفقودة بعد تحديث، فشغّل hermes config migrate ثم تحقق مرة أخرى.

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

يرسل الأمر التالي طلبًا حقيقيًا عبر CometAPI:

hermes chat -Q --ignore-rules --max-turns 1 -q "Reply with CONNECTED only."

يعيد الإعداد الناجح CONNECTED من دون أخطاء مصادقة أو أخطاء في نقطة النهاية. وعندما يكون إعداد Claude Messages نشطًا، فهذا يؤكد أن Hermes يمكنه استخدام النقل anthropic_messages عبر CometAPI.

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

إعادة تثبيت نظيفة (اختياري)

إذا كنت تستبدل تثبيت Hermes أقدم، فاستخدم أداة إلغاء التثبيت المدمجة أولًا:

hermes uninstall

في أداة إلغاء التثبيت، اختر Full uninstall لإزالة CLI وإدخال PATH وبيانات ~/.hermes/. ثم أعد تشغيل خطوة التثبيت وتابع باستخدام إعدادات CometAPI نفسها.

استخدم model الخاص بـ hermes بدلًا من ذلك (اختياري)

إذا كنت تفضّل التدفق التفاعلي لمسار OpenAI-compatible، شغّل hermes model واختر Custom endpoint.ثم أدخل القيم التالية:

Base URL: https://api.cometapi.com/v1
API key: مفتاح CometAPI API الخاص بك
Model: model ID حالي لنموذج نصي من CometAPI

يكتب هذا التدفق إعدادات المزوّد OpenAI-compatible داخل config.yaml. بالنسبة إلى Claude Messages، حرّر config.yaml مباشرةً بحيث يحتفظ المزوّد المُسمّى بالقيمة transport: anthropic_messages.

نظرة عامة

وكلاء البرمجة بالذكاء الاصطناعي

وكلاء الذكاء الاصطناعي

عملاء دردشة الذكاء الاصطناعي

الترجمة واللغة

منصات الأتمتة

المراقبة والتقييم

أطر عمل الذكاء الاصطناعي

استخدم Hermes Agent مع CometAPI

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

التثبيت

الإعداد

التحقق

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

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

​التثبيت

​الإعداد

​التحقق

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

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

التثبيت

الإعداد

التحقق

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