راهنمای استفاده از GapGPT در Hermes Agent
در این راهنما، Hermes Agent را به API گپجیپیتی وصل میکنیم تا مدل زبانی Hermes از مدلهای موجود در GapGPT استفاده کند. ابزارهایی مثل ترمینال، فایلها، وب، حافظه و مهارتها همچنان روی سیستم یا سروری که Hermes روی آن اجرا میشود باقی میمانند.
این صفحه دربارهی اتصال Hermes به API گپجیپیتی است. API Server خود Hermes که Hermes را به یک endpoint تبدیل میکند، مسیر معکوس و قابلیت جداگانهای است.
۱. پیشنیازها
برای شروع به این موارد نیاز دارید:
- یک سیستم macOS، Linux، WSL2 یا Windows
- یک کلید API از بخش کلیدهای API گپجیپیتی
- اعتبار کافی در کیف پول API
- شناسهی یک مدل فعال از صفحه مدلها و قیمتها
کلید را فقط در محیط اجرای 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
در ویزارد:
-
گزینهی Custom endpoint را انتخاب کنید.
-
آدرس پایه را وارد کنید:
https://api.gapgpt.app/v1 -
کلید API گپجیپیتی را وارد کنید.
-
یکی از مدلهای فعال در صفحه قیمتگذاری را انتخاب کنید؛ برای نمونه
gpt-5.6-sol. -
اگر Hermes دربارهی نوع API پرسید، Chat Completions را انتخاب کنید.
-
اگر دربارهی طول 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 شما از ابزارهای خودش استفاده کند؛ برای مثال:
- بررسی و ویرایش فایلهای یک پروژه
- اجرای تستها یا فرمانهای ترمینال
- جستوجوی وب و خلاصهسازی نتیجه
- استفاده از حافظه و مهارتهای نصبشده
- اتصال به کانالهایی مثل Telegram، Discord یا Slack از طریق Gateway
این ابزارها محلی هستند و تنظیم endpoint مدل، بهتنهایی دسترسی جدیدی به سیستم شما ایجاد نمیکند. قبل از فعالکردن ابزارهای ترمینال یا Gateway، policy و سطح دسترسی Hermes را بررسی کنید.
۷. نکات امنیتی و مدیریت هزینه
- کلید API را در
~/.hermes/.envیا Secret Manager نگه دارید، نه در repository. - دسترسی ترمینال را برای پروژههای ناشناس محدود کنید؛ Hermes برای اجرای ابزارها به مجوزهای سیستم شما تکیه میکند.
- هزینه و مصرف را از نمودار مصارف بررسی کنید.
- هر مدل قیمت و توانایی متفاوتی دارد؛ شناسهی مدل را از صفحه مدلها و قیمتها بردارید.
- برای کارهای پرتعداد، ابتدا با یک مدل اقتصادی و یک prompt کوتاه آزمایش کنید.
۸. عیبیابی سریع
خطای احراز هویت یا 401
- مقدار
GAPGPT_API_KEYرا بررسی کنید. - مطمئن شوید کلید بدون پیشوند اضافی در
.envقرار گرفته است. - بررسی کنید Hermes به
https://api.gapgpt.app/v1وصل میشود، نه به مسیر/chat/completions.
مدل پیدا نمیشود
- نام مدل باید دقیقاً مطابق صفحه قیمتگذاری باشد.
- اگر endpoint مدلها را تبلیغ نمیکند، مدل را دستی در ویزارد وارد کنید.
- در صورت تغییر provider،
hermes config get model --jsonو سپس یک ترمینال جدید را امتحان کنید.
پاسخ میآید اما ابزارها اجرا نمیشوند
- مدل انتخابی باید برای tool calling مناسب باشد.
- policy ابزارها و backend ترمینال Hermes را بررسی کنید.
- برای کارهای کدنویسی، یک مدل قویتر را امتحان کنید و ابتدا با یک پروژهی آزمایشی تست بگیرید.