Langsung ke konten utama

Hermes Agent

Hermes Agent adalah agen AI sumber terbuka yang berjalan di terminal, aplikasi desktop, dan platform perpesanan. Panduan ini mengonfigurasi pengaturan penyedia yang kompatibel dengan OpenAI agar permintaan dikirim melalui KiosAPI.

Prasyarat

Dapatkan Kunci API Anda

  1. Masuk ke Dashboard KiosAPI
  2. Buka Token Management
  3. Buat kunci API baru atau salin kunci yang ada

Konfigurasikan Hermes

Atur kunci Anda di lingkungan sebelum menjalankan Hermes:
Di Windows PowerShell:
Buat atau edit ~/.hermes/config.yaml, lalu konfigurasikan endpoint yang kompatibel dengan OpenAI:
Ganti sk-xxx dengan kunci KiosAPI Anda, kemudian buka sesi terminal baru setelah memakai setx di Windows.
Gunakan https://kiosapi.com/v1 untuk API yang kompatibel dengan OpenAI. Pilih model yang tersedia untuk grup token KiosAPI Anda; contoh ini menggunakan gpt-5.5.

Verifikasi Konfigurasi

Jalankan satu permintaan:
Atau mulai sesi interaktif:
Jika Hermes mengembalikan respons model, Hermes menggunakan endpoint KiosAPI yang dikonfigurasi.

Ganti Model

Perbarui model.default di ~/.hermes/config.yaml, lalu mulai ulang Hermes:
Periksa model yang tersedia sebelum memilih model.

Pemecahan Masalah

Kesalahan autentikasi

  • Pastikan KIOSAPI_KEY telah diatur dan diawali dengan sk-
  • Pastikan api_key: ${KIOSAPI_KEY} sesuai dengan nama variabel lingkungan
  • Buka sesi terminal baru setelah mengatur variabel lingkungan Windows dengan setx

Kesalahan koneksi atau model

  • Pastikan base_url persis https://kiosapi.com/v1
  • Pastikan model yang dipilih tersedia untuk grup token Anda
  • Jalankan hermes doctor untuk memeriksa konfigurasi dan dependensi Hermes

Butuh Bantuan?