Batasan umum Conversational Analytics API

API Analisis Percakapan memiliki batasan umum berikut terkait jumlah sumber data, gaya visualisasi, dan ukuran set data.

Batasan sumber data

Bagian ini menjelaskan batasan dan perilaku Analisis Percakapan API saat Anda terhubung ke dan mengkueri BigQuery, Looker, dan sumber 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 berikut:

  • Anda dapat mengkueri Explore yang disertakan dalam percakapan.
  • Agen hanya dapat mengkueri satu Explore dalam satu waktu. Anda tidak dapat menjalankan kueri di beberapa Eksplorasi secara bersamaan.
  • Agen dapat mengkueri beberapa Eksplorasi dalam percakapan yang sama.
  • Agen dapat mengkueri beberapa Eksplorasi dalam percakapan yang menyertakan pertanyaan dengan beberapa bagian, atau dalam percakapan yang menyertakan pertanyaan lanjutan.

    Misalnya: Pengguna menghubungkan dua Eksplorasi, satu bernama cat-explore dan satu bernama dog-explore. Pengguna memasukkan pertanyaan "Mana yang lebih banyak: jumlah kucing atau jumlah?" Tindakan ini akan membuat dua kueri: satu untuk menghitung jumlah kucing di cat-explore dan satu untuk menghitung jumlah di dog-explore. Agen membandingkan angka dari kedua kueri setelah menyelesaikan kedua kueri.

  • Metode QueryData tidak 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 berikut:

  • Agen data mengakses data menggunakan kredensial pengguna yang berinteraksi dengan agen data. Jika pengguna mengakses agen data bersama yang tabel terkonfigurasinya tidak dapat diakses oleh pengguna tersebut, 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 mengambil informasi dari tabel tertentu—seperti table1 dan table2—sistem mungkin masih menampilkan data dari tabel yang tidak diinginkan (table3) jika pengguna yang menjalankan kueri memiliki izin umum untuk melihat konten table3 dalam database yang sama.

Batasan cakupan penelusuran BigQuery

Saat Anda menggunakan cakupan penelusuran untuk mengizinkan API Analisis Percakapan memilih Tabel BigQuery yang akan dikueri, batasan berikut berlaku:

  • Anda hanya dapat menggunakan cakupan penelusuran dalam permintaan chat stateless dengan konteks inline. Cakupan penelusuran tidak didukung di agen data persisten atau dalam permintaan chat stateful yang menggunakan referensi percakapan.
  • Anda dapat menentukan hingga 100 set data dan hingga 100 project.

Untuk mengetahui informasi selengkapnya, lihat Menghubungkan ke set data dan project BigQuery.

Batasan visualisasi

Berikut adalah jenis visualisasi yang didukung:

  • Area
  • Batang
  • Geoshape
  • Peta panas
  • Garis (Deret waktu)
  • Lingkaran
  • Sebar

Batasan pemrosesan data

  • Untuk sumber data Looker, Analisis Percakapan API dapat menampilkan maksimum 5.000 baris per kueri.
  • Untuk sumber data BigQuery, Analisis Percakapan API membatasi kueri data hingga 500 GB byte yang diproses.
  • Untuk sumber data AlloyDB, Cloud SQL untuk MySQL, Cloud SQL untuk PostgreSQL, dan Spanner, Analisis Percakapan API dapat menampilkan maksimum 1.000 baris per kueri.
  • Kemampuan penalaran dan pengambilan konten berbasis Python dari Analisis Percakapan API dapat mengakomodasi kompleksitas waktu hingga O(100k) baris.
  • Membuat kueri data dalam jumlah besar dapat mengurangi akurasi penalaran 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 DataResult pesan sistem tunduk pada batas ukuran. Hasil data dipotong hingga maksimum 3.000.000 byte. Proses pemotongan ini mempertahankan baris penuh sebanyak mungkin 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 parameter LookML.
  • Menggunakan Analisis Percakapan 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 Kontrol Layanan VPC.
  • Untuk koneksi ke instance Looker (Google Cloud core) dengan konfigurasi IP pribadi, Analisis Percakapan API tidak mendukung instance Looker (Google Cloud core) yang dikonfigurasi untuk menggunakan CMEK atau Kontrol Layanan VPC.
  • Conversational Analytics API tidak berfungsi dengan baik dengan sumber data Data Studio yang menonaktifkan pengeditan kolom dalam laporan karena setelan ini mencegah Analisis Percakapan membuat kolom kalkulasi.
  • Jika terjadi kegagalan selama validasi atau eksekusi kueri, Conversational Analytics API dapat otomatis mencoba kembali operasi dengan membuat kueri yang telah diperbaiki. Percobaan ulang semacam ini akan dicoba maksimal tiga kali per permintaan.

    Jika kueri gagal karena masalah izin atau autentikasi, API Analisis Percakapan tidak akan mencoba ulang kueri tersebut. Percobaan ulang bersifat non-deterministik; jika pesan error menunjukkan bahwa kueri tidak dapat dipulihkan, Conversational Analytics API tidak akan mencoba kueri lagi, meskipun masih di bawah batas tiga error per permintaan.

Batasan kuota

  • API Analisis Percakapan memiliki batasan berikut untuk permintaan secara keseluruhan (termasuk permintaan chat dan non-chat):
    • Kecepatan maksimum 30 kueri per detik (QPS), yaitu 1.800 kueri per menit (QPM) per project.
    • Tingkat maksimum 10 QPS, yaitu 600 QPM per pengguna per project.
  • Sebagai pengecualian, permintaan chat memiliki batas yang lebih ketat:
    • Tingkat maksimum 30 QPM per project.
    • Tingkat maksimum 30 QPM per pengguna per project.
    • Setiap permintaan chat dihitung sebagai 8 unit kuota, bukan standar 1 unit. Akibatnya, halaman Kuota di konsol Google Cloud menampilkan batas yang 8 kali lebih besar dari batas permintaan sebenarnya. Misalnya, batas 240 unit mewakili 30 permintaan chat.
  • Permintaan Agen ke Agen (A2A) memiliki kapasitas maksimum 100 QPM per project per agen. Setiap agen bawaan menerima batas khusus, sedangkan agen data kustom berbagi satu batas gabungan 100 QPM per project.
  • API Analisis Percakapan 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 Layanan Pelanggan.

Batasan jenis pertanyaan

  • Conversational Analytics API mendukung pertanyaan yang dapat dijawab dengan 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 deteksi korelasi dan anomali