Halaman ini diterjemahkan dari bahasa Inggris dengan bantuan AI. Jika keduanya berbeda, versi bahasa Inggris menjadi acuannya.
query_library_search
Mencari template yang cocok dengan maksud dalam bahasa alami di Query Library StackQL. Gunakan alat ini sebelum menyusun SQL dari awal, lalu teruskan id dari salah satu hasil ke query_library_get untuk memeriksa template dan memvalidasi parameternya.
Alat ini hanya mengambil konten library. Alat ini tidak menjalankan SQL, tidak memanggil API cloud, dan tidak memerlukan kredensial provider.
Lihat juga:
[ Ringkasan MCP ] [ query_library_get ] [ validate_select_query ]
Input
| Argumen | Wajib | Deskripsi |
|---|---|---|
intent | Ya | Deskripsi tugas dalam bahasa alami. |
provider | Tidak | Filter berdasarkan provider, misalnya aws. |
service | Tidak | Filter berdasarkan layanan, misalnya s3. |
tags | Tidak | Array tag. Entri harus cocok dengan setiap tag yang diberikan. |
include_mutations | Tidak | Menyertakan template mutasi. Nilai default: false; diabaikan dalam mode read_only, yang selalu mengecualikan entri mutasi. |
limit | Tidak | Jumlah maksimum hasil. Nilai default: 5 jika dihilangkan atau tidak positif; dibatasi hingga 20. |
format | Tidak | Perenderan teks: markdown atau json. Jika dihilangkan, pengaturan render server yang digunakan (markdown secara default). |
Output
Tampilan teks default berupa tabel berperingkat yang berisi id, title, mutation, required_params, dan score, diikuti kutipan sumber dan panduan jika pencarian tidak menemukan kecocokan. Payload terstruktur berisi:
| Field | Deskripsi |
|---|---|
hits | Entri berperingkat dengan id, title, description opsional, providers, services, dan required_params, ditambah mutation dan score. Lanjutkan dengan query_library_get untuk mendapatkan deklarasi parameter yang lengkap. |
miss | true jika tidak ada hasil atau skor tertinggi berada di bawah ambang kecocokan. Kecocokan terdekat dengan skor rendah tetap dapat dikembalikan. |
guidance | Jika pencarian tidak menemukan kecocokan, mengarahkan agen ke instruksi server, alat penemuan, dan validate_select_query untuk menyusun kueri. |
source_tier | Sumber konten: primary, fallback, atau snapshot. |
source_url | URL atau jalur tersemat dari katalog yang digunakan, untuk kutipan. |
stale | Jika true, konten disajikan dari cache atau snapshot tersemat setelah pengambilan gagal. |
Entri yang sudah usang dikecualikan. Server menyimpan katalog dalam cache dan dapat beralih dari library yang di-hosting ke sumbernya di GitHub dan ke snapshot tersemat.
Pengendalian
Diizinkan di semua mode server, dengan tetap tunduk pada daftar izin alat yang dikonfigurasi. Tidak memerlukan persetujuan maupun kredensial provider. Mencari template mutasi tidak mengotorisasi eksekusi template tersebut.
Contoh
Argumen alat:
{
"intent": "List S3 bucket names and regions",
"provider": "aws",
"service": "s3",
"limit": 5
}
Gunakan id dari hits, misalnya aws/s3/buckets-list, dengan query_library_get. Jika miss bernilai true, periksa template terdekat sebagai panduan atau gunakan list_methods dan describe_method sebelum menyusun SQL.