آشا آشا AI Gateway
ورود شروع رایگان

Hermes Agent

عامل خودمختار و ترمینال‌محورِ Nous Research را به درگاه آشا وصل کنید؛ با حافظهٔ پایدار، مهارت‌های ساخته‌شده توسط عامل و دسترسی چندمدلی با یک کلید API واحد.

Hermes Agent یک عامل کدنویسی و اجرای وظیفهٔ متن‌باز و ترمینال‌محور است که توسط Nous Research ساخته شده. حافظهٔ پایدار، مهارت‌های ساخته‌شده توسط خود عامل، و یک درگاه پیام‌رسانی دارد که از ۲۱+ پلتفرم از جمله Telegram، Discord، Slack، WhatsApp، Signal، SMS و Matrix پشتیبانی می‌کند.

Hermes روی بک‌اندهای محلی، Docker، SSH، Daytona، Modal، Vercel Sandbox یا Singularity اجرا می‌شود و با چند ارائه‌دهندهٔ LLM کار می‌کند — از جمله آشا برای دسترسی چندمدلی با یک کلید API واحد.

چرا باید Hermes را به آشا وصل کنیم؟

دسترسی چندمدلی با یک کلید

به‌جای اتصال به چند ارائه‌دهندهٔ جداگانه، همهٔ مدل‌های آشا را با یک کلید API واحد و یک پیکربندی ساده در اختیار عامل خود بگذارید.

جابه‌جایی خودکار پروایدر برای دسترس‌پذیری بالا

اگر ارائه‌ای در دسترس نباشد یا محدودیت نرخ داشته باشد، آشا درخواست را به پروایدر دیگری هدایت می‌کند و عامل بدون وقفه به کارش ادامه می‌دهد.

کنترل بودجه و مصرف

هزینهٔ تمام نشست‌های Hermes از کیف پول آشا کسر و در داشبورد فعالیت لحظه‌ای نمایش داده می‌شود؛ ببینید هر نشست یا هر کار از کدام مدل بیشترین مصرف را دارد.

تنظیم

پیشنهادی: استفاده از انتخاب‌گر تعاملی مدل

ساده‌ترین راه تنظیم Hermes با آشا:

Bash Terminal 
hermes model

از فهرست پروایدرها، Asha را انتخاب کنید، کلید API خود را وارد کنید و مدل موردنظرتان را برگزینید. این روش برای کاربران تازه‌کار پیشنهاد می‌شود.

شروع سریع (متغیر محیطی)

اگر از قبل کلید API آشا را دارید:

Bash Terminal 
hermes config set ASHA_API_KEY sk-asha-...

سپس یک گفتگو شروع کنید:

Bash Terminal 
hermes chat --provider asha --model '~anthropic/claude-sonnet-latest'

پیکربندی دستی

!

فقط کاربران پیشرفته: پیکربندی دستی زیر برای کاربرانی است که می‌خواهند فایل‌های تنظیمات را مستقیم ویرایش کنند. برای بیشتر کاربران، استفاده از hermes model در بالا را پیشنهاد می‌کنیم.

گام ۱ — دریافت کلید API آشا

  1. در داشبورد آشا ثبت‌نام یا وارد شوید.
  2. به صفحهٔ کلیدهای API بروید.
  3. یک کلید API جدید بسازید.
  4. کلید را کپی کنید (با sk-asha-... شروع می‌شود).

گام ۲ — تنظیم کلید API

کلید API آشا را به ~/.hermes/.env اضافه کنید:

Env ~/.hermes/.env 
ASHA_API_KEY=sk-asha-...
ن

Hermes اسرار را از تنظیمات غیرحساس جدا می‌کند. کلیدهای API در ~/.hermes/.env قرار می‌گیرند و پیکربندی مدل و پروایدر در ~/.hermes/config.yaml.

گام ۳ — پیکربندی مدل

~/.hermes/config.yaml را ویرایش کنید:

YAML ~/.hermes/config.yaml 
model:
  provider: asha
  default: ~anthropic/claude-sonnet-latest

همهٔ مدل‌های در دسترس را در فهرست مدل‌های آشا ببینید.

گام ۴ — شروع Hermes

Bash Terminal 
hermes          # CLI کلاسیک
hermes --tui    # رابط مدرن TUI

عامل شما حالا همهٔ درخواست‌ها را از طریق آشا به مدل انتخابی شما مسیردهی می‌کند.

قالب مدل

وقتی آشا را به‌عنوان پروایدر استفاده می‌کنید، Hermes از قالب استاندارد مدل <author>/<slug> استفاده می‌کند (با پیشوند اختیاری ~ برای آخرین نسخهٔ هر خانواده):

  • ~anthropic/claude-sonnet-latest
  • ~openai/gpt-latest
  • ~anthropic/claude-opus-latest
  • openai/gpt-4o

شناسهٔ دقیق هر مدل را در فهرست مدل‌های آشا پیدا می‌کنید.

مسیریابی پروایدر

آشا درخواست‌های شما را برای هر مدل روی چند زیرساخت پروایدر توزیع می‌کند. می‌توانید این رفتار را در ~/.hermes/config.yaml کنترل کنید:

YAML ~/.hermes/config.yaml 
provider_routing:
  sort: "throughput"          # "price" (پیش‌فرض)، "throughput" یا "latency"
  # only: ["anthropic"]      # فقط همین پروایدرها استفاده شوند
  # ignore: ["someprovider"] # این پروایدرها کنار گذاشته شوند
  # order: ["anthropic", "openai"]  # پروایدرها به این ترتیب امتحان شوند
  # data_collection: "deny"  # پروایدرهای نگه‌دارنده/آموزش‌دهنده روی داده حذف شوند

برای شرح کامل گزینه‌های مسیریابی، راهنمای انتخاب پروایدر را ببینید.

پروایدرهای جایگزین (Fallback)

زنجیره‌ای از پروایدرهای پشتیبان تنظیم کنید که وقتی مدل اصلی ناموفق است Hermes آن‌ها را امتحان کند:

YAML ~/.hermes/config.yaml 
fallback_providers:
  - provider: asha
    model: ~anthropic/claude-sonnet-latest
  - provider: asha
    model: ~openai/gpt-latest

این یک لایهٔ اطمینان اضافه می‌کند. هنگام فعال‌شدن، fallback مدل را وسط نشست بدون از‌دست‌دادن گفتگو جابه‌جا می‌کند.

مدل‌های کمکی (Auxiliary)

Hermes برای کارهای جانبی مثل فشرده‌سازی متن، تحلیل تصویر، عنوان نشست و خلاصه‌سازی وب از «مدل‌های کمکی» استفاده می‌کند. به‌صورت پیش‌فرض این‌ها از مدل اصلی شما استفاده می‌کنند، اما می‌توانید از طریق آشا آن‌ها را به مدل‌های ارزان‌تر مسیردهی کنید:

YAML ~/.hermes/config.yaml 
auxiliary:
  title:
    provider: asha
    model: openai/gpt-4o
  vision:
    provider: asha
    model: openai/gpt-4o
  compression:
    provider: asha
    model: openai/gpt-4o

این‌طور مدل اصلی روی کارهای استدلال پیچیده متمرکز می‌ماند و مدل‌های سبک‌تر کارهای ساده را انجام می‌دهند.

پایش مصرف

مصرف Hermes را لحظه‌ای دنبال کنید:

  1. داشبورد فعالیت آشا را باز کنید.
  2. درخواست‌ها، هزینه‌ها و مصرف توکن همهٔ نشست‌های Hermes را ببینید.
  3. بر اساس مدل، بازهٔ زمانی یا معیارهای دیگر فیلتر کنید.

خطاهای رایج

«No API key» یا پروایدر پیدا نشد

Hermes نمی‌تواند کلید API آشا را پیدا کند. رفع اشکال:

  1. وجود کلید را بررسی کنید: cat ~/.hermes/.env | grep ASHA
  2. یا دوباره تنظیم کنید: hermes config set ASHA_API_KEY sk-asha-...
  3. یا از راه‌اندازی تعاملی استفاده کنید: hermes model

خطاهای احراز هویت (401/403)

  1. معتبر بودن کلید API را در صفحهٔ کلیدهای API داشبورد آشا بررسی کنید.
  2. مطمئن شوید در کیف پول حساب‌تان اعتبار کافی دارید.
  3. مطمئن شوید کلید منقضی یا لغو نشده است.

مدل کار نمی‌کند

  1. شناسهٔ مدل را در فهرست مدل‌های آشا بررسی کنید.
  2. از قالب <author>/<slug> استفاده کنید، با پیشوند اختیاری ~ برای آخرین نسخهٔ خانواده (مثل ~anthropic/claude-sonnet-latest).
  3. مطمئن شوید مدل در دسترس است و منسوخ نشده.

خطاهای طول Context

Hermes به مدلی با حداقل ۶۴ هزار توکن context نیاز دارد. مدل‌های با پنجرهٔ کوچک‌تر هنگام شروع رد می‌شوند، چون پرامپت سیستم و شِمای ابزارها می‌توانند پنجره‌های کوچک را پر کنند و جایی برای گفتگو نماند. اگر خطای مرتبط با context دیدید، به مدلی با پنجرهٔ بزرگ‌تر بروید.

منابع