Menganalisis data dengan percakapan

Akses awal

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Catatan: Untuk mendaftar ke akses awal analisis percakapan, isi formulir permintaan. Untuk meminta dukungan atau memberikan masukan terkait fitur ini, kirim email ke [e-mail].

Gunakan dokumen ini untuk mempelajari cara membuat, mengedit, dan menghapus percakapan di BigQuery. Percakapan adalah chat pengguna yang persisten dengan agen data atau sumber data. Pengguna dapat mengajukan pertanyaan multi-bagian kepada agen data yang menggunakan istilah umum seperti "penjualan" atau "paling populer", tanpa harus menentukan nama kolom tabel, atau menentukan kondisi untuk memfilter data. Respons chat yang dikembalikan kepada pengguna memberikan jawaban atas pertanyaan pengguna sebagai teks dan kode, serta membuat diagram jika sesuai. Respons juga mencakup alasan di balik hasilnya.

Anda dapat membuat percakapan dengan agen data, atau percakapan langsung dengan satu atau beberapa tabel. Saat Anda membuat percakapan langsung, Conversational Analytics API menafsirkan pertanyaan Anda tanpa konteks dan memproses petunjuk yang diberikan oleh agen data.

Sebelum memulai

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

2. Verify that billing is enabled for your Google Cloud project.

3. Enable the BigQuery, Gemini Data Analytics, and Gemini for Google Cloud API APIs.

   Roles required to enable APIs

   To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

   Enable the APIs

Peran yang diperlukan

Untuk membuat percakapan, Anda harus memiliki salah satu peran IAM Conversational Analytics API berikut:

• Melihat dan membuat percakapan dengan agen data yang telah dibagikan kepada Anda: Pengguna Agen Data Analisis Data Gemini (roles/geminidataanalytics.dataAgentUser) di tingkat project.
• Memulai percakapan langsung: Pengguna Gemini Data Analytics Stateless Chat (roles/geminidataanalytics.dataAgentStatelessUser)

Selain itu, setiap pengguna yang membuat percakapan harus memiliki peran berikut:

• BigQuery Data Viewer (roles/bigquery.dataViewer) pada tabel apa pun yang digunakan agen data sebagai sumber data.
• Jika tabel sumber data menggunakan kontrol akses tingkat kolom, Pembaca Terperinci (roles/datacatalog.categoryFineGrainedReader) pada tag kebijakan yang sesuai. Untuk mengetahui informasi selengkapnya, lihat Peran yang digunakan dengan kontrol akses tingkat kolom.
• Jika tabel sumber data menggunakan kontrol akses tingkat baris, Anda harus diberi kebijakan akses tingkat peran pada tabel tersebut. Untuk mengetahui informasi selengkapnya, lihat Membuat atau memperbarui kebijakan akses tingkat baris.
• Jika tabel sumber data menggunakan penyamaran data, Masked Reader (roles/bigquerydatapolicy.maskedReader) pada kebijakan data yang sesuai. Untuk mengetahui informasi selengkapnya, lihat Peran untuk membuat kueri data yang disamarkan.

Jika pengguna percakapan tidak memiliki peran yang sesuai pada tabel data sumber yang digunakan oleh agen data, error berikut akan ditampilkan saat pengguna melakukan percakapan dengan agen data:

Schema_Resolution: Access Denied

Memulai percakapan dengan agen data

Gunakan langkah-langkah berikut untuk memulai percakapan dengan agen data. Anda harus membuat agen data sebelum dapat memulai percakapan dengan agen data tersebut.

1. Buka halaman Agen BigQuery.

   Buka halaman Agen

2. Di tab Percakapan, di panel Chat dengan data Anda, klik kartu agen data yang ingin Anda ajak chat. Halaman percakapan akan terbuka.

3. Di kolom Ajukan pertanyaan, ketik pertanyaan yang ingin Anda jawab oleh agen data. Anda juga dapat mengklik salah satu pertanyaan yang disarankan Gemini untuk memulai.

   Agen data akan merespons, menyatakan tindakan yang diambil untuk menjawab pertanyaan Anda, lalu menampilkan hasilnya.

   Untuk melihat langkah-langkah yang dilakukan agen data, klik Lihat langkah-langkah.

   Untuk melihat informasi tentang cara penghitungan hasil, klik Bagaimana cara penghitungannya?:

   

   Tab Text menjelaskan kode yang dihasilkan, dan tab Code memberikan kode yang dihasilkan:

   

   Jika sesuai untuk data, agen data juga menyediakan diagram, tabel, dan visualisasi lainnya.

Membuat percakapan langsung dengan sumber data

Ikuti langkah-langkah berikut untuk membuat percakapan langsung dengan sumber data:

1. Buka halaman Agen BigQuery.

   Buka halaman Agen

2. Di tab Percakapan, di panel Mulai chat dengan data Anda, klik Sumber data.

3. Pilih satu atau beberapa tabel, lalu klik Buat Percakapan.

4. Di kolom Ajukan pertanyaan, ketik pertanyaan yang ingin Anda jawab oleh agen data. Anda juga dapat mengklik salah satu pertanyaan yang disarankan Gemini untuk memulai.

   Conversational Analytics API memproses pertanyaan Anda dan menampilkan hasilnya.

   Untuk melihat langkah-langkah yang dilakukan Conversational Analytics API, klik Lihat langkah-langkah.

   Untuk melihat informasi tentang cara penghitungan hasil, klik Bagaimana cara penghitungannya?:

   

   Tab Text menjelaskan kode yang dihasilkan, dan tab Code memberikan kode yang dihasilkan:

   

Membuka percakapan yang ada

Ikuti langkah-langkah berikut untuk membuka percakapan:

1. Buka halaman Agen BigQuery.

   Buka halaman Agen

2. Di tab Percakapan, dalam daftar percakapan, klik percakapan yang ingin Anda buka.

Mengganti nama percakapan

Ikuti langkah-langkah berikut untuk mengganti nama percakapan:

1. Buka halaman Agen BigQuery.

   Buka halaman Agen

2. Di tab Percakapan, dalam daftar percakapan, klik percakapan yang ingin Anda ganti namanya.

3. Klik Lihat tindakan > Ganti nama.

4. Dalam dialog Ganti nama percakapan, ketik nama baru untuk percakapan di kolom Nama percakapan.

5. Klik Ganti nama.

Menghapus percakapan

Ikuti langkah-langkah berikut untuk menghapus percakapan:

1. Buka halaman Agen BigQuery.

   Buka halaman Agen

2. Di tab Percakapan, dalam daftar percakapan, klik percakapan yang ingin Anda ganti namanya.

3. Klik Lihat tindakan > Hapus.

4. Pada dialog Hapus percakapan?, klik Hapus.

Lokasi

Analisis percakapan beroperasi secara global, Anda tidak dapat memilih region yang akan digunakan.

Langkah berikutnya

• Pelajari lebih lanjut Analisis percakapan di BigQuery.
• Pelajari lebih lanjut Conversational Analytics API.
• Buat agen data.