Create a Table
Buka di CMSTabel di plugin Dynamic Table disebut collection. Setiap instance plugin dapat menampung beberapa collection, dan setiap collection memiliki skema, pengaturan pencarian, dan integration key sendiri.
Buka Tools → Plugins di sidebar agent, buka plugin Dynamic Table, lalu masuk ke tab Tables.
Membuat Collection Baru
Klik Create Table dan isi:
| Field | Deskripsi |
|---|---|
| Name | Label singkat untuk tabel, ditampilkan di UI plugin dan dipakai di function tool definition. |
| Description | Catatan opsional yang menjelaskan isi tabel ini. AI memakai deskripsi ini saat memutuskan tabel mana yang akan dikueri. |
Setelah disimpan, tabel dibuat dalam keadaan tidak aktif. Anda perlu mendefinisikan kolom dan mengisi data sebelum mengaktifkannya.
Mendefinisikan Kolom
Setiap kolom mewakili satu field di setiap baris. Bentangkan tabel dan klik Add Column untuk mendefinisikan skema.
Field Kolom
| Field | Deskripsi |
|---|---|
| Display Name | Label yang ditampilkan di UI dan dipakai di template impor/ekspor. |
| Column Name | Identifier internal yang dipakai di data dictionary dan payload API (dibuat otomatis dalam format snake_case dari display name). |
| Type | Tipe data untuk kolom ini. Lihat tipe yang didukung di bawah. |
| Description | Menjelaskan isi kolom ini. Meningkatkan kualitas pencarian dengan memberi AI konteks tentang field tersebut. |
| Searchable | Jika diaktifkan, nilai kolom ini disertakan dalam vector embedding yang dipakai untuk pencarian semantik. |
| Required | Jika diaktifkan, baris tidak dapat disimpan tanpa nilai di kolom ini. |
| Search Weight | Pengali dari 1 sampai 5. Nilai yang lebih tinggi mengulang teks kolom lebih banyak di embedding, sehingga kolom tersebut lebih berpengaruh pada hasil pencarian. |
Tipe Kolom
| Tipe | Deskripsi | Contoh nilai |
|---|---|---|
text | Teks bebas dengan panjang berapa pun. | "Prime Minister of Malaysia" |
number | Nilai numerik, bilangan bulat atau desimal. | 42, 3.14 |
email | Alamat email dengan validasi format. | "admin@example.com" |
phone | String nomor telepon. | "+60123456789" |
date | String tanggal ISO 8601. | "2024-01-15" |
boolean | Nilai true atau false. | true, false |
Kolom Primary Key
Anda dapat menetapkan satu kolom sebagai primary key untuk sebuah tabel. Ini memastikan keunikan baris: tidak boleh ada dua baris dengan nilai yang sama di kolom primary key.
Untuk menetapkan primary key:
- Klik pengaturan kolom dan aktifkan Primary Key.
- Simpan collection.
Setelah sebuah kolom ditandai sebagai primary key dan baris sudah ada, Anda tidak dapat mengubah atau menghapus penetapan primary key tersebut. Rencanakan hal ini sebelum memuat data.
Urutan Kolom
Seret kolom untuk mengubah urutannya. Urutan ini menentukan bagaimana kolom tampil di UI pengelolaan data, template ekspor, dan pratinjau impor.
Menonaktifkan Kolom
Kolom dapat dinonaktifkan alih-alih dihapus. Kolom yang dinonaktifkan disembunyikan dari UI dan tidak disertakan di baris baru maupun ekspor, tetapi datanya tetap tersimpan di baris yang sudah ada.
Sebelum menghapus kolom, sistem memvalidasi bahwa penghapusan tersebut aman. Jika kolom dipakai sebagai primary key atau berkaitan dengan field wajib, validasi akan memperingatkan Anda.
Mengaktifkan Tabel
Setelah Anda mendefinisikan kolom dan menambahkan setidaknya beberapa baris, nyalakan switch Active pada tabel. Hanya tabel aktif yang disertakan dalam function tool definition yang dilihat AI.
Beberapa Tabel dalam Satu Plugin
Satu instance plugin Dynamic Table dapat berisi beberapa collection. Setiap collection tampil sebagai tabel terpisah yang dapat dikueri. Saat mengonfigurasi Function Tool Settings, Anda menentukan nama dan deskripsi yang dilihat AI untuk setiap tabel.
Langkah berikutnya
- Tambahkan baris ke tabel untuk mengisinya dengan data.
- Impor data secara massal dari file CSV atau Excel.
- Konfigurasikan pengaturan pencarian untuk menyesuaikan perilaku pencarian semantik.