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
- Open Açıkçası)https://ai2save.com/keys.
- Bir anahtar oluşturun ve hedef modeli içeren grubu seçin.
- Tamamlananı kopyalayın
sk-...Anahtar anahtarı. - 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/completionsBuna 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
- Mevcut Hermes seansını veya Gateway'i tamamen bırakın.
- Restart Hermes.
- Yeni bir oturum açın ve kısa bir soru gönderin.
- Enter girin
/modelOturumda mevcut modelin şu anki modelin olduğunu doğrulamak içincustom/gpt-5.5veyagpt-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_KEYVar ya da değer eksik değildir. Executehermes config get model.key_envReferansı kontrol etmek için. - 404 / model bulunamadı:
model.defaultKonsolda gerçek bir model kimlik açık değil. - Bağlantı başarısız oldu:
base_urlOlmalıhttps://ai2save.com/v1; Bunu yazmayınhttps://ai2save.com. - Yapılama etkili değil: Eski yaşlı The old
OPENAI_BASE_URLSadece etkileropenai-apiSağlayıcı, otomatik olarak otomatik olarak geçerli olmayacakcustom; check kontrol kontrolüconfig.yamlFor içinmodel.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.