ai2saveai2save

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

  1. Buka https://ai2save.com/keys.
  2. Buat suatu kunci dan pilih grup yang memuat model target.
  3. Salin komplit sk-... Kunci.
  4. 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/completions berdasarkan 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

  1. Keluar dari sesi Hermes saat ini atau Gateway.
  2. Mulai Ulang Hermes.
  3. Memulai sesi baru dan mengirim pertanyaan singkat.
  4. Masuk /model dalam sesi untuk mengkonfirmasi bahwa model saat ini adalah custom/gpt-5.5 atau gpt-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_KEY tidak ada atau nilai tidak lengkap. Jalankan hermes config get model.key_env untuk memeriksa referensi.
  • 404 / model tidak ditemukan: model.default bukan ID model nyata yang dibuka dalam konsol.
  • Koneksi gagal: base_url harus https://ai2save.com/v1; jangan tulis itu sebagai https://ai2save.com.
  • Konfigurasi tidak efektif: The old OPENAI_BASE_URL hanya berpengaruh openai-api Penyedia, ini tidak akan secara otomatis diterapkan ke custom; periksa config.yaml untuk model.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.