Ringkasan QueryData

QueryData memungkinkan Anda berinteraksi dengan data menggunakan bahasa percakapan dan agen data yang Anda buat untuk membantu Anda membuat kueri data. Agen data adalah asisten dan aplikasi yang didukung AI yang dapat memahami niat pengguna, membuat kueri data operasional Anda, dan memberikan jawaban yang akurat dan berdasar. QueryData membuat kueri untuk database Anda menggunakan set konteks, yang merupakan kumpulan cetak biru yang dikurasi, logika bisnis, dan informasi skema. Konteks ini memungkinkan QueryData menerjemahkan pertanyaan bahasa alami menjadi kueri yang akurat untuk target kasus penggunaan Anda.

Kapan menggunakan QueryData

QueryData ideal untuk aplikasi seperti:

  • Otomatisasi layanan pelanggan: Menangani pertanyaan dalam jumlah besar seperti "Di mana pesanan saya?" atau "Berapa saldo saya saat ini?".
  • Asisten belanja e-commerce: Membantu pengguna menavigasi katalog produk besar dengan kueri bahasa alami seperti "Tampilkan sepatu lari di bawah Rp1.000.000".
  • Alat operasi lapangan: Memungkinkan karyawan yang memiliki mobilitas tinggi untuk mengkueri tingkat inventaris, ketersediaan suku cadang, atau detail tiket servis secara real-time.

Konsep inti

Untuk menerjemahkan pertanyaan percakapan menjadi kueri database secara andal, QueryData mengandalkan konsep utama berikut:

QueryData dan Conversational Analytics API

Endpoint QueryData di Conversational Analytics API adalah alat berbasis agen yang memungkinkan pembuatan kueri bahasa alami ke SQL (NL2SQL) secara terprogram untuk database Anda. Dalam aplikasi percakapan atau alur kerja multi-agen, endpoint QueryData menangani interpretasi skema dan sintesis kueri. Infrastruktur pengelola agen Anda (seperti Antigravity, Agent Development Kit (ADK), atau LangChain) mengelola histori percakapan, status pengguna, dan orkestrasi alat untuk memberikan konteks pada input pengguna sebelum mengirim permintaan bahasa alami ke endpoint QueryData.

Set data konteks

Set konteks adalah kumpulan pengetahuan khusus database, pola kueri pilihan, dan aturan bisnis yang terkait dengan instance database Anda. Alih-alih hanya mengandalkan pengetahuan LLM umum atau skema tabel mentah, QueryData menggunakan set konteks untuk memahami nuansa model data dan terminologi khusus organisasi Anda.

Set konteks berisi tiga elemen penyusun utama:

  • Blueprint kueri: Pasangan pertanyaan bahasa alami representatif yang telah dikurasi dan kueri SQL yang sesuai dan telah divalidasi sebelumnya. Blueprint memberikan contoh kanonis yang menentukan cara memetakan maksud bisnis tertentu ke pernyataan SQL.
  • Faset kueri: Predikat SQL modular dan kondisi filter (seperti rentang tanggal, perhitungan nilai minimum, atau tanda bisnis). Faset memungkinkan QueryData menggabungkan beberapa kriteria pemfilteran secara dinamis ke dalam kueri tanpa memerlukan cetak biru terpisah untuk setiap kombinasi.
  • Penelusuran nilai: Kueri pencocokan string dan semantik yang mendasarkan frasa informal pada nilai persis yang disimpan dalam kolom database. Penelusuran nilai membantu menyelesaikan ambiguitas (misalnya, memetakan "Bay Area" ke San Francisco, atau "Heathrow" ke London Heathrow Airport) menggunakan kecocokan persis, kesamaan string trigram, atau sematan vektor semantik.

Tampilan aman yang diberi parameter

Untuk membantu memastikan bahwa kueri yang dihasilkan AI mematuhi keamanan tingkat baris dan isolasi multi-tenant, Anda dapat menggunakan tampilan aman berparameter, yang membatasi SQL yang dihasilkan agar hanya mengakses baris data yang diizinkan untuk dilihat oleh pengguna aplikasi yang diautentikasi. Untuk mengetahui informasi selengkapnya, lihat Mengamankan dan mengontrol akses ke data aplikasi menggunakan tampilan aman berparameter.

Cara kerja QueryData

Saat agen atau aplikasi Anda mengirimkan permintaan bahasa alami (seperti pertanyaan pengguna yang telah dikontekstualisasi agen dengan histori percakapan atau status pengguna), QueryData akan melakukan langkah-langkah berikut:

  1. Penyelesaian nilai: QueryData menjalankan kueri penelusuran nilai terhadap database untuk memetakan entitas dalam perintah (seperti nama, kota, atau kategori) ke nilai kolom database tertentu.
  2. Pencocokan dan disambiguasi intent: QueryData mencocokkan permintaan yang dikontekstualisasi dengan cetak biru kueri dan faset pilihan yang Anda tentukan dalam set konteks. Jika permintaan tidak ditentukan dengan jelas atau ambigu, QueryData dapat menampilkan pertanyaan disambiguasi sehingga agen atau aplikasi Anda dapat meminta klarifikasi kepada pengguna.
  3. Sintesis kueri: Menggunakan struktur cetak biru yang cocok, aspek yang diterapkan, dan nilai yang diselesaikan, QueryData mensintesis kueri SQL lengkap untuk mesin database Anda.
  4. Eksekusi kueri: Kueri yang dihasilkan dijalankan terhadap database untuk menampilkan hasil.

Membuat dan mengelola set data konteks

Untuk membuat dan mengelola set konteks, lakukan hal berikut:

  1. Konteks penulis: Tentukan cetak biru kueri, aspek, dan penelusuran nilai untuk database Anda. Untuk mengetahui informasi selengkapnya, lihat Ringkasan set konteks. Anda juga dapat menggunakan agen rekayasa konteks untuk mengotomatiskan pembuatan konteks.
  2. Kelola di konsol Google Cloud : Buat dan kelola set konteks di Cloud SQL Studio agar tersedia untuk pembuatan kueri.
  3. Berintegrasi dengan aplikasi Anda: Hubungkan aplikasi atau agen AI Anda ke QueryData menggunakan MCP Toolbox atau panggilan API langsung.

Langkah berikutnya