Dokumen ini menjelaskan cara membuat, mengedit, dan menghapus percakapan di Cloud SQL untuk PostgreSQL. Percakapan adalah chat persisten dengan agen data.
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 membuat diagram jika sesuai. Respons ini mencakup alasan di balik hasilnya.
Anda dapat membuat percakapan dengan agen data. Saat Anda membuat percakapan langsung, the Conversational Analytics API akan menafsirkan pertanyaan Anda tanpa konteks dan petunjuk pemrosesan yang ditawarkan oleh agen data.
Sebelum memulai
-
Pastikan penagihan diaktifkan untuk Google Cloud project Anda.
-
Aktifkan Cloud SQL, Data Analytics API with Gemini, dan Gemini for Google Cloud APIs.
Peran yang diperlukan untuk mengaktifkan API
Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (
roles/serviceusage.serviceUsageAdmin), yang berisi izinserviceusage.services.enable. Pelajari cara memberikan peran.
Peran yang diperlukan
Untuk menggunakan agen data, Anda harus memiliki salah satu peran Identity and Access Management (IAM) Conversational Analytics API berikut:
- Mengkueri data dari sumber database yang didukung menggunakan metode
QueryData: Pengguna Kueri Data Gemini Data Analytics (roles/geminidataanalytics.queryDataUser) di tingkat project. - Membuat, mengedit, membagikan, dan menghapus semua agen data dalam project: Pemilik Agen Data Gemini Data Analytics (
roles/geminidataanalytics.dataAgentOwner) di tingkat project. - Membuat agen data Anda sendiri dalam project: Pembuat Agen Data Gemini Data Analytics (
roles/geminidataanalytics.dataAgentCreator) di tingkat project. Peran ini secara otomatis memberi Anda peran Pemilik Agen Data Gemini Data Analytics pada agen data yang Anda buat. - Melihat dan mengedit semua agen data dalam project: Editor Agen Data Gemini Data Analytics (
roles/geminidataanalytics.dataAgentEditor) di tingkat project. - Melihat semua agen data dalam project: Penampil Agen Data Gemini Data Analytics (
roles/geminidataanalytics.dataAgentViewer) di tingkat project.
Selain itu, Anda harus memiliki peran berikut untuk membuat atau mengedit agen data:
- Akun pengguna atau layanan IAM yang ditambahkan ke instance. Untuk mengetahui informasi selengkapnya, lihat Mengelola pengguna dengan autentikasi database IAM untuk Cloud SQL.
- Peran
cloudsql.studioUserdancloudsql.instanceUseryang diberikan kepada pengguna IAM di tingkat project. Untuk mengetahui informasi selengkapnya, lihat Menambahkan binding kebijakan IAM untuk project. Hak istimewa database yang diberikan kepada akun pengguna atau layanan IAM dengan login sebagai pengguna
postgres.GRANT ALL ON SCHEMA public TO public;Untuk mengetahui informasi selengkapnya, lihat Memberikan hak istimewa database kepada akun pengguna atau layanan IAM.
Saat mengelola akses ke resource database Cloud SQL untuk PostgreSQL, pertimbangkan lapisan izin berikut:
- Google Cloud IAM: mengontrol akses ke instance database sebagai resource cloud. Hal ini mencakup izin untuk terhubung, mengelola instance, dan menjalankan kueri SQL, misalnya, menggunakan izin
executeSql. - Izin database: mengontrol akses ke objek dalam database—seperti tabel, tampilan, dan skema. Izin ini dikelola menggunakan perintah SQL seperti
GRANTdan sistem pengguna serta peran khusus database.
Untuk Cloud SQL untuk PostgreSQL, Anda memerlukan peran IAM Cloud SQL yang sesuai untuk terhubung ke instance dan diizinkan mengirim kueri. Untuk berinteraksi dengan objek seperti tabel dan tampilan, pengguna database yang terhubung harus memiliki hak istimewa yang diperlukan yang diberikan menggunakan sistem GRANT Cloud SQL untuk PostgreSQL.
Untuk mengetahui informasi selengkapnya, lihat
Tentang pengguna dan peran PostgreSQL.
Jika agen menggunakan akun layanan, Anda dapat menetapkan peran database. Misalnya, lihat
Mengelola pengguna dengan autentikasi database IAM.
Membuat percakapan
Anda dapat membuat percakapan persisten dengan agen atau dengan sumber data di Konsol Google Cloud untuk Cloud SQL untuk PostgreSQL dari tab Katalog Agen di halaman Agen.
Membuat 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 oleh orang lain kepada Anda.
Untuk membuat percakapan dengan agen data di Google Cloud Konsol, ikuti langkah-langkah berikut:
Di Google Cloud Konsol, buka halaman Cloud SQL untuk PostgreSQL.
Pilih instance dari daftar.
Di menu navigasi, klik Agen.
Dari bagian Agen saya atau Dibagikan oleh orang lain di organisasi Anda, klik kartu agen yang ingin Anda ajak chat.
Klik Mulai Percakapan. Panel chat baru akan terbuka.
Di kolom Ajukan pertanyaan, masukkan pertanyaan untuk agen data. Misalnya, "Berapa total penjualan kita pada kuartal terakhir?" atau "Tampilkan 5 pengguna teratas berdasarkan waktu sesi." Anda juga dapat mengklik salah satu pertanyaan yang disarankan Gemini untuk memulai.
Agen data akan merespons dengan menyatakan tindakan yang dilakukannya untuk menjawab pertanyaan Anda, lalu agen data akan 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 alasan agen.
Untuk melihat informasi tentang cara hasil dihitung, klik Bagaimana cara menghitungnya? Bagian Ringkasan kini menyertakan kueri yang dibuat, diikuti dengan hasil kueri. Anda dapat menyalin kode, lalu mengklik Studio untuk menempel kode di editor kueri.
Jika sesuai untuk data, agen data akan menyediakan diagram, tabel, dan visualisasi lainnya. Untuk melihat histori chat, buka daftar Pengelolaan Percakapan.
Untuk melihat informasi agen, buka panel Detail. Panel ini mencakup deskripsi agen dan sumber pengetahuannya.
Mengelola percakapan
Anda dapat membuka, mengganti nama, atau menghapus percakapan di halaman Agen.
Membuka percakapan yang ada
Di Google Cloud Konsol, buka halaman Cloud SQL untuk PostgreSQL.
Pilih instance dari daftar.
Di menu navigasi, klik Agen.
Di tab Percakapan, dalam daftar percakapan, klik percakapan yang ingin Anda buka.
Mengganti nama percakapan
Di Google Cloud Konsol, buka halaman Cloud SQL untuk PostgreSQL.
Pilih instance dari daftar.
Di menu navigasi, klik Agen.
Di tab Percakapan, dalam daftar percakapan, klik percakapan yang ingin Anda ganti namanya.
Klik Lihat tindakan > Ganti nama.
Dalam dialog Ganti nama percakapan, masukkan nama baru untuk percakapan di kolom Nama percakapan.
Klik Ganti nama.
Menghapus percakapan
Di Google Cloud Konsol, buka halaman Cloud SQL untuk PostgreSQL.
Pilih instance dari daftar.
Di menu navigasi, klik Agen.
Di tab Percakapan, dalam daftar percakapan, klik percakapan yang ingin Anda hapus.
Klik Lihat tindakan > Hapus.
Dalam 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 Cloud SQL untuk PostgreSQL.
- Pelajari lebih lanjut Conversational Analytics API.
- Buat agen data di Cloud SQL untuk PostgreSQL.