Pertanyaan umum (FAQ) tentang Conversational Analytics API

Dapatkah Conversational Analytics API mengubah atau menghapus data saya?

Conversational Analytics API dirancang dengan pengamanan untuk mencegah perubahan atau penghapusan data Anda.

Berikut cara penanganan keamanan data untuk berbagai sumber data:

  • BigQuery: API memblokir pernyataan Bahasa Definisi Data (DDL) dan Bahasa Pengolahan Data (DML). Secara khusus, sistem menjalankan uji coba pada SQL yang dibuat dan hanya mengizinkan kueri jenis SELECT.
  • Looker: API berinteraksi dengan Looker menggunakan metode seperti run_inline_query, yang dibatasi untuk operasi baca seperti pilihan, filter, dan batas. Metode ini tidak mendukung operasi DDL atau DML dan tidak mencakup operasi penghapusan atau pelepasan.
  • Looker Studio (untuk CSV dan Google Spreadsheet): Looker Studio menggunakan format terstruktur untuk menentukan dan mengambil data untuk visualisasi dan laporan. Semua kueri yang dijalankan dengan metode ini bersifat hanya baca dan tidak mendukung mutasi data.

Conversational Analytics API dirancang agar hanya dapat dibaca di seluruh sumber data ini.

Bagaimana cara menangani error autentikasi dan izin?

Berikut adalah beberapa error umum terkait autentikasi dan izin yang mungkin Anda alami saat menggunakan Conversational Analytics API:

  1. Error: PERMISSION_DENIED atau 403 Write access to project ... was denied

    • Kemungkinan Penyebab: Pesan ini sering menunjukkan masalah pada Google Cloud peran IAM. Pengguna atau akun layanan yang mencoba menggunakan API tidak memiliki izin yang diperlukan di project Google Cloud .
    • Pemecahan masalah:
      • Google Cloud Pemilik project harus memastikan bahwa akun pengguna atau akun layanan memiliki peran IAM yang benar yang ditetapkan dalam Google Cloud project. Peran seperti Project Editor mungkin diperlukan untuk operasi tertentu, seperti mengaktifkan API atau menguji fungsinya.
      • Jika Anda mengalami error 403 seperti Write access to project 'us-gcp-project-name' was denied saat beralih region, verifikasi konfigurasi IAM project Anda.

  2. Error: 500 Internal Server Error saat pengguna Looker dengan peran Pengguna mencoba memulai percakapan dengan agen data.

Apa saja persyaratan Looker untuk menggunakan Conversational Analytics API?

Untuk menggunakan Conversational Analytics API, Anda memerlukan izin yang sesuai di Google Cloud IAM dan dalam Looker, bergantung pada sumber data dan tindakan yang ingin Anda lakukan:

  1. Google Cloud Peran IAM:

    • Anda memerlukan peran IAM yang memadai di project Google Cloud untuk berinteraksi dengan geminidataanalytics.googleapis.com API. Peran IAM yang salah dikonfigurasi sering kali menyebabkan error PERMISSION_DENIED.
    • Peran khusus yang diperlukan dapat bergantung pada tindakan, tetapi peran umum seperti Editor Project mungkin diperlukan untuk operasi tertentu.

  2. Izin dan peran Looker:

    • Izin tingkat model: Untuk menggunakan Analisis Konversasional dan API Analisis Konversasional, pengguna Looker harus diberi peran yang berisi izin gemini_in_looker untuk model yang berinteraksi dengannya.

Untuk mempelajari lebih lanjut izin dan peran yang diperlukan untuk menggunakan Conversational Analytics API, lihat halaman dokumentasi Memberikan peran dan izin IAM Conversational Analytics API untuk mengetahui informasi selengkapnya.

Selain itu, instance Looker Anda harus memenuhi persyaratan tertentu:

Untuk menggunakan Conversational Analytics API dengan Looker Studio Pro, langganan Pro Anda harus berada di luar perimeter VPC-SC.

Bagaimana cara bermigrasi dari Data QnA API ke Conversational Analytics API?

Jika Anda menggunakan Data QnA API versi lama yang masih dalam tahap eksperimental (dataqna.googleapis.com), lihat panduan migrasi untuk mengetahui cara bermigrasi ke endpoint resmi baru untuk Conversational Analytics API (geminidataanalytics.googleapis.com).

Apa perbedaan antara nama agen data dan ID-nya?

ID agen data, yang ditentukan sebagai nilai untuk data_agent_id, adalah ID unik untuk agen data. Nama agen data, data_agent.name, diturunkan secara otomatis dari data_agent_id sebagai nama yang sepenuhnya memenuhi syarat (FQN), yang berbentuk projects/<project>/locations/<location>/dataAgents/<data_agent_id>.

Saat membuat agen data, nilai apa pun yang mungkin telah Anda masukkan untuk data_agent.name akan diabaikan. Saat melakukan operasi get, update, atau delete, data_agent.name lengkap diperlakukan sebagai ID unik agen data.

Saat menggunakan Conversational Analytics API untuk membuat agen data, skenario berikut berlaku:

  • Jika Anda tidak menentukan data_agent_id, ID unik akan dibuat secara otomatis.
  • Jika Anda menentukan data_agent_id sebagai, misalnya, TestID, nilai apa pun yang mungkin telah Anda masukkan untuk data_agent.name akan digantikan dengan projects/<project>/locations/<location>/dataAgents/TestID.
  • Jika Anda menentukan data_agent_id dengan FQN, Anda akan menerima error "nama salah bentuk".

Apa kemampuan memori agen data Conversational Analytics API?

  • Dalam satu sesi: Conversational Analytics API mendukung percakapan multi-giliran, yang berarti API ini dapat mereferensikan bagian sebelumnya dari percakapan saat ini.
  • Di beberapa sesi: Conversational Analytics API menyertakan fitur untuk histori percakapan terkelola, yang memungkinkan pengguna melakukan percakapan di beberapa sesi. Solusi ini juga mendukung agen berstatus dengan percakapan multi-giliran yang dikelola Google.
  • Memori jangka panjang: Agen data Conversational Analytics API tidak mendukung kemampuan memori jangka panjang yang eksplisit.

Apakah agen data Conversational Analytics API akan memberikan jawaban yang sama setiap kali saya mengajukan pertanyaan yang sama?

  • Respons bahasa alami dari agen data Conversational Analytics API tidak deterministik, sehingga jawaban bahasa alami yang diberikan oleh agen dapat bervariasi meskipun untuk pertanyaan yang kata-katanya identik.
  • Respons kueri data: Namun, untuk pertanyaan tertentu yang mencari data, kueri yang dibuat di bawahnya (kueri SQL atau Looker) diharapkan bersifat deterministik. Data yang diambil harus sama, dengan asumsi bahwa data pokok tidak berubah.

Bagaimana cara meningkatkan akurasi respons dari agen data Conversational Analytics API?

Salah satu cara untuk meningkatkan akurasi respons agen data adalah dengan memberikan informasi kontekstual yang kuat kepada agen data. Anda dapat menambahkan konteks dengan cara berikut:

  • Di lapisan semantik Looker, Anda dapat memberikan konteks dalam definisi LookML. Untuk mengetahui informasi dan contoh selengkapnya, lihat halaman dokumentasi Memandu perilaku agen dengan konteks yang dibuat di Looker.
  • Saat membuat agen data, Anda dapat memberikan petunjuk sistem, yang merupakan panduan yang ditentukan pengguna yang dapat membentuk perilaku agen data. Panduan ini mencakup logika khusus bisnis, pemformatan respons, atau presentasi data. Anda juga dapat memberikan "kueri emas", yaitu contoh pertanyaan bahasa alami yang dipasangkan dengan kueri SQL atau Looker yang benar. Untuk mengetahui informasi selengkapnya tentang petunjuk sistem, lihat halaman dokumentasi Memandu perilaku agen dengan konteks yang dibuat.

Dapatkah saya mengintegrasikan Conversational Analytics API dengan aplikasi pihak ketiga?

Dengan mengintegrasikan Conversational Analytics API dengan aplikasi pihak ketiga, pengguna dapat berinteraksi dengan data mereka secara langsung dalam alat yang mereka gunakan setiap hari.

Setiap aplikasi pihak ketiga yang berinteraksi dengan endpoint API geminidataanalytics.googleapis.com harus dapat mengirim pesan pengguna dari aplikasi ke agen dan menampilkan respons.

Untuk membuat integrasi, lihat repositori Panduan Memulai Analytics Percakapan untuk mengetahui contoh atau library. Anda juga dapat membuka Forum Developer Google untuk menelusuri contoh dari pengguna lain.

Berapa biaya Conversational Analytics API?

Conversational Analytics API berada dalam fase Pratinjau, dan Google tidak mengenakan biaya untuk produk dalam Pratinjau. Kami akan memberikan pemberitahuan awal tentang perubahan harga di masa mendatang.

Sumber data apa yang didukung Conversational Analytics API?

Conversational Analytics API mendukung sumber data berikut:

  • BigQuery
  • Eksplorasi Looker
  • Looker Studio

Anda juga dapat terhubung ke sumber seperti SAP dan Salesforce melalui BigQuery, serta ke CSV dan Google Spreadsheet melalui Looker Studio.

Apa saja batasan yang diketahui dari Conversational Analytics API?

Untuk mempelajari lebih lanjut batasan umum Conversational Analytics API, lihat halaman dokumentasi Batasan umum Conversational Analytics API.

Kuota apa yang perlu saya ketahui untuk Google Cloud proyek?

Tidak ada batasan pada Google Cloud pemilihan atau lokasi project. Anda dapat membuat agen data untuk membuat kueri sumber data yang didukung yang termasuk dalam project atau region mana pun.

Apakah Conversational Analytics API mendukung regionalisasi data?

Karena Conversational Analytics API belum mendukung residensi data (DRZ) atau perimeter kontrol layanan (VPC-SC), Anda belum dapat menghosting agen di wilayah geografis tertentu. Regionalisasi data tidak didukung.

Apakah Conversational Analytics API mendukung bahasa selain bahasa Inggris?

Satu-satunya bahasa yang didukung secara resmi untuk Conversational Analytics API adalah Inggris. Meskipun model Gemini yang mendasarinya mendukung banyak bahasa, dan beberapa pengguna telah melaporkan keberhasilan anekdotal dengan kueri non-Inggris, Conversational Analytics API tidak secara resmi mendukung bahasa selain bahasa Inggris.