Panduan konfigurasi Hermes Agent
Model, vendor, dan titik akhir khusus untuk Hermes Agen disimpan di ~/.hermes/config.yaml; informasi sensitif seperti Kunci API tersimpan ~/.hermes/.env. ai2save menggunakan antar muka kompatibel OpenAI, dan URL Dasar adalah https://ai2save.com/v1.
1. Buat kunci API
- Buka https://ai2save.com/keys.
- Buat suatu kunci dan pilih grup yang memuat model target.
- Salin komplit
sk-...Kunci. - Rekam ID model nyata yang ditampilkan dalam konsol, misalnya,
gpt-5.5.
2. Gunakan panduan bawaan (disarankan)
Jalankan di terminal:
hermes model
Pilih menurut instruksi:
Custom endpoint (self-hosted / vLLM / etc.)
Masuk dalam rangka:
API base URL: https://ai2save.com/v1
API key: sk-your-api-key
Model name: gpt-5.5
Penyihir akan menulis nilai-nilai ini ke ~/.hermes/config.yaml. Jangan tulis URL Dasar ke .env; Hermes secara resmi menetapkan bahwa konfigurasi titik akhir model berasal dari config.yaml.
3. Edit file konfigurasi secara manual
Edit ~/.hermes/config.yaml:
model:
provider: custom
default: gpt-5.5
base_url: https://ai2save.com/v1
key_env: AI2SAVE_API_KEY
Deskripsi Ruas:
provider: custom: Gunakan titik akhir kompatibel OpenAI.default: ID model baku, harus cocok dengan ID model yang dibuka dalam konsol persis.base_url: Harus termasuk/v1, Hermes akan meminta/chat/completionsberdasarkan ini.key_env: Titik ke nama variabel lingkungan di mana kunci disimpan.
Edit ~/.hermes/.env:
AI2SAVE_API_KEY=sk-your-api-key
.env simpan informasi sensitif, config.yaml simpan konfigurasi model tidak-sensitif. Jangan commit .env ke Git.
4. Gunakan perintah konfigurasi untuk menulis pengaturan
Anda juga dapat menggunakan perintah yang disediakan oleh Hermes untuk menghindari galat indentasi YAML:
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 adalah sebuah nama variabel lingkungan uppercase, dan Hermes secara otomatis akan menulis ~/.hermes/.env.
5. Mulai ulang dan verifikasi
- Keluar dari sesi Hermes saat ini atau Gateway.
- Mulai Ulang Hermes.
- Memulai sesi baru dan mengirim pertanyaan singkat.
- Masuk
/modeldalam sesi untuk mengkonfirmasi bahwa model saat ini adalahcustom/gpt-5.5ataugpt-5.5.
Sementara menggunakan sebuah model yang dispesifikasikan:
hermes chat --provider custom --model gpt-5.5
Untuk verifikasi pertama, disarankan untuk menonaktifkan tugas paralel dan alat kompleks, dan hanya mengirim teks pendek. Setelah otentikasi dan model konektivitas didirikan, secara bertahap memungkinkan perangkat seperti terminal, web, dan file.
6. Kesalahan umum
- 401 / invalid _ api _ key:
AI2SAVE_API_KEYtidak ada atau nilai tidak lengkap. Jalankanhermes config get model.key_envuntuk memeriksa referensi. - 404 / model tidak ditemukan:
model.defaultbukan ID model nyata yang dibuka dalam konsol. - Koneksi gagal:
base_urlharushttps://ai2save.com/v1; jangan tulis itu sebagaihttps://ai2save.com. - Konfigurasi tidak efektif: The old
OPENAI_BASE_URLhanya berpengaruhopenai-apiPenyedia, ini tidak akan secara otomatis diterapkan kecustom; periksaconfig.yamluntukmodel.base_url. - Parsing YAML gagal: Tidak memiliki duplikat
model:blocks; merge seluruh field dalam blok yang sama. - Perkakas eksepsi panggilan: Pertama-tama pastikan model mendukung panggilan alat, dan gunakan permintaan teks pendek untuk membangun baseline sebelum mengaktifkan toolset.