Function Tool Settings

Buka di CMS

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.

AI Model for SQL Generation

Setiap pertanyaan yang dikirim agent ke plugin ini diubah menjadi SQL oleh sebuah model AI. Secara default plugin mengikuti organisasi: memakai model yang diatur di Organization → AI Models → Tasks → SQL Database Reader (atau model grup Plugins, atau model SQL bawaan Qlar bila keduanya tidak diatur). Opsinya menunjukkan model mana yang dipakai saat ini, misalnya Follow organization (Luna-no-reasoning).

Pilih model lain bila database ini membutuhkannya, misalnya model reasoning yang lebih kuat untuk skema besar dengan banyak join, atau model yang lebih cepat untuk kumpulan tabel yang kecil dan sederhana. Pilihan ini hanya berlaku untuk plugin ini; SQL Database Reader lain tetap memakai pengaturannya sendiri.

OpsiSQL ditulis dengan
Follow organizationModel organisasi untuk SQL Database Reader (default).
Qlar defaultModel SQL bawaan Qlar, apa pun pilihan organisasi. Tidak ditawarkan bila organisasi hanya mengizinkan model miliknya sendiri.
Nama sebuah modelModel tersebut. Daftarnya berisi model-model organisasi: milik Qlar dan milik organisasi sendiri (API key atau subscription).

Di bawah field, Runs on menunjukkan di mana model terpilih berjalan: Qlar platform, Your API key, atau Your subscription. Model milik Anda sendiri tidak memakai credit Qlar.

Klik Save untuk menerapkan perubahan. Perubahan berlaku untuk chat dan Query Testing mulai pertanyaan berikutnya, dan setiap entri di tab Logs menunjukkan model yang menulis SQL-nya.

Perlu diketahui:

  • Agent Service tidak ditawari model subscription (inference gateway), sama seperti aturan di tempat lain.
  • Bila organisasi menyalakan Only use your own models, hanya model milik organisasi yang ditawarkan. Plugin yang memilih salah satunya tetap menjawab walaupun organisasi belum punya model sendiri untuk SQL Database Reader.
  • Bila model yang dipilih dihapus atau tidak bisa dipakai lagi, plugin kembali memakai model organisasi dan field-nya memberi tahu hal itu. Pilih model lain atau ikuti organisasi.

Pembuatan SQL paling baik dengan model reasoning yang kuat; model kecil lebih sering menulis SQL yang salah.


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