ai2saveai2save

Hermes Agent yapılandırma kılavuzu

Modeller, satıcılar ve Hermes Agent için özel uç noktaları depolanır ~/.hermes/config.yaml; API Key gibi hassas bilgiler depolanır ~/.hermes/.env. ai2save OpenAI Uyumlu arayüzü kullanıyor ve Base URL'si https://ai2save.com/v1.

1. API anahtarı oluşturun

  1. Open Açıkçası)https://ai2save.com/keys.
  2. Bir anahtar oluşturun ve hedef modeli içeren grubu seçin.
  3. Tamamlananı kopyalayın sk-... Anahtar anahtarı.
  4. Konsolda görüntülenen gerçek model kimliğini kayıt edin, örneğin, gpt-5.5.

2. Yerleşik sihirbazı kullanın (önerilen)

Terminalde Run in the terminal:

hermes model

Talimatlara göre seçin:

Custom endpoint (self-hosted / vLLM / etc.)

siparişe girin:

API base URL: https://ai2save.com/v1
API key: sk-your-api-key
Model name: gpt-5.5

Sihirbaz bu değerleri bu değerlere yazacaktır ~/.hermes/config.yaml. Base URL'yi yazmayın .env; Hermes, model uç noktası konfigürasyonunun nereden geldiğini resmi olarak düzenler config.yaml.

3. Yapılandırma dosyasını elle düzenleyin

Düzenle ~/.hermes/config.yaml:

model:
  provider: custom
  default: gpt-5.5
  base_url: https://ai2save.com/v1
  key_env: AI2SAVE_API_KEY

Field Description:

  • provider: custom: Herhangi bir OpenAI Uyumlu uç noktası kullanın.
  • default: Varsayılan model ID, konsolda açılan modeli tam olarak eşleştirmeli.
  • base_url: dahil olmak zorunlu olmalıdır /v1, Hermes talep edecek /chat/completions Buna dayanarak,.
  • key_env: Anahtarın depolandığı çevreye değişken adı için puanlar.

Düzenle ~/.hermes/.env:

AI2SAVE_API_KEY=sk-your-api-key

.env hassas bilgi kaynakları, config.yaml Hassas olmayan model yapılandırmasını mağazalardan depolayın .env Gitin.

4. Ayarları yapılandırma komutlarıyla yazın

Ayrıca, YAML indentation hatalarından kaçınmak için Hermes tarafından sağlanan komutları da kullanabilirsiniz:

hermes config set model.provider custom
hermes config set model.default gpt-5.5
hermes config set model.base_url https://ai2save.com/v1
hermes config set model.key_env AI2SAVE_API_KEY
hermes config set AI2SAVE_API_KEY sk-your-api-key
hermes config check

AI2SAVE_API_KEY Üst bir ortam değişkeni adı ve Hermes otomatik olarak yazacaktır ~/.hermes/.env.

5. Yeniden başlatın ve doğrulayın

  1. Mevcut Hermes seansını veya Gateway'i tamamen bırakın.
  2. Restart Hermes.
  3. Yeni bir oturum açın ve kısa bir soru gönderin.
  4. Enter girin /model Oturumda mevcut modelin şu anki modelin olduğunu doğrulamak için custom/gpt-5.5 veya gpt-5.5.

Temporly belirli bir model kullanır:

hermes chat --provider custom --model gpt-5.5

İlk doğrulama için, paralel görevleri ve karmaşık araçları devre dışı bırakmak tavsiye edilir ve sadece kısa metin gönderir. Kimlik doğrulaması ve model bağlantı kurulurktan sonra, terminal, web ve dosya gibi araçlar yavaş şekilde etkinleştirilir.

6. Yaygın hatalar

  • 401 / geçersiz_api_key: AI2SAVE_API_KEY Var ya da değer eksik değildir. Execute hermes config get model.key_env Referansı kontrol etmek için.
  • 404 / model bulunamadı: model.default Konsolda gerçek bir model kimlik açık değil.
  • Bağlantı başarısız oldu: base_url Olmalı https://ai2save.com/v1; Bunu yazmayın https://ai2save.com.
  • Yapılama etkili değil: Eski yaşlı The old OPENAI_BASE_URL Sadece etkiler openai-api Sağlayıcı, otomatik olarak otomatik olarak geçerli olmayacak custom; check kontrol kontrolü config.yaml For için model.base_url.
  • YAML parsing başarısız oldu: Yeniden kopyalanmayın model: Bloklar; aynı bloktaki tüm alanları birleştirin.
  • Tool call istisnai: İlk olarak, model arama aracı destekler ve alete izin vermeden önce bir temel oluşturmak için kısa bir metin isteği kullanın.