Tutorial 7: File Konfigurasi

Tutorial 7: File Konfigurasi

Selamat datang kembali, para pengatur agen! Dalam tutorial ini, kita akan menyelami jantung dari Hermes: file konfigurasi. Jika kamu pernah merasa tersesat di lautan YAML dan variabel lingkungan, jangan khawatir—kita akan membuatnya semudah mungkin.

Markas Besar Hermes

Semuanya tersimpan di ~/.hermes/. Anggap saja sebagai apartemen untuk agenmu. Berikut isinya:

~/.hermes/
├── config.yaml     # Pengaturan (model, terminal, TTS, kompresi, dll.)
├── .env            # Kunci API dan rahasia
├── auth.json       # Kredensial penyedia OAuth (Nous Portal, dll.)
├── SOUL.md         # Identitas agen utama (slot #1 di prompt sistem)
├── memories/       # Memori persisten (MEMORY.md, USER.md)
├── skills/         # Keterampilan yang dibuat agen (dikelola via alat skill_manage)
├── cron/           # Tugas terjadwal
├── sessions/       # Sesi gateway
└── logs/           # Log (errors.log, gateway.log — rahasia otomatis disunting)

Jalur Termudah: Setup Satu Perintah

Sebelum kita masuk ke detail, ini tips pro: jalankan hermes setup --portal. Satu OAuth memberimu penyedia model dan semua empat alat Tool Gateway tanpa menyentuh satu pun file YAML. Pelanggan Portal juga mendapat diskon 10% untuk penyedia yang ditagih per token. Ini cara paling santai untuk memulai, dan kami menyukainya.

Mengelola Konfigurasi-mu

Hermes memberimu perangkat lengkap untuk mengelola pengaturan. Berikut perintah yang akan kamu gunakan sehari-hari:

hermes config              # Lihat konfigurasi saat ini
hermes config edit         # Buka config.yaml di editor-mu
hermes config get KEY      # Cetak nilai yang telah diselesaikan
hermes config set KEY VAL  # Atur nilai tertentu
hermes config unset KEY    # Hapus nilai yang diatur pengguna
hermes config check        # Periksa opsi yang hilang (setelah pembaruan)
hermes config migrate      # Tambahkan opsi yang hilang secara interaktif

Berikut beberapa contoh praktis:

hermes config get model
hermes config set model anthropic/claude-opus-4
hermes config set terminal.backend docker
hermes config unset terminal.backend
hermes config set OPENROUTER_API_KEY sk-or-...  # Disimpan ke .env

Trik ajaib: hermes config set secara otomatis mengarahkan nilai ke file yang tepat. Kunci API masuk ke .env, sisanya masuk ke config.yaml. Tidak perlu menebak lagi!

Apa yang Menang Saat Terjadi Konflik?

Hermes menyelesaikan pengaturan dalam urutan berikut (prioritas tertinggi pertama):

1. Argumen CLI — seperti hermes chat --model anthropic/claude-sonnet-4
2. ~/.hermes/config.yaml — file konfigurasi utama-mu
3. ~/.hermes/.env — untuk rahasia (kunci API, token, kata sandi)
4. Default bawaan — nilai hardcoded yang aman

Aturan praktis: Rahasia masuk ke .env. Sisanya masuk ke config.yaml. Jika keduanya diatur, config.yaml menang untuk pengaturan non-rahasia.

Substitusi Variabel Lingkungan

Kamu bisa mereferensikan variabel lingkungan di config.yaml menggunakan sintaks ${NAMA_VARIABEL}:

auxiliary:
  vision:
    api_key: ${GOOGLE_API_KEY}
    base_url: ${CUSTOM_VISION_URL}

delegation:
  api_key: ${DELEGATION_KEY}

Referensi ganda juga berfungsi: url: "${HOST}:${PORT}". Jika variabel tidak diatur, placeholder tetap seperti apa adanya dan peringatan dicatat. Sintaks gaya-kursor ${env:NAMA_VARIABEL} juga berfungsi, jadi kamu bisa menyalin potongan dari konfigurasi Cursor atau Claude tanpa perubahan.

Timeout Penyedia

Kamu bisa mengatur timeout per penyedia dan per model:

providers:
  some-provider:
    request_timeout_seconds: 600
    models:
      some-model:
        timeout_seconds: 300

Ada juga stale_timeout_seconds untuk mendeteksi panggilan non-streaming yang basi. Pengaturan ini menggantikan variabel env lama HERMES_API_TIMEOUT dan HERMES_API_CALL_STALE_TIMEOUT.

Batas Runtime

Untuk permukaan server yang berjalan lama (gateway, hermes serve --isolated), kamu bisa mengatur batas deskriptor file:

runtime:
  nofile_soft_limit: 4096

Defaultnya adalah 4096. Atur ke 0, false, atau null untuk menonaktifkan penyesuaian.

Perilaku Pembaruan

Pengaturan pembaruan berada di bawah updates di config.yaml:

updates:
  pre_update_backup: quick

Penutup

Itulah tur konfigurasi! Ingat: hermes setup --portal untuk jalur mudah, hermes config set untuk perubahan cepat, dan simpan rahasia di .env. Agenmu akan berterima kasih.

Selanjutnya: kita akan menjelajahi penyedia AI dan cara menghubungkan model favoritmu. Nantikan terus!