راهنمای استفاده از GapGPT در Hermes Agent

در این راهنما، Hermes Agent را به API گپ‌جی‌پی‌تی وصل می‌کنیم تا مدل زبانی Hermes از مدل‌های موجود در GapGPT استفاده کند. ابزارهایی مثل ترمینال، فایل‌ها، وب، حافظه و مهارت‌ها همچنان روی سیستم یا سروری که Hermes روی آن اجرا می‌شود باقی می‌مانند.

این صفحه درباره‌ی اتصال Hermes به API گپ‌جی‌پی‌تی است. API Server خود Hermes که Hermes را به یک endpoint تبدیل می‌کند، مسیر معکوس و قابلیت جداگانه‌ای است.

۱. پیش‌نیازها

برای شروع به این موارد نیاز دارید:

کلید را فقط در محیط اجرای Hermes نگه دارید و آن را داخل فایل پروژه یا اسکرین‌شات قرار ندهید.

۲. نصب Hermes Agent

macOS، Linux و WSL2:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows PowerShell:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

بعد از نصب، یک ترمینال جدید باز کنید و نصب را بررسی کنید:

hermes version
hermes doctor

۳. اتصال سریع با ویزارد Hermes

روش پیشنهادی برای اولین اتصال، ویزارد رسمی Hermes است:

hermes model

در ویزارد:

  1. گزینه‌ی Custom endpoint را انتخاب کنید.

  2. آدرس پایه را وارد کنید:

    https://api.gapgpt.app/v1
    
  3. کلید API گپ‌جی‌پی‌تی را وارد کنید.

  4. یکی از مدل‌های فعال در صفحه قیمت‌گذاری را انتخاب کنید؛ برای نمونه gpt-5.6-sol.

  5. اگر Hermes درباره‌ی نوع API پرسید، Chat Completions را انتخاب کنید.

  6. اگر درباره‌ی طول context پرسید، مقدار متناسب با مدل انتخابی را وارد کنید یا آن را خالی بگذارید تا Hermes از endpoint مدل را تشخیص دهد.

سپس یک گفت‌وگوی آزمایشی اجرا کنید:

hermes chat -q "یک جمله درباره‌ی خودت بگو"

۴. تنظیم دستی و امن با config.yaml

اگر می‌خواهید نام provider ثابت باشد یا چند endpoint سفارشی داشته باشید، فایل ~/.hermes/config.yaml را ویرایش کنید:

custom_providers:
  - name: gapgpt
    base_url: https://api.gapgpt.app/v1
    key_env: GAPGPT_API_KEY
    api_mode: chat_completions

model:
  provider: custom:gapgpt
  default: gpt-5.6-sol

کلید را در ~/.hermes/.env قرار دهید:

GAPGPT_API_KEY=YOUR_GAPGPT_API_KEY

بعد از تغییر تنظیمات، مدل را برای اجرای بعدی انتخاب کنید:

hermes chat --model gpt-5.6-sol

برای استفاده از مدل دیگر، مقدار model.default یا گزینه‌ی --model را با شناسه‌ی دقیق همان مدل عوض کنید.

۵. بررسی اتصال به API

قبل از عیب‌یابی Hermes، می‌توانید دسترسی کلید و فهرست مدل‌ها را مستقیماً بررسی کنید:

curl https://api.gapgpt.app/v1/models \
  -H "Authorization: Bearer $GAPGPT_API_KEY"

اگر پاسخ JSON دریافت کردید، base URL و کلید قابل دسترسی هستند. سپس در Hermes این دستورها را اجرا کنید:

hermes config get model --json
hermes doctor

۶. استفاده از قابلیت‌های Agent

بعد از اتصال، Hermes می‌تواند براساس prompt شما از ابزارهای خودش استفاده کند؛ برای مثال:

این ابزارها محلی هستند و تنظیم endpoint مدل، به‌تنهایی دسترسی جدیدی به سیستم شما ایجاد نمی‌کند. قبل از فعال‌کردن ابزارهای ترمینال یا Gateway، policy و سطح دسترسی Hermes را بررسی کنید.

۷. نکات امنیتی و مدیریت هزینه

۸. عیب‌یابی سریع

خطای احراز هویت یا 401

مدل پیدا نمی‌شود

پاسخ می‌آید اما ابزارها اجرا نمی‌شوند

۹. منابع بیشتر