Web console untuk operasional jaringan berbasis agent AI. Agent berjalan di backend terpisah; NetOpsUI menyediakan UI dan pengelolaan skill/profil agent.
| Istilah | Definisi |
|---|---|
| Backend | Layanan agent yang dipanggil UI lewat API: NetOps Agent (repo saat ini masih bernama palapa-agent) atau Hermes. Tepat satu yang aktif. |
| Adapter | Modul di frontend/js/backends/ yang menerjemahkan API satu backend ke kontrak bersama UI |
| Manager | Service milik NetOpsUI (server/, FastAPI + SQLite) untuk skill, profil agent, dan view config yang tidak punya API di backend |
| Thread | Satu percakapan chat. Di NetOps Agent disimpan di browser; di Hermes berupa session di server. |
| Run / Giliran | Satu pesan operator beserta seluruh kerja agent sampai jawaban selesai |
| Tool activity | Tool call yang dijalankan agent selama satu giliran (panel kanan AI Chat) |
| Approval | Izin operator sebelum agent menjalankan command berisiko (hanya Hermes: approval.request) |
| Skill | Prosedur kerja agent berbentuk SKILL.md. Library-nya ada di DB NetOpsUI; Publish menyalinnya ke folder skill backend |
| Publish | Menulis SKILL.md dari library ke folder skill sebuah backend. Status: Draft / Tersinkron / Perlu publish / Diubah di backend |
| Profil agent | Prompt bernama di DB NetOpsUI. Hermes: dikirim per run sebagai instructions. NetOps Agent: diterapkan ke SOUL.md |
| SOUL.md | File persona agent (dibaca backend). NetOpsUI hanya menulisnya lewat aksi "Terapkan ke SOUL.md" pada NetOps Agent |
| Provider LLM | Profil endpoint OpenAI-compatible (Base URL, model, API key write-only) di DB NetOpsUI. Terapkan menulis blok model: di config.yaml backend; backend perlu di-restart oleh operator |
| Belum tersedia | Screen yang datanya belum punya API (NAV_ITEMS[].unavailable): Nodes, Backups, Metrics |
- UI tidak memuat logika agent/LLM dan tidak pernah memanggil router secara langsung.
- Screen hanya berkomunikasi dengan backend melalui
activeBackend(); tidak adafetchlangsung ke backend dari screen. - Credential (API key Hermes, key provider LLM) hanya disimpan di database manager, tidak pernah di environment/
.envdan tidak pernah di browser; API hanya mengembalikan statushas_key. Satu-satunya tempat lain key provider berada adalah config backend setelah operator menekan Terapkan. Manager tidak pernah mengembalikan nilai.env, danconfig.yamlselalu dimasking. - Thread milik satu backend; mengganti backend aktif memuat ulang daftar thread dari backend itu.
- Manager hanya menulis ke
skills/kedua backend,SOUL.mdNetOps Agent, dan blokmodel:diconfig.yamlkedua backend (dengan backup dan verifikasi); sisanya read-only. Publish tidak menimpa file yang bukan hasil publish NetOpsUI tanpa konfirmasi. - Repo NetOpsUI tidak mengubah repo palapa-agent maupun home backend di luar dua jalur tulis di atas.