Bagian A–J
Bagian A–J dari 101 bagian · Belajar 2
A.API Server
Hermes dapat dijalankan sebagai server HTTP yang kompatibel dengan format API OpenAI. Dengan pola ini, aplikasi klien yang sudah berbicara protokol OpenAI dapat menggunakan Hermes sebagai backend agent, sementara Hermes tetap menyediakan tool, file, terminal, web, memory, skill, dan kemampuan lain yang dikonfigurasi.
Konsep
Frontend / Client OpenAI-compatible
↓ HTTP
Hermes API Server
↓
AIAgent
├── Model / Provider
├── Tools
├── Skills
├── Memory
├── Context
└── SessionsTitik belajar
- Pahami perbedaan API server dengan CLI dan gateway pesan.
- Pelajari autentikasi, profil, streaming, dan lifecycle request.
- Jangan mengekspos endpoint agent ke jaringan tanpa autentikasi dan pembatasan tool yang sesuai.
Rujukan resmi: https://hermes-agent.nousresearch.com/docs/user-guide/features/api-server
B.ACP / Integrasi IDE
Hermes dapat berjalan sebagai ACP server untuk host/editor yang mendukung Agent Client Protocol. Dalam mode ini, editor dapat menampilkan percakapan, aktivitas tool, diff berkas, perintah terminal, permintaan persetujuan, dan keluaran streaming.
Toolset hermes-acp ditujukan untuk workflow editor dan memasukkan file, terminal, web/browser, memory, skills, execute_code, delegate_task, dan vision. Kapabilitas messaging dan cron sengaja tidak menjadi bagian dari toolset editor tersebut.
Rujukan resmi: https://hermes-agent.nousresearch.com/docs/user-guide/features/acp
C.Voice Mode dan Wake Word
Hermes mendukung interaksi suara pada CLI dan sejumlah platform pesan. Dokumentasi resminya mencakup mode mikrofon interaktif, balasan suara, dan percakapan voice channel Discord. Wake Word memungkinkan pemicu seperti “hey hermes” untuk membuka sesi suara baru di CLI/TUI/desktop.
Fokus belajar:
- LLM tetap menjadi bagian reasoning.
- Input suara membutuhkan jalur speech recognition.
- Output suara membutuhkan TTS.
- Integrasi platform menambah lifecycle dan permission yang berbeda dari CLI.
- Voice tidak menghapus kebutuhan security/approval.
Rujukan resmi: https://hermes-agent.nousresearch.com/docs/user-guide/features/voice-mode
D.Batch Processing
Batch runner menjalankan Hermes pada banyak prompt secara paralel dan menghasilkan trajectory terstruktur. Ini terutama berguna untuk:
- pembuatan data training;
- evaluasi sistem agent;
- eksperimen tool-use;
- perbandingan model/provider;
- reproduksi workload secara massal.
Format dasar dataset adalah JSONL dengan satu objek per baris dan field prompt.
Contoh pola:
{"prompt":"Analisis error aplikasi ini dan buat rencana perbaikan"}
{"prompt":"Buat fungsi Python untuk membaca file CSV"}Rujukan resmi: https://hermes-agent.nousresearch.com/docs/user-guide/features/batch-processing
E.Fallback Provider
Hermes memiliki beberapa lapisan ketahanan provider:
- Credential pools untuk rotasi beberapa kredensial pada provider yang sama.
- Primary model fallback melalui
fallback_providersuntuk berpindah provider:model ketika primary gagal. - Auxiliary task fallback untuk pekerjaan tambahan seperti vision dan compression.
Contoh bentuk konfigurasi:
fallback_providers:
- provider: openrouter
model: anthropic/claude-sonnet-4Perbedaan penting:
provider_routingmengatur sub-provider di belakang OpenRouter.fallback_providersmengatur perpindahan ke provider:model cadangan.
Rujukan resmi: https://hermes-agent.nousresearch.com/docs/user-guide/features/fallback-providers/
F.Provider Routing
provider_routing berlaku ketika Hermes menggunakan OpenRouter. Opsi resmi yang perlu dipahami antara lain:
provider_routing: sort: "price" only: [] ignore: [] order: [] require_parameters: false data_collection: null
Hermes mendokumentasikan price, throughput, dan latency sebagai contoh cara mengurutkan provider di belakang OpenRouter. Pengaturan ini tidak diterapkan ke Nous Portal maupun koneksi langsung ke provider.
Rujukan resmi: https://hermes-agent.nousresearch.com/docs/user-guide/features/provider-routing
G.Konteks Proyek: SOUL.md, AGENTS.md, dan kompatibilitas file konteks
Hermes saat ini mendeteksi sejumlah file konteks proyek. Prioritas proyek yang didokumentasikan adalah:
.hermes.md ↓ AGENTS.override.md ↓ AGENTS.md ↓ CLAUDE.md ↓ .cursorrules
SOUL.md diperlakukan terpisah sebagai identitas global Hermes.
Dalam repository Git, rantai AGENTS.md dari root menuju working directory dapat digabungkan, dengan file yang lebih spesifik muncul lebih akhir sehingga lebih spesifik.
Rujukan resmi: https://hermes-agent.nousresearch.com/docs/user-guide/features/context-files
H.Memory Built-in
Memory bawaan Hermes menggunakan dua file yang dikelola agen:
| File | Fungsi | Batas karakter terdokumentasi |
|---|---|---|
MEMORY.md | catatan lingkungan, konvensi, hal yang dipelajari | 2.200 |
USER.md | profil user, preferensi, gaya komunikasi | 1.375 |
Keduanya berada di ~/.hermes/memories/ dan diambil sebagai snapshot pada awal sesi.
Hermes juga memiliki jalur memory providers sebagai plugin untuk backend eksternal.
Rujukan resmi: https://hermes-agent.nousresearch.com/docs/user-guide/features/memory
I.Tools dan Toolsets — cara berpikir yang benar
Tool = kemampuan tunggal yang dapat dipanggil agent.\nToolset = kumpulan tool yang dikonfigurasi sebagai satu kapabilitas/preset.
Contoh toolset yang didokumentasikan antara lain:
webterminalfilebrowservisionmemorysession_searchcronjobcode_executiondelegationclarifyhomeassistantmessagingsafe
Untuk melihat dan mengubah konfigurasi tool:
hermes tools
Untuk menjalankan chat dengan toolset tertentu:
hermes chat --toolsets "web,terminal"
Rujukan resmi: https://hermes-agent.nousresearch.com/docs/user-guide/features/tools
J.Browser Automation
Hermes saat ini mendokumentasikan beberapa backend browser. Di antaranya Browser Use cloud, Browserbase, Firecrawl cloud, Camofox lokal, Lightpanda, koneksi CDP ke Chrome/Brave/Chromium/Edge, dan mode lokal tertentu.
Arsitektur belajar yang benar:
LLM ↓ Browser tool abstraction ↓ Browser backend ↓ Browser / page ↓ Accessibility tree + interactive refs
Jangan menyamakan browser automation dengan sekadar web_search. Browser dapat melakukan navigasi, klik, input, pengisian form, dan ekstraksi yang bergantung pada keadaan halaman.
Rujukan resmi: https://hermes-agent.nousresearch.com/docs/user-guide/features/browser/