Cara Konfigurasi Hermes Agent dan Model AI: Panduan Lengkap untuk Pemula

Setelah berhasil menginstal Hermes Agent, langkah berikutnya adalah menghubungkan agent dengan model AI yang sesuai. Konfigurasi ini menentukan model yang digunakan untuk memahami instruksi, menghasilkan respons, dan menjalankan alur kerja berbasis tools.

Dalam panduan ini, kita akan membahas cara konfigurasi Hermes Agent, memilih provider model AI, mengatur API key, menggunakan model lokal atau self-hosted, serta mengatasi masalah konfigurasi yang umum terjadi.

Panduan ini cocok untuk developer, IT administrator, AI enthusiast, dan pengguna yang ingin membangun lingkungan AI agent secara mandiri.

1. Memahami Provider dan Model AI

Sebelum melakukan konfigurasi, penting untuk memahami dua istilah berikut.

Provider AI adalah layanan atau endpoint yang menyediakan akses ke model AI. Contohnya mencakup Nous Portal, OpenRouter, Anthropic, dan endpoint model yang di-host sendiri.

Model AI adalah model yang memproses instruksi dan menghasilkan respons. Pemilihan model dapat memengaruhi kualitas penalaran, kecepatan respons, kemampuan menggunakan tools, batas konteks, dan biaya penggunaan.

Hermes Agent membutuhkan setidaknya satu provider yang berhasil dikonfigurasi agar dapat digunakan. Provider dan model yang tersedia bergantung pada metode autentikasi, dukungan integrasi, serta akses akun Anda.

2. Cara Konfigurasi Model AI pada Hermes Agent

Metode paling praktis untuk memilih provider dan model adalah melalui CLI interaktif.

Buka terminal dan jalankan:

hermes model

Selanjutnya, ikuti instruksi yang muncul untuk:

1. Memilih provider yang ingin digunakan.
2. Melakukan autentikasi atau memasukkan API key jika diperlukan.
3. Memilih model yang tersedia.
4. Menyimpan konfigurasi model.

Setelah konfigurasi berhasil, Hermes Agent menyimpan pengaturan model pada file konfigurasi pengguna, umumnya di ~/.hermes/config.yaml.

Perintah hermes model dijalankan dari terminal, bukan di dalam sesi percakapan aktif. Jika Anda sedang menggunakan Hermes Agent, keluar dari sesi terlebih dahulu sebelum menambahkan provider baru.

3. Menggunakan Nous Portal

Nous Portal merupakan salah satu opsi untuk mengakses model yang didukung Hermes Agent melalui mekanisme autentikasi Portal.

Untuk memulai setup pada instalasi baru, jalankan:

hermes setup --portal

Ikuti instruksi autentikasi dan pemilihan model yang ditampilkan. Jika diperlukan, selesaikan proses login melalui browser sesuai petunjuk yang diberikan.

Metode ini dapat menyederhanakan konfigurasi karena pengguna tidak perlu mengelola API key dari setiap provider secara terpisah untuk penggunaan yang tercakup oleh Portal.

Namun, ketersediaan model dan fitur bergantung pada paket, kebijakan, dan konfigurasi akun. Periksa ketentuan layanan sebelum menggunakannya untuk workload rutin atau bisnis.

Dokumentasi resmi: https://hermes-agent.nousresearch.com/docs/integrations/nous-portal

4. Menggunakan Provider Berbasis API Key

Jika Anda memilih provider yang menggunakan API key, pastikan akun Anda telah memiliki akses ke layanan dan model yang ingin digunakan.

Jalankan:

hermes model

Pilih provider yang tersedia, lalu ikuti proses autentikasi dan pemilihan model.

Setiap provider dapat memiliki ketentuan berbeda terkait:

1. Format API key dan autentikasi.
2. Model yang tersedia untuk akun Anda.
3. Harga input dan output token.
4. Batas penggunaan dan rate limit.
5. Dukungan tools atau kemampuan agentic.

Jangan menganggap satu API key berlaku untuk semua provider. Gunakan kredensial yang diterbitkan oleh layanan yang sesuai.

Untuk dokumentasi provider yang didukung, kunjungi:

https://hermes-agent.nousresearch.com/docs/integrations/providers

5. Cara Mengatur Model Default

Model default adalah model utama yang digunakan Hermes Agent untuk menangani percakapan dan alur pemanggilan tools.

Setelah provider dikonfigurasi, Anda dapat memilih model utama menggunakan:

hermes model

Ikuti menu pemilihan provider dan model. Pilihan yang disimpan akan digunakan untuk sesi baru sesuai perilaku konfigurasi Hermes Agent.

Untuk memeriksa konfigurasi model saat ini dalam format JSON, gunakan:

hermes config get model --json

Anda juga dapat memeriksa status konfigurasi melalui:

hermes status

Hindari membagikan output konfigurasi secara utuh apabila berisi informasi sensitif atau detail infrastruktur internal.

6. Mengganti Model Saat Percakapan Berlangsung

Hermes Agent membedakan pengaturan model default melalui CLI dan pergantian model di dalam sesi percakapan.

Untuk mengganti model yang sudah dikonfigurasi saat sedang chatting, gunakan perintah slash:

/model

Ikuti opsi yang tersedia pada sesi Anda.

Jika ingin menambahkan provider baru, gunakan hermes model dari terminal. Perintah /model di dalam sesi hanya digunakan untuk beralih di antara provider dan model yang telah dikonfigurasi.

Perubahan model default juga tidak selalu mengubah sesi yang sudah berjalan. Untuk menguji konfigurasi baru, mulai sesi baru atau gunakan mekanisme pergantian model yang didukung.

7. Menggunakan Model Lokal atau Self-Hosted

Selain menggunakan layanan cloud, Hermes Agent dapat dikonfigurasi untuk menggunakan endpoint model yang kompatibel dengan OpenAI API.

Pendekatan ini dapat berguna jika Anda menjalankan model melalui server inference sendiri, misalnya menggunakan Ollama atau vLLM, selama endpoint dan kemampuan yang dibutuhkan kompatibel.

Jalankan:

hermes model

Pilih opsi custom endpoint atau self-hosted yang tersedia. Masukkan informasi endpoint, nama model, serta kredensial yang sesuai.

Contoh konfigurasi konseptual pada ~/.hermes/config.yaml:

model: default: your-model-name provider: custom base_url: http://localhost:8000/v1 api_key: your-key

Ganti your-model-name, URL, dan nilai kredensial dengan konfigurasi server Anda. Jika endpoint lokal tidak memerlukan API key, ikuti petunjuk provider dan versi Hermes Agent yang digunakan.

Alamat localhost hanya tepat jika endpoint model dapat diakses dari lingkungan yang menjalankan Hermes Agent. Jika model berjalan pada server lain, gunakan alamat jaringan yang sesuai dan lindungi koneksinya.

Jangan menyalin contoh ini secara mentah ke server produksi tanpa memverifikasi nama model, endpoint, autentikasi, dan format konfigurasi yang didukung.

8. Memahami Auxiliary Models

Hermes Agent tidak hanya memiliki model utama. Sistem ini juga mendukung auxiliary models, yaitu model tambahan yang dapat digunakan untuk tugas tertentu.

Contoh tugas yang dapat memiliki konfigurasi tersendiri meliputi:

1. Analisis gambar atau vision.
2. Ringkasan halaman web.
3. Kompresi konteks percakapan.
4. Pembuatan judul sesi.
5. Tugas pendukung lainnya yang tersedia pada konfigurasi Anda.

Untuk mengaturnya, jalankan:

hermes model

Pilih opsi Configure auxiliary models jika tersedia. Kemudian pilih tugas, provider, dan model yang sesuai.

Tidak semua pengguna perlu mengatur auxiliary models sejak awal. Sebaiknya pastikan percakapan dasar berjalan normal terlebih dahulu sebelum menambahkan konfigurasi lanjutan.

Dokumentasi: https://hermes-agent.nousresearch.com/docs/user-guide/configuring-models

9. Cara Menjaga API Key dan Konfigurasi Tetap Aman

API key dan token autentikasi harus diperlakukan sebagai kredensial rahasia.

Terapkan beberapa praktik berikut:

Simpan kredensial dengan aman. Gunakan mekanisme autentikasi atau penyimpanan kredensial yang didukung Hermes Agent dan provider Anda.

Hindari hardcoding secret. Jangan memasukkan API key ke repositori Git, kode aplikasi, artikel publik, atau screenshot tutorial.

Batasi hak akses file. Periksa permission file konfigurasi dan penyimpanan kredensial, terutama pada server yang digunakan bersama.

Gunakan kredensial dengan cakupan yang sesuai. Jika provider menyediakan pengaturan pembatasan penggunaan atau kuota, pertimbangkan untuk mengaktifkannya.

Perhatikan biaya penggunaan. Model yang berbeda dapat memiliki harga dan batas pemakaian yang berbeda. Pantau penggunaan secara berkala.

Jika kredensial terlanjur terekspos, cabut atau rotasi kredensial tersebut melalui provider terkait dan periksa kemungkinan penggunaan yang tidak sah.

10. Troubleshooting Konfigurasi Hermes Agent

Provider tidak muncul dalam daftar model

Periksa apakah autentikasi telah berhasil dan provider sudah dikonfigurasi. Jalankan hermes model untuk menambahkan atau memperbaiki pengaturan provider.

API key ditolak

Pastikan API key berasal dari provider yang benar, masih aktif, dan memiliki akses yang diperlukan. Periksa juga apakah format autentikasi sesuai dokumentasi provider.

Model tidak ditemukan

Verifikasi ID model dan akses akun. Tidak semua model yang tersedia di situs provider otomatis tersedia melalui setiap integrasi Hermes Agent.

Endpoint self-hosted tidak merespons

Periksa apakah server inference aktif, endpoint benar, port dapat diakses, dan model telah dimuat. Pastikan konfigurasi base_url mengarah ke endpoint API yang sesuai.

Konfigurasi sudah berubah tetapi sesi tetap menggunakan model lama

Perubahan model default umumnya berlaku pada sesi baru. Mulai sesi baru atau gunakan /model untuk pergantian model pada sesi yang sedang berjalan jika didukung.

Agent dapat menjawab tetapi gagal menjalankan tools

Keberhasilan percakapan teks belum tentu membuktikan semua tools berjalan normal. Periksa kemampuan model, konfigurasi tools, akses provider, dan pengaturan tambahan yang dibutuhkan.

11. Checklist Sebelum Menggunakan Hermes Agent

1. Provider berhasil dikonfigurasi.
2. Model utama sudah dipilih.
3. Percakapan sederhana berhasil.
4. API key atau autentikasi berfungsi.
5. Endpoint dan nama model sudah diverifikasi.
6. Biaya serta batas penggunaan sudah dipahami.
7. Kredensial tersimpan dengan aman.
8. Auxiliary models hanya diaktifkan jika dibutuhkan.

Kesimpulan

Konfigurasi Hermes Agent dimulai dengan memilih provider, menyelesaikan autentikasi, dan menentukan model utama. Setelah percakapan dasar berhasil, Anda dapat mengeksplorasi endpoint self-hosted, auxiliary models, dan integrasi tambahan.

Untuk menjaga proses tetap sederhana dan mudah ditelusuri, lakukan konfigurasi secara bertahap. Uji satu provider dan satu model terlebih dahulu sebelum menambahkan banyak integrasi.

Artikel terkait:

1. Cara Install Hermes Agent di Ubuntu
2. Cara Menjalankan Hermes Agent di VPS Linux
3. Tips Keamanan Hermes Agent untuk Server Produksi
4. Cara Menghubungkan Hermes Agent dengan Platform Pesan

Panduan ini bersifat edukatif. Nama menu, dukungan provider, dan metode konfigurasi dapat berubah mengikuti versi Hermes Agent. Gunakan dokumentasi resmi sebagai acuan teknis terbaru.