Function Tool Settings

Pengaturan function tool menentukan bagaimana model AI mengenali dan memanggil SQL Database Reader. Field-field ini mengatur identitas plugin dalam penalaran agent: apa namanya, jenis pertanyaan apa yang ditanganinya, apa yang ditampilkan selama plugin berjalan, dan batasan apa yang berlaku saat eksekusi.

Buka Tools → Plugins → SQL Database Reader → Function di sidebar agent.

Function Name

Function name adalah identifier yang digunakan AI secara internal saat memutuskan untuk memanggil plugin ini. Nama ini harus unik di antara semua plugin yang dikonfigurasi untuk agent ini.

Aturan penamaan:

• Harus diawali huruf
• Hanya boleh berisi huruf, angka, dan underscore
• Tanpa spasi, tanda hubung, atau karakter khusus

Contoh yang valid: query_crm_data, getOrderStatus, inventoryLookup

Membuat function name dengan AI

Klik Generate Name dan berikan deskripsi singkat tentang database apa yang dibaca plugin ini. AI akan menyarankan nama yang mengikuti aturan penamaan dan mencerminkan konteks datanya.

Function Description

Description memberi tahu AI kapan harus memanggil plugin ini. Saat user mengirim pesan, agent membaca description ini untuk memutuskan apakah SQL Database Reader adalah tool yang tepat untuk digunakan.

Tulis description dari sudut pandang agent: jelaskan data yang bisa diakses, bukan cara kerja internal plugin.

Contoh:

Query database penjualan perusahaan untuk mengambil riwayat order, angka pendapatan, detail akun pelanggan, dan tingkat stok produk.

Membuat description dengan AI

Setelah memilih tabel dan kolom di konfigurasi skema, klik Generate Description. AI menganalisis pilihan skema Anda dan menulis description yang sesuai dengan cakupan data secara otomatis.

Loading Text

Pesan yang ditampilkan ke user selama query sedang dijalankan. Gunakan untuk memberi gambaran tentang apa yang sedang terjadi dan mencerminkan jenis data yang sedang diambil.

Contoh:

• Retrieving data from the CRM...
• Looking up your order history...
• Querying inventory levels...

Rules

Instruksi yang wajib diikuti AI saat membuat SQL untuk plugin ini. Gunakan field ini untuk menegakkan batasan bisnis dan mencegah query yang tidak diinginkan.

Rules yang umum:

Only generate SELECT queries. Never generate INSERT, UPDATE, or DELETE statements.
Do not return more than 500 rows per query.
If the user's question is ambiguous, ask for clarification before querying.
Do not expose columns that contain passwords or internal system codes.

Response Prompt

Instruksi tentang bagaimana AI harus memformat dan menyajikan hasil query kepada user setelah eksekusi.

Contoh:

Present results as a readable summary with key figures highlighted.
Format numerical values with thousand separators and two decimal places.
If the result set is empty, explain that no matching records were found.
If there is more than one row, present the data as a numbered list.

Query Logging

Secara default, setiap query yang dijalankan plugin ini dicatat di tab Logs: pertanyaan yang diajukan, SQL yang dihasilkan untuknya, apakah berhasil, dan berapa banyak baris yang dikembalikan.

Matikan Enable Query Logging ketika pertanyaannya sendiri bersifat sensitif. Susunan kata sebuah pertanyaan bisa mengungkap sebanyak data di baliknya, dan di sebagian organisasi catatan semacam itu tidak boleh disimpan oleh pemilik agent.

Selama switch ini mati, tidak ada apa pun tentang query yang dicatat: baik run yang berhasil, kegagalan, maupun pertanyaan yang tidak bisa diubah AI menjadi SQL. Query tetap berjalan dan tetap menjawab seperti biasa, dan tab Logs menyatakan bahwa pengaturan ini mati, supaya ringkasan yang tidak berubah tidak disangka sebagai halaman yang rusak.

Mematikan logging tidak menghapus apa yang sudah tersimpan. Entri yang sudah ada tetap terlihat sampai kedaluwarsa setelah 30 hari.

Menyalakan kembali pengaturan ini akan melanjutkan pencatatan mulai dari query berikutnya. Query yang berjalan selama logging mati hilang untuk selamanya, jadi biarkan tetap menyala jika nanti Anda mungkin perlu mengaudit atau men-troubleshoot apa yang ditanyakan agent ke database.

Menyimpan Konfigurasi

Setelah mengisi semua field, klik Save. Definisi function didaftarkan ke agent dan AI akan mulai mengenali pertanyaan yang masuk dalam cakupan plugin ini.

Halaman Terkait

• Configure Tables and Columns: pilihan skema menjadi bahan bagi pembuat description.
• Testing Queries: verifikasi bahwa AI memanggil plugin untuk pertanyaan yang tepat.
• Overview SQL Database Reader