Configure Tables and Columns
Buka di CMSSetelah memuat skema database, Anda memilih tabel dan kolom mana yang boleh di-query oleh agent. Plugin hanya membuat SQL terhadap tabel dan kolom yang Anda sertakan di sini; selebihnya tidak terlihat oleh AI.
Buka Tools → Plugins → SQL Database Reader → Schema di sidebar agent.
Memilih Tabel
Panel menampilkan semua tabel yang ditemukan dari koneksi database. Centang setiap tabel yang ingin Anda masukkan ke dalam cakupan query agent.
Untuk setiap tabel yang dipilih, tambahkan description, yaitu catatan singkat yang menjelaskan data bisnis apa yang ada di tabel tersebut. Deskripsi ini dimasukkan langsung ke prompt AI dan memengaruhi kualitas query. Tanpa deskripsi, AI hanya mengandalkan nama tabel dan kolom untuk menebak fungsinya.
Contoh deskripsi tabel:
Menyimpan daftar master pelanggan, termasuk informasi kontak, status akun, dan wilayah penjualan yang ditetapkan.
Memilih Kolom
Untuk setiap tabel yang dipilih, buka tabel tersebut untuk melihat kolom-kolomnya. Setiap kolom bisa disertakan atau dikecualikan satu per satu.
Kolom yang Anda kecualikan tidak akan muncul di query yang dihasilkan. Gunakan ini untuk:
- Menyembunyikan field sensitif seperti password, kode internal, atau PII.
- Mengurangi konteks yang tidak relevan yang bisa membingungkan pembuatan SQL.
- Memusatkan perhatian AI pada data yang paling berguna.
Properti kolom
| Properti | Deskripsi |
|---|---|
| Column Name | Nama kolom di database. |
| Type | Tipe data, misalnya varchar, int, datetime. |
| Nullable | Apakah kolom menerima nilai null. |
| Primary Key | Apakah kolom tersebut primary key tabel. |
| Description | Catatan singkat yang menjelaskan apa yang disimpan kolom ini. Meningkatkan akurasi query. |
Menulis deskripsi kolom yang baik
Deskripsi kolom disertakan dalam konteks skema yang diterima AI. Semakin tepat deskripsi Anda, semakin akurat SQL yang dihasilkan.
| Nama kolom | Deskripsi yang kurang baik | Deskripsi yang baik |
|---|---|---|
status | Status | Status order: pending, confirmed, shipped, cancelled |
amt | Jumlah | Total nilai invoice dalam USD sebelum pajak |
cust_id | ID Pelanggan | Foreign key yang merujuk ke customers.id |
region | Wilayah | Kode wilayah penjualan yang ditetapkan untuk akun pelanggan |
Data Dictionary
Saat Anda menyimpan konfigurasi skema, plugin membuat data dictionary dari pilihan tabel dan deskripsi Anda. Dictionary ini dipakai sebagai konteks di setiap prompt pembuatan query.
Jika Anda menambahkan tabel baru, mengubah pilihan kolom, atau memperbarui deskripsi, simpan lagi untuk membuat ulang data dictionary.
Langkah berikutnya
- Siapkan virtual foreign key untuk mendefinisikan relasi yang tidak ditegakkan oleh database secara bawaan.
- Konfigurasikan function tool untuk memberi nama plugin dan menentukan perilakunya bagi AI.