Menganalisis data dengan percakapan

Pratinjau

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 memberikan masukan atau meminta dukungan terkait fitur ini, kirim email ke [e-mail].

Dokumen ini menjelaskan cara membuat, mengedit, dan menghapus percakapan di BigQuery. Percakapan adalah chat persisten dengan agen data atau sumber data, seperti tabel atau tampilan, yang Anda pilih.

Anda dapat mengajukan pertanyaan multi-bagian kepada agen data yang menggunakan istilah umum—misalnya, "penjualan" atau "paling populer"—tanpa menentukan nama kolom tabel, atau menentukan kondisi untuk memfilter data. Respons chat memberikan jawaban atas pertanyaan Anda sebagai teks dan kode, serta menghasilkan gambar dan diagram jika diperlukan. Respons 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 petunjuk pemrosesan yang ditawarkan oleh agen data.

Sebelum memulai

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

2. Enable the BigQuery, Gemini Data Analytics, and Gemini for Google Cloud 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:

• Untuk melihat dan membuat percakapan dengan agen data yang telah dibagikan kepada Anda, Anda harus memiliki peran Pengguna Agen Data Gemini Data Analytics (roles/geminidataanalytics.dataAgentUser) dan peran Pengguna Gemini untuk Google Cloud (roles/cloudaicompanion.user) di tingkat project.
• Untuk membuat percakapan langsung, Anda harus memiliki peran Pengguna Chat Stateless Analisis Data Gemini (roles/geminidataanalytics.dataAgentStatelessUser).

Selain itu, dalam situasi berikut, Anda harus memiliki peran berikut:

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

Jika Anda tidak memiliki peran yang sesuai pada tabel data sumber yang digunakan oleh agen data, sistem akan menampilkan error berikut saat Anda memulai percakapan dengan agen data:

Schema_Resolution: Access Denied

Praktik terbaik

Saat menggunakan analisis percakapan, kueri akan otomatis dijalankan untuk menjawab pertanyaan Anda. Anda mungkin dikenai biaya yang tidak terduga dalam kasus berikut:

• Jika tabel Anda besar
• Jika kueri menggunakan gabungan data
• Jika kueri melakukan banyak panggilan ke fungsi AI

Untuk mencegah masalah ini, pertimbangkan ukuran saat memilih sumber pengetahuan, dan saat melakukan percakapan, pertimbangkan untuk menggunakan gabungan.

Membuat percakapan

Anda dapat membuat percakapan persisten dengan agen atau dengan sumber data di konsol BigQuery dengan cara berikut: Google Cloud

• Dari tab Agent Catalog di halaman Agents.
• Saat Anda melihat tabel atau hasil kueri.
• Saat sistem otomatis menggunakan sumber data yang Anda pilih untuk percakapan. Praktik ini berguna untuk pertanyaan cepat dan sekali pakai tentang tabel tertentu.

Memulai percakapan dengan agen data

Untuk membuat percakapan dengan agen data, Anda harus membuat agen data dan memublikasikannya terlebih dahulu. Anda juga dapat memulai percakapan dengan agen yang dibagikan orang lain kepada Anda.

Untuk membuat percakapan dengan agen data di konsol Google Cloud , pilih salah satu opsi berikut:

Halaman agen

1. Buka halaman Agen BigQuery.

   Buka Agen

2. Pilih tab Katalog Agen.

3. Dari bagian Agen saya atau Dibagikan oleh orang lain di organisasi Anda, klik kartu agen yang ingin Anda ajak chat.

4. Klik Mulai Percakapan. Panel chat baru akan terbuka.

5. Di kolom Ajukan pertanyaan, masukkan pertanyaan untuk agen data. Misalnya, "Berapa total penjualan kita pada kuartal terakhir?" atau "Tampilkan 5 pengguna teratas menurut durasi sesi". Anda juga dapat mengklik salah satu pertanyaan yang disarankan Gemini untuk memulai.

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

   Untuk melihat setiap langkah yang dilakukan agen data untuk memberikan jawaban atas pertanyaan Anda, klik Tampilkan alasan untuk melihat setiap pesan dalam proses penalaran agen.

   

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

   Bagian Ringkasan kini menyertakan kueri yang dihasilkan diikuti dengan hasil kueri. Anda dapat membuka kode di editor kueri jika perlu.

   

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

   Untuk melihat histori chat Anda, lihat daftar Pengelolaan Percakapan.

   Untuk melihat informasi agen, lihat panel Detail Agen. Panel ini mencakup deskripsi agen dan sumber pengetahuannya.

Editor BigQuery

1. Saat Anda bekerja dengan tabel, atau menjalankan kueri, klik tombol Buat percakapan di panel menu untuk membuat percakapan baru.

2. Di kolom Ajukan pertanyaan, masukkan pertanyaan untuk agen data. Misalnya, "Berapa total penjualan kita pada kuartal terakhir?" atau "Tampilkan 5 pengguna teratas menurut durasi sesi". Anda juga dapat mengklik salah satu pertanyaan yang disarankan Gemini untuk memulai.

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

   Untuk melihat setiap langkah yang dilakukan agen data untuk memberikan jawaban atas pertanyaan Anda, klik Tampilkan alasan untuk melihat setiap pesan dalam proses penalaran agen.

   

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

   Bagian Ringkasan kini menyertakan kueri yang dihasilkan diikuti dengan hasil kueri. Anda dapat membuka kode di editor kueri jika perlu.

   

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

   Untuk melihat histori chat Anda, lihat daftar Pengelolaan Percakapan.

   Untuk melihat informasi agen, lihat panel Detail Agen. Panel ini mencakup deskripsi agen dan sumber pengetahuannya.

Membuat percakapan langsung dengan sumber data

Untuk membuat percakapan dengan sumber data di konsol Google Cloud , pilih salah satu opsi berikut:

Halaman agen

Untuk memulai percakapan langsung dengan sumber data dari halaman Agen, ikuti langkah-langkah berikut:

1. Buka halaman Agen BigQuery.

   Buka 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, masukkan pertanyaan untuk 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 Tampilkan alasan untuk melihat setiap pesan dalam proses penalaran API.

   

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

   Bagian Ringkasan kini menyertakan kueri yang dibuat, diikuti dengan hasil kueri. Secara opsional, Anda dapat membuka kueri di editor kueri.

   

   Jika sesuai untuk data, respons akan memberikan gambar, diagram, tabel, dan visualisasi lainnya.

Editor BigQuery

1. Saat Anda bekerja dengan tabel, atau menjalankan kueri, klik tombol Buat percakapan di panel menu untuk membuat percakapan baru.

2. Di kolom Ajukan pertanyaan, masukkan pertanyaan untuk 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 Tampilkan alasan.

   Untuk melihat setiap langkah yang dilakukan agen data untuk memberikan jawaban atas pertanyaan Anda, klik Tampilkan alasan. Dari daftar, dan lihat setiap pesan dalam proses penalaran agen.

   

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

   Bagian Ringkasan kini menyertakan kueri yang dihasilkan, diikuti dengan hasil kueri. Secara opsional, Anda dapat membuka kueri di editor kueri.

   

   Jika sesuai untuk data, respons akan memberikan gambar, diagram, tabel, dan visualisasi lainnya.

Membuat agen data dari percakapan

1. Dari dalam panel Data percakapan, di bagian Tindakan Cepat, klik Buat Agen.
2. Ikuti langkah-langkah untuk membuat agen.

Mengelola percakapan

Anda dapat membuka, mengganti nama, atau menghapus percakapan di halaman Agen, dan mengelola percakapan di BigQuery Studio Explorer.

Membuka percakapan yang ada

1. Di konsol Google Cloud , buka halaman Agen BigQuery.

   Buka Agen

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

Mengganti nama percakapan

1. Di konsol Google Cloud , buka halaman Agen BigQuery.

   Buka 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, masukkan nama baru untuk percakapan di kolom Nama percakapan.

5. Klik Ganti nama.

Menghapus percakapan

1. Di konsol Google Cloud , buka halaman Agen BigQuery.

   Buka Agen

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

3. Klik Lihat tindakan > Hapus.

4. Pada dialog Hapus percakapan?, klik Hapus.

Mengelola percakapan menggunakan BigQuery Studio Explorer

Mengelola percakapan menggunakan BigQuery Studio Explorer. Daftar percakapan ini menyediakan tempat terpusat untuk menelusuri, membuka, atau membuat percakapan. Anda juga dapat menyalin ID percakapan atau memuat ulang daftar percakapan.

Untuk mengelola percakapan Anda, ikuti langkah-langkah berikut:

1. Buka halaman BigQuery Studio Explorer.

   Buka Explorer

2. Di panel Explorer, luaskan nama project.

3. Klik Percakapan.

   1. Untuk memfilter daftar percakapan, masukkan nama atau nilai properti di kolom filter.
   2. Untuk membuka percakapan, klik Lihat tindakan > Buka.
   3. Untuk menyalin ID percakapan, klik Lihat tindakan > Salin ID.
   4. Untuk membuat percakapan, di panel menu, klik Buat percakapan.
   5. Untuk memuat ulang daftar, di panel menu, klik Muat ulang.

Lokasi

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

Langkah berikutnya

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