Conversational Analytics API memiliki batasan umum berikut terkait jumlah sumber data, gaya visualisasi, dan ukuran set data.
Batasan sumber data
Bagian ini menjelaskan batasan dan perilaku Conversational Analytics API saat Anda terhubung ke dan membuat kueri sumber Looker dan database—AlloyDB untuk PostgreSQL, Cloud SQL untuk MySQL, Cloud SQL untuk PostgreSQL, dan Spanner.
Batasan sumber data Looker
Saat Anda terhubung ke sumber data Looker, perhatikan hal-hal berikut:
- Anda dapat membuat kueri untuk Eksplorasi apa pun yang disertakan dalam percakapan.
- Agen hanya dapat membuat kueri satu Eksplorasi dalam satu waktu. Anda tidak dapat menjalankan kueri di beberapa Eksplorasi secara bersamaan.
- Agen dapat membuat kueri beberapa Eksplorasi dalam percakapan yang sama.
Agen dapat membuat kueri beberapa Eksplorasi dalam percakapan yang menyertakan pertanyaan dengan beberapa bagian, atau dalam percakapan yang menyertakan pertanyaan lanjutan.
Misalnya: Pengguna menghubungkan dua Jelajah, satu bernama
cat-exploredan satu lagi bernamadog-explore. Pengguna memasukkan pertanyaan "Mana yang lebih banyak: jumlah kucing atau jumlah?" Tindakan ini akan membuat dua kueri: satu untuk menghitung jumlah kucing dicat-exploredan satu untuk menghitung jumlah didog-explore. Agen membandingkan angka dari kedua kueri setelah menyelesaikan kedua kueri.Metode
QueryDatatidak mendukung sumber data BigQuery atau Looker.
Batasan sumber data database
Saat Anda terhubung ke sumber data AlloyDB, Cloud SQL untuk MySQL, Cloud SQL untuk PostgreSQL, atau Spanner, pertimbangkan hal-hal berikut:
Agen data mengakses data menggunakan kredensial pengguna yang berinteraksi dengan agen data. Jika pengguna mengakses agen data bersama yang tidak memiliki akses ke tabel yang dikonfigurasi agen, maka agen data tidak dapat mengakses tabel tersebut.
Pemilihan tabel untuk agen data memandu agen Anda tentang tabel mana yang harus difokuskan. Pemilihan tabel bukanlah setelan keamanan. Meskipun Anda menentukan bahwa sumber data hanya dapat menarik informasi dari tabel tertentu—seperti
table1dantable2—sistem mungkin masih menampilkan data dari tabel yang tidak diinginkan (table3) jika pengguna yang menjalankan kueri memiliki izin umum untuk melihat kontentable3dalam database yang sama.
Batasan visualisasi
Jenis visualisasi berikut didukung:
- Area
- Batang
- Geobentuk
- Peta panas
- Garis (Deret waktu)
- Lingkaran
- Sebar
Batasan pemrosesan data
- Untuk sumber data Looker, Conversational Analytics API dapat menampilkan maksimum 5.000 baris per kueri.
- Untuk sumber data BigQuery, Conversational Analytics API membatasi kueri data hingga 500 GB byte yang diproses.
- Untuk sumber data AlloyDB, Cloud SQL untuk MySQL, Cloud SQL untuk PostgreSQL, dan Spanner, Conversational Analytics API dapat menampilkan maksimum 1.000 baris per kueri.
- Kemampuan penalaran dan pengambilan konten berbasis Python Conversational Analytics API dapat mengakomodasi kompleksitas waktu hingga
O(100k)baris. - Membuat kueri data dalam jumlah besar dapat menyebabkan akurasi penalaran yang lebih rendah pada agen data.
- Conversational Analytics API memiliki panjang output token maksimum 8.192 token. Membuat kueri data dalam jumlah besar dapat menampilkan error
MAX_TOKENS. - Data yang ditampilkan dalam kolom
DataResultpesan sistem tunduk pada batas ukuran. Hasil data dipangkas hingga maksimum 3.000.000 byte. Proses pemangkasan ini mempertahankan sebanyak mungkin baris lengkap dalam batasan ukuran ini.
Batasan kueri
- Fitur nama kolom fleksibel BigQuery tidak didukung.
- Struct di BigQuery didukung, tetapi terkadang dapat gagal.
- Untuk sumber data Looker, API tidak dapat menetapkan nilai kolom hanya filter yang ditentukan menggunakan parameter LookML
parameter. - Penggunaan Conversational Analytics API untuk terhubung ke instance Looker (Google Cloud core) IP pribadi menggunakan Data Studio Pro saat instance Looker (Google Cloud core) tersebut berada di dalam perimeter Kontrol Layanan VPC bukanlah konfigurasi yang didukung dan tidak memenuhi persyaratan kepatuhan terhadap Kontrol Layanan VPC.
- Untuk koneksi ke instance Looker (Google Cloud core) dengan konfigurasi IP pribadi, Conversational Analytics API tidak mendukung instance Looker (Google Cloud core) yang dikonfigurasi untuk menggunakan CMEK atau Kontrol Layanan VPC.
- Untuk resource Conversational Analytics API, CMEK hanya didukung untuk sumber data Looker.
- Conversational Analytics API tidak berfungsi dengan baik dengan sumber data Data Studio yang menonaktifkan pengeditan kolom dalam laporan karena setelan ini mencegah Conversational Analytics membuat kolom kalkulasi.
Jika terjadi kegagalan selama validasi atau eksekusi kueri, Conversation Analytics API dapat otomatis mencoba kembali operasi dengan membuat kueri yang telah diperbaiki. Percobaan ulang semacam ini akan dilakukan maksimal tiga kali per permintaan.
Jika kueri gagal karena masalah izin atau autentikasi, Conversational Analytics API tidak akan mencoba lagi kueri tersebut. Percobaan ulang bersifat non-deterministik; jika pesan error menunjukkan bahwa kueri tidak dapat dipulihkan, API tidak akan mencoba kueri lagi, meskipun masih di bawah batas tiga error per permintaan.
Batasan kuota
- Conversational Analytics API memiliki batas berikut untuk permintaan secara keseluruhan (termasuk permintaan chat dan non-chat):
- Kecepatan maksimum 10 kueri per detik (QPS), yaitu 600 kueri per menit (QPM) per project.
- Kecepatan maksimum 10 QPS, yaitu 600 QPM per pengguna per project.
- Sebagai pengecualian, permintaan chat memiliki batas yang lebih ketat:
- Kecepatan maksimum 30 QPM per project.
- Kecepatan maksimum 30 QPM per pengguna per project.
- Conversational Analytics API untuk AlloyDB, Cloud SQL untuk MySQL, Cloud SQL untuk PostgreSQL, dan Spanner memiliki batas 50 QPM per project. Untuk meningkatkan batas ini, hubungi Google Cloud Customer Care.
Batasan jenis pertanyaan
Conversational Analytics API mendukung pertanyaan yang dapat dijawab oleh satu visualisasi, misalnya:
- Tren metrik dari waktu ke waktu
- Perincian atau distribusi metrik menurut dimensi
- Nilai unik untuk satu atau beberapa dimensi
- Nilai metrik tunggal
- Nilai dimensi teratas menurut metrik
Conversational Analytics API belum mendukung pertanyaan yang hanya dapat dijawab dengan jenis visualisasi rumit berikut:
- Prediksi dan perkiraan
- Analisis statistik lanjutan, termasuk korelasi dan deteksi anomali