WEB / API & Backend

REST API & AI Copilot Engine

REST API & AI Copilot Engine

Spesifikasi lengkap endpoint backend REST API, arsitektur pencarian semantik Fuse.js, dan panduan integrasi AI Copilot.


1. Ringkasan Endpoint REST API

Endpoint Method Fungsi Autentikasi
/api/docs GET Mengambil seluruh daftar dokumen, kategori, dan struktur tree Terbuka
/api/docs/:id GET Mengambil dokumen spesifik berdasarkan slug atau ID Terbuka
/api/docs POST Menambahkan dokumen baru ke basis data Internal
/api/docs/:id PUT Memperbarui isi atau metadata dokumen yang ada Internal
/api/docs/:id DELETE Menghapus dokumen dari basis data Internal
/api/ai/chat POST Chat interaktif dengan AI Copilot berbasis grounding RAG Internal
/api/ai/doc-assist POST Bantuan AI pembuatan & penyuntingan artikel dokumen Internal
/api/ai/status GET Status kesehatan gateway AI dan in-memory cache Terbuka

2. Mekanisme Anti-Halusinasi (Strict RAG)

Untuk memastikan AI tidak menjawab dengan karangan:

  1. Grounding Retrieval: Setiap pertanyaan pengguna akan terlebih dahulu dicari padanan konteksnya menggunakan Fuse.js terhadap basis data documents.json dan apps.json.
  2. Konteks Terinjeksi: Potongan dokumen resmi disuntikkan ke dalam system prompt.
  3. Suhu Rendah (Temperature 0.1): Parameter temperatur diatur ke nilai 0.1 guna meminimalkan variasi acak dan mengunci AI pada fakta dokumen.
  4. Kerahasiaan Model: Nama model AI tidak pernah dipublikasikan di antarmuka maupun response API.