Agen yang di-self-host dan berhenti merespons pasti gagal di salah satu dari lima tempat: instance tidak berjalan, kunci penyedia tidak valid atau saldonya habis, kamu terkena batas permintaan penyedia, model yang kamu pilih tidak mendukung tool calling sehingga agen hanya bisa bicara tetapi tidak pernah bertindak, atau jalur ke dashboard-mu mati padahal agennya sendiri baik-baik saja. Masing-masing punya tanda yang berbeda. Cek dulu apakah dashboard merespons, karena tes tunggal itu memberitahumu bagian daftar mana yang harus kamu periksa.
Satu tes yang memangkas separuh masalah
Buka dashboard Hermes dan tanyakan sesuatu yang sepele yang tidak membutuhkan alat kepada agen. Apa yang terjadi selanjutnya membagi lima penyebab menjadi dua kelompok, dan menghemat waktumu dari men-debug bagian yang salah.
- Kamu mendapat jawaban. Instance sedang berjalan dan penyedia model menerima permintaan. Masalahnya ada di pemanggilan tool atau sesuatu dalam tugas spesifik, bukan di setup.
- Kamu mendapat error. Penyedia menolakmu: kunci tidak valid, saldo habis, batas laju, atau nama model yang sudah dipensiunkan.
- Tidak ada yang terjadi sama sekali, atau halamannya tidak bisa dimuat. Bisa jadi instance-nya mati atau jalurmu ke sana yang bermasalah. Keduanya adalah kesalahan yang berbeda dengan perbaikan yang berbeda, dibahas di bawah.
Apakah instance benar-benar berjalan?
Cek instance di dashboard Flux kamu, jangan menilai dari antarmuka agen, karena container yang terjebak dalam loop restart terlihat seperti masih hidup secara terputus-putus. Penyebab yang umum adalah memori dan tugas berjalan lama yang tidak pernah selesai.
Memori adalah yang paling layak dicek pertama jika pemakaianmu sudah melampaui penggunaan ringan. Tier 4 GB nyaman untuk agen pribadi yang menjalankan tugas terjadwal dan ad-hoc, tetapi yang menghabiskan RAM adalah konkurensi: beberapa tugas sekaligus, riset multi-langkah yang panjang dengan working set besar, atau tugas yang mengunduh dan memproses file. Jika pola pemakaianmu berubah dan agen mulai mati, itu tanda bahwa tier 8 GB memang dibutuhkan, bukan karena ada cacat.
Pola terkait adalah agent yang hang, bukan crash. Loop agent yang menunggu tool yang tidak pernah kembali, misalnya panggilan jaringan ke layanan yang sedang mati, akan terus menunggu tanpa batas dan terlihat sama seperti agent yang mati. Me-restart instance akan membersihkannya, dan riwayat run biasanya menunjukkan langkah mana tempat ia berhenti.
Kunci penyedia, saldo, dan nama model
Hermes adalah bawa-kunci-sendiri, jadi keheningan yang paling umum berasal dari penyedia AI kamu, bukan dari agen. Empat kegagalan menghasilkan gejala yang sama, dan keempatnya diperbaiki di sisi penyedia:
| Apa yang salah | Cara mengetahuinya | Di mana memperbaikinya |
|---|---|---|
| Kunci tidak valid atau sudah diganti | Setiap permintaan gagal seketika, sejak permintaan pertama setelah perubahan | Buat ulang dan tempel ulang kuncinya |
| Saldo kredit habis | Sempat berfungsi, lalu berhenti, padahal tidak ada perubahan konfigurasi | Halaman tagihan penyedia |
| Terkena rate limit | Kadang berfungsi, gagal beruntun, dan makin parah saat agen berputar dalam loop | Halaman batas penyedia, atau perlambat agent |
| Nama model sudah dihentikan | Gagal di setiap permintaan, padahal kuncinya valid di tempat lain | Perbarui model di konfigurasi agenmu |
Tempel ulang kuncinya daripada hanya membacanya lalu memutuskan bahwa kuncinya sudah benar. Spasi di akhir lolos dari pengecekan visual dan membuat setiap permintaan gagal.
Batas laju lebih berat dirasakan agen daripada chatbot
Ini layak punya bagian sendiri karena agen sangat mudah menyentuh batas. Asisten chat membuat satu permintaan per pesan manusia. Agen membuat satu permintaan per langkah dalam loop penalarannya, dan tugas multi-langkah bisa menghasilkan puluhan panggilan dalam satu menit tanpa kamu melakukan apa pun.
OpenRouter adalah pilihan umum untuk Hermes, dan tier gratisnya membuat efeknya terasa nyata. Varian model gratis, yang ID-nya berakhiran :free, dibatasi 20 permintaan per menit, dan jatah hariannya 50 permintaan jika kamu belum membeli kredit senilai $10 atau lebih sepanjang umur akun, lalu naik menjadi 1000 per hari setelah kamu melakukannya. Agent yang mengerjakan tugas riset bisa menghabiskan 50 permintaan harian dalam satu kali run, dan saat itu ia berhenti di tengah tugas tanpa penjelasan yang jelas.
Jika agenmu menyelesaikan tugas singkat tetapi selalu gagal di tugas panjang, kemungkinan besar inilah penyebabnya. Solusinya adalah memakai varian model berbayar, atau menerima batasannya dan menjaga tugas tetap kecil. Top-up sekali bayar memang menaikkan batas harian, tetapi tidak menaikkan batas per menit, jadi loop yang sangat cerewet tetap bisa menyentuh 20 per menit berapa pun saldo yang sudah kamu isi.
Agen hanya bicara tetapi tidak pernah bertindak
Ini adalah masalah yang jarang didiagnosis dengan benar, karena tidak ada error sama sekali. Agen membalas dengan lancar, menjelaskan apa yang akan dilakukannya, lalu tidak benar-benar melakukannya. Tidak ada alat yang berjalan, tidak ada file yang muncul, dan tidak ada yang terjadi di luar percakapan.
Penyebabnya adalah modelnya. Agen bekerja dengan meminta model menghasilkan pemanggilan alat yang terstruktur, dan tidak semua model mendukungnya. Arahkan Hermes ke model tanpa tool calling dan kamu mendapat partner percakapan yang kompeten tetapi diam-diam kehilangan kemampuan untuk bertindak. Bukan rusak; ia hanya tidak punya tangan.
Pastikan model yang kamu pilih mencantumkan tool calling atau function calling di antara kemampuannya, dan utamakan model yang secara eksplisit didokumentasikan penyedianya untuk penggunaan agen. Inilah juga alasan mengapa model termurah yang tersedia sering menjadi penghematan palsu untuk agen: kemampuan mengikuti protokol tool calling secara andal jauh lebih penting daripada harga per token, ketika tujuan utamanya adalah agen menjalankan tindakan.
Masalah yang sama dalam bentuk lebih ringan adalah model yang mendukung tool calling tetapi melakukannya tidak andal, menghasilkan pemanggilan yang rusak yang gagal diam-diam dan terus dicoba ulang. Jika agenmu setengah berfungsi dan riwayat run penuh dengan percobaan berulang pada langkah yang sama, coba model yang lebih kuat sebelum menganggap tugasnya yang bermasalah.
Ketika agen baik-baik saja tetapi kamu tidak bisa menjangkaunya
Hermes dilengkapi mesh Tailscale agar agen bisa menjangkau jaringan privatmu, dan banyak orang memakai mesh yang sama untuk mengakses dashboard. Ini menciptakan mode kegagalan: agen sepenuhnya sehat, tugas terjadwalnya masih berjalan, tetapi kamu tidak punya jalur untuk mencapainya.
Kunci autentikasi kedaluwarsa, dan kunci perangkat juga kedaluwarsa, jadi instance yang tidak tersentuh selama berbulan-bulan bisa terlepas dari tailnet tanpa ada yang salah. Periksa konsol admin Tailscale: jika perangkat hilang atau tidak diotorisasi, buat kunci autentikasi baru dan hubungkan ulang. Tanda penyebab ini adalah pekerjaan terjadwal tetap berjalan saat dashboard tidak bisa dijangkau.
Kebalikannya juga perlu diketahui. Jika agen bisa menjangkau dashboard tetapi tidak bisa menjangkau layanan internalmu, mesh aktif untukmu tetapi tidak untuk agen, yang biasanya berarti perangkat kehilangan otorisasinya, bukan layanannya berpindah.
Daftar periksa
- Tanyakan sesuatu yang sepele kepada agen di dashboard. Satu jawaban akan memeriksa instance dan penyedia sekaligus.
- Periksa instance di dashboard Flux kamu untuk melihat restart loop, dan periksa RAM jika beban kerjamu bertambah berat.
- Periksa dashboard penyedia untuk kunci yang tidak valid, saldo kosong, rate limit, atau nama model yang sudah pensiun.
- Jika tugas panjang gagal dan yang pendek berhasil, anggap ada batas laju dan periksa jatah harianmu sebelum hal lain.
- Jika agen bicara tetapi tidak pernah bertindak, pastikan model yang dipilih mendukung tool calling.
- Jika dashboard tidak bisa dijangkau tetapi tugas terjadwal tetap berjalan, periksa Tailscale untuk perangkat atau kunci autentikasi yang sudah kedaluwarsa.
Hampir setiap kasus berujung pada langkah satu, tiga, atau lima. Agen punya lebih banyak titik kegagalan daripada asisten chat karena ia melakukan lebih banyak hal, dan setiap titik meninggalkan jejak yang berbeda.
Pertanyaan yang sering diajukan
Mengapa agen Hermes-ku berhenti merespons?
Lima penyebab menjelaskan hampir semuanya: instance tidak berjalan, kunci penyedia tidak valid atau sudah diganti, saldo kredit habis, kamu terkena batas permintaan penyedia, atau jalur ke dashboard-mu mati padahal agennya masih bekerja. Coba tanyakan hal sepele ke agen lewat dashboard dulu, karena hasilnya memberitahumu bagian daftar mana yang harus diselidiki.
Agenku membalas dengan normal tapi tidak pernah benar-benar melakukan apa pun. Kenapa?
Hampir pasti modelnya tidak mendukung tool calling. Agen bertindak dengan membuat model mengeluarkan tool call terstruktur, sehingga model tanpa kemampuan itu hanya menghasilkan balasan percakapan yang lancar tanpa tindakan apa pun. Tidak ada error yang muncul, itulah sebabnya masalah ini sering salah didiagnosis. Ganti ke model yang didokumentasikan penyedianya mendukung tool atau function calling.
Kenapa agenku berhenti di tengah tugas panjang?
Biasanya karena batas permintaan. Agen membuat satu permintaan per langkah penalaran, sehingga tugas multi-langkah bisa menghasilkan puluhan panggilan dalam satu menit. Di OpenRouter, varian model gratis dibatasi 20 permintaan per menit dan 50 permintaan per hari sampai akun membeli kredit senilai $10, setelah itu jatah harian menjadi 1000. Satu kali riset saja bisa menghabiskan 50 permintaan sendirian.
Bisakah kunci yang kedaluwarsa membuat agen diam, bukan menampilkan error?
Di dashboard, biasanya kamu akan melihat error. Yang diam-diam adalah pekerjaan terjadwal dan latar belakang, yang gagal tanpa ada yang memperhatikan. Jika tugas yang dulu berjalan berhenti berjalan tanpa perubahan konfigurasi, cek saldo dan kunci penyedia sebelum memeriksa agennya.
Dashboard tidak bisa dimuat, tetapi tugas terjadwalku masih berjalan. Apa artinya?
Agennya sehat, tetapi jalur jaringanmu ke agen itu tidak. Jika kamu mengakses instance lewat Tailscale, cek konsol admin untuk device key atau auth key yang sudah kedaluwarsa. Device key kedaluwarsa menurut jadwalnya sendiri, jadi instance yang sudah berbulan-bulan tidak disentuh bisa terlepas dari tailnet tanpa ada yang gagal.
Apakah paket yang lebih besar akan mencegah agenmu crash?
Hanya jika memori adalah penyebabnya. Paket 4 GB cukup untuk agen pribadi yang melakukan tugas terjadwal dan ad-hoc sesekali; 8 GB untuk konkurensi, run multi-langkah yang panjang dengan working set besar, dan tugas yang mengunduh serta memproses file. Jika agen ditolak penyedia atau macet di pemanggilan alat, instance yang lebih besar tidak mengubah apa pun.
Deploy agen AI Hermes milikmu
Instance privat di cloud terdesentralisasi Flux mulai dari $5.49 sebulan, dengan kunci model milikmu sendiri. Minggu pertama gratis untuk pengguna baru.
Lihat paket