Documents
Buka di CMSLayar Documents menampilkan daftar file yang dipakai agent sebagai referensi saat menjawab, dan menjadi tempat Anda mengunggah file baru. Terdapat di sidebar agent pada Knowledge → Documents. Mengklik sebuah dokumen membuka halaman detailnya.
Daftar Dokumen
| New Document | Membuka form Add New Document. |
| Search Documents | Menampilkan atau menyembunyikan panel pencarian di bawah tombol. |
| Sort By | Mengurutkan daftar berdasarkan Code, Title atau State, dalam urutan Ascending atau Descending. |
| Grid View / List View | Beralih antara kartu thumbnail dan daftar ringkas. Pilihan Anda diingat. |
| Kartu dokumen | Menampilkan thumbnail, badge state, judul, kode, author, dan jumlah chunk yang aktif (misalnya "12 of 12 active chunks"). Klik untuk membuka halaman detail. |
| Badge state | Initial, Processing, Pending, Active, Inactive, Activating, Deactivating, Reactivating, Cancelled, Failed atau Deleted. |
| Load more data | Memuat halaman dokumen berikutnya. |
Search Documents
| Code | Mencari dokumen berdasarkan kode. |
| Title | Mencari dokumen berdasarkan judul. |
| Author | Membatasi daftar ke satu author terdaftar. |
| State | Membatasi daftar ke satu state (misalnya Active atau Failed). |
| Apply | Menjalankan pencarian. |
| Reset | Mengosongkan semua field pencarian. |
Add New Document: File dan Ingestion Mode
Form ini pertama-tama meminta file dan cara file tersebut diproses. Kartu-kartu lainnya muncul setelah file dipilih.
| File | File yang akan diunggah (wajib diisi). File disimpan sementara dan dihapus setelah training selesai. |
| Document Guidelines | Menampilkan tips untuk file sumber yang baik: teks biasa lebih disarankan, tipe file yang diizinkan dicantumkan, hapus header halaman, footer, dan nomor halaman, serta ulangi header tabel di setiap halaman. |
| Ingestion Mode | Cara dokumen dipecah menjadi chunk (wajib diisi). Pilihan: Adaptive, Regulatory Context, Fact Sheet, Skimming, Semantic. |
| Mode Guide | Menampilkan deskripsi singkat setiap ingestion mode. |
Tombol ... | Membuka Ingestion Mode Parameters untuk mode yang dipilih. Jika ada parameter yang tidak valid di sana, pesan error muncul di bawah field sampai Anda memperbaikinya. |
Mode Ingestion
| Adaptive | Berbasis AI. Menganalisis struktur dokumen dan memilih pendekatan chunking terbaik. Gunakan saat Anda tidak yakin dengan tipe dokumennya. |
| Semantic | Dasar. Memecah dokumen menjadi bagian-bagian yang seimbang sambil menjaga alurnya tetap tersambung. Pilihan paling sederhana saat ragu. |
| Skimming | Terstruktur. Untuk dokumen panjang dan berhierarki seperti buku, manual, atau laporan multi-bab. Mempertahankan bab dan section, dan dapat meringkas section yang memiliki sub-section. |
| Regulatory Context | Cerdas. Untuk dokumen hukum dan kepatuhan. Mengikuti struktur hukum (misalnya satu pasal per section) dan menjaga ketentuan yang saling terkait tetap bersama. |
| Fact Sheet | Cerdas. Untuk dokumen pendek sekitar 1 sampai 3 halaman. Mempertahankan tata letak asli dan menangkap grafik beserta penjelasannya. |
Ingestion Mode Parameters
Field-nya bergantung pada mode yang dipilih. Dalam mode pembuatan, dialog ditutup dengan Set Parameters; pada dokumen yang sudah diproses, dialog ini read-only.
| Content Training AI Model | Model yang dipakai untuk training dan pembuatan embedding (Adaptive, Skimming, Regulatory Context, Fact Sheet). Untuk Regulatory Context, hanya model yang menerima input PDF dan TXT yang ditampilkan. |
| Content Size (in tokens) | Hanya Semantic. Banyaknya teks yang masuk ke setiap chunk. Chunk yang lebih kecil (200 sampai 400 token) menemukan jawaban yang presisi, chunk yang lebih besar (600 sampai 1000) menyimpan lebih banyak konteks. |
| Overlapping Ratio (%) | Hanya Semantic. Banyaknya konten yang dibagi setiap chunk dengan chunk berikutnya. Nilai yang lebih tinggi memberi alur yang lebih mulus, tetapi menambah jumlah chunk dan biaya. |
| Start Page / Finish Page | Halaman awal dan halaman terakhir yang disertakan. Kosongkan Finish Page untuk memproses sampai akhir. |
| Excluded Pages | Hanya Adaptive. Jenis konten yang harus dilewati AI saat menyusun struktur dokumen. Ketik entri custom lalu tekan Enter. |
| Use Summarization | Hanya Skimming. Menambahkan ringkasan singkat ke section di tingkat yang lebih tinggi. Dapat menambah pemakaian. |
| Keep Small Sections Separate | Hanya Skimming. Saat aktif, section kecil tidak digabungkan ke section yang lebih besar. |
| Minimum / Maximum Section Size (in tokens) | Hanya Skimming. Kapan section kecil digabungkan, dan seberapa besar sebuah section boleh menjadi. |
| Use Full LLM Enrichment | Hanya Adaptive (Advanced Parameters). Aktif: setiap section diproses oleh LLM, yang dapat meningkatkan retrieval tetapi lebih mahal dan lebih lama. Nonaktif: hanya section yang merujuk ke section lain yang dikirim. |
| LLM Enrichment Sections Threshold | Hanya Adaptive. Jumlah maksimum section yang dikirim ke LLM enrichment. Kosongkan untuk tanpa batas. |
| Minimum / Maximum Chunk Size (in tokens) | Hanya Adaptive. Petunjuk ukuran yang diberikan ke AI saat menyusun struktur dokumen. |
| Page Overlap | Adaptive dan Skimming. Halaman yang diulang saat dokumen panjang dipecah, untuk menjaga konteks. |
| Document Type Hint | Hanya Adaptive. Petunjuk opsional seperti "product manual". Kosongkan untuk deteksi otomatis. |
| Table as Plain Text | Semantic dan Skimming. Memperlakukan tabel sebagai teks biasa. Matikan hanya untuk dokumen dengan banyak tabel kompleks. |
| Skip Image Analysis | Semantic dan Skimming. Saat aktif, gambar diabaikan sehingga menghemat waktu dan biaya. Saat nonaktif, gambar dideskripsikan oleh AI. |
| Image Description AI Model | Model yang mendeskripsikan gambar. Selalu ditampilkan untuk Adaptive; untuk Semantic dan Skimming hanya saat Skip Image Analysis nonaktif. |
Detail Dokumen
| Title | Nama utama dokumen (wajib diisi). |
| Author | Author terdaftar, ditampilkan sebagai kode dan nama (wajib diisi). Author dikelola di Citations → Authors. |
| Code | Identitas unik dokumen buatan Anda sendiri (wajib diisi), misalnya P02. |
| Thumbnail Source | Pilih URL (tempel tautan gambar HTTPS lalu klik Preview) atau Upload (pilih file gambar). |
| Document Source | Tautan ke sumber asli atau lokasi referensi. |
| Permissions | Kode permission yang membatasi dokumen ini hanya untuk user yang berwenang. |
| Save / Cancel | Save membuat dokumen dan memulai pemrosesan. Jika referensi dimatikan untuk agent, Anda akan ditanya apakah ingin mengaktifkannya. |
Document Detail
| Document State | State dokumen saat ini dan jumlah chunk yang aktif. |
| View Chunks | Membuka Chunks yang difilter ke dokumen ini. |
| Chunking Process | Status chunking, dengan tombol View Log. |
| View Log | Membuka Chunking Log dengan tombol refresh dan opsi Auto Refresh selama pemrosesan berjalan. |
| Document Preview | Menampilkan file yang diunggah untuk dokumen PDF, TXT, dan Markdown. |
| Mengedit | Title, Author, Code, thumbnail, Document Source, dan Permissions hanya dapat diedit selama dokumen berstatus Inactive. |
Action di Halaman Detail
Tombol di header halaman bergantung pada state dokumen.
| Deactivate | Ditampilkan saat dokumen berstatus Active. Menghentikan agent memakai dokumen tersebut. |
| Activate | Ditampilkan saat dokumen berstatus Inactive. Mengaktifkannya kembali. |
| Retrain | Ditampilkan saat Inactive. Memungkinkan Anda memilih ingestion mode dan parameter baru, lalu Retrain menggantikan semua chunk yang ada. |
| Retrain as New | Tersedia dalam mode retrain. Menyalin dokumen dan memproses salinannya sebagai dokumen baru. Code harus berbeda dari aslinya. |
| Delete | Ditampilkan saat Inactive. Menghapus dokumen setelah konfirmasi. |
| Cancel Chunking | Ditampilkan selama dokumen diproses. Menghentikan pemrosesan. |
| Retry Chunking | Ditampilkan saat pemrosesan berstatus Cancelled atau Failed. Anda mengonfirmasi dengan mengetik judul dokumen. |
| Purge Document | Ditampilkan untuk dokumen Deleted, Failed atau Cancelled. Menghapusnya secara permanen setelah Anda mengetik judul dokumen. |
Panduan terkait: Dokumen