Tutorial 14: Profil — Banyak Agen, Satu Mesin

Jadi kamu sudah menikmati Hermes Agent, tapi sekarang kamu berpikir: “Bagaimana kalau aku bisa menjalankan asisten coding dan bot riset di mesin yang sama, tanpa mereka saling mengganggu?” Justru itulah gunanya profil.

Apa Itu Profil?

Anggap saja profil sebagai rumah terpisah untuk setiap agen Hermes. Setiap profil memiliki direktori sendiri yang berisi config.yaml, .env, SOUL.md, memori, sesi, skill, cron job, dan database statusnya masing-masing. Ini berarti kamu bisa menjalankan asisten coding, bot pribadi, dan agen riset secara berdampingan — masing-masing dengan API key, kepribadian, dan memori sendiri — tanpa ada satu pun yang tercampur aduk.

Peringatan penting: Jangan pernah mengarahkan dua proses agen ke profil yang sama. Keduanya menulis memori secara otomatis, dan masing-masing memuat tulisan yang lain ke dalam system prompt saat sesi dimulai. Dua penulis dalam satu rumah akan saling menumpuk status satu sama lain sampai akhirnya tidak lagi sesuai dengan apa yang kamu konfigurasikan. Profil justru ada untuk mencegah hal ini. Jika agen membutuhkan memori bersama, gunakan penyedia memori eksternal sebagai gantinya.

Memulai dengan Cepat

Memulainya sangatlah sederhana:

hermes profile create coder       # membuat profil + alias perintah "coder"
coder setup                       # konfigurasi API key dan model
coder chat                        # mulai mengobrol

Itu saja! Begitu kamu membuat profil, profil tersebut langsung menjadi perintahnya sendiri. Buat profil bernama coder dan kamu langsung punya coder chat, coder setup, coder gateway start, dan seterusnya.

Membuat Profil

Kamu punya beberapa opsi saat membuat profil:

Profil kosong — mulai dari awal dengan skill bawaan yang disertakan:

hermes profile create mybot

Lalu jalankan mybot setup untuk mengonfigurasi API key, model, dan token gateway.

Kloning konfigurasi saja — menyalin config.yaml, .env, SOUL.md, dan skill dari profil kamu saat ini:

hermes profile create work --clone

API key dan kemampuan yang sama, tapi sesi dan memori baru. Edit ~/.hermes/profiles/work/.env untuk API key yang berbeda, atau ~/.hermes/profiles/work/SOUL.md untuk kepribadian yang berbeda.

Kloning semuanya — snapshot kerja yang lengkap:

hermes profile create backup --clone-all

Ini menyalin konfigurasi, API key, kepribadian, semua memori, skill, cron job, dan plugin. Riwayat per-profil tidak disertakan (riwayat sesi, database status, backup) karena bisa mencapai puluhan gigabyte. Untuk backup lengkap termasuk riwayat, gunakan hermes profile export atau hermes backup.

Kloning dari profil tertentu:

hermes profile create work --clone-from coder

Gabungkan dengan --clone-all untuk salinan lengkap dari profil sumber tersebut.

Tips pro: Jika kamu berencana menggunakan profil sebagai pekerja kanban, berikan --description "<peran>" saat pembuatan agar orkestrator tahu keahlian profil tersebut:

hermes profile create researcher --description "Membaca kode sumber dan dokumen eksternal, menulis temuan."

Menggunakan Profil Sehari-hari

Alias perintah — setiap profil otomatis mendapatkan alias perintah:

coder chat                    # mengobrol dengan agen coder
coder setup                   # mengonfigurasi pengaturan coder
coder gateway start           # memulai gateway coder
coder doctor                  # memeriksa kesehatan coder
coder skills list             # mendaftar skill coder
coder config set model.default anthropic/claude-sonnet-4

Flag -p — kamu juga bisa menargetkan profil secara eksplisit dengan perintah apa pun:

hermes -p coder chat
hermes --profile=coder doctor
hermes chat -p coder -q "halo"    # bisa di posisi mana pun

Default lengket — atur default agar perintah hermes biasa menargetkan profil tersebut:

hermes profile use coder
hermes chat                   # sekarang menargetkan coder
hermes profile use default    # kembali ke default

Ini seperti kubectl config use-context — sederhana dan efektif.

Mengetahui posisi kamu — CLI selalu menampilkan profil mana yang aktif:

Prompt: coder ❯ bukan ❯
Banner: Menampilkan Profil: coder saat startup
hermes profile: Menampilkan nama profil saat ini, path, model, dan status gateway

Profil vs Workspace vs Sandbox

Ini sering membingungkan, padahal ketiganya adalah hal yang berbeda:

Profil memberikan Hermes direktori statusnya sendiri: konfigurasi, memori, sesi, log, cron job, dan status gateway.
Workspace atau direktori kerja adalah tempat perintah terminal dimulai — dikontrol secara terpisah oleh terminal.cwd.
Sandbox membatasi akses sistem file. Profil tidak memberikan sandbox pada agen.

Pada backend terminal local default, agen tetap memiliki akses sistem file yang sama dengan akun pengguna kamu. Profil tidak menghentikan agen untuk mengakses folder di luar direktori profil.

Penutup

Profil adalah cara terbersih untuk menjalankan beberapa agen Hermes independen dalam satu mesin. Masing-masing memiliki identitas, memori, dan konfigurasi sendiri — dan mereka tidak perlu tahu satu sama lain ada. Coba saja dengan hermes profile create dan lihat betapa lancarnya alur kerja multi-agen kamu!