Menganalisis data dengan percakapan

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 hasil tersebut.

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

  1. Pastikan penagihan diaktifkan untuk Google Cloud project Anda.

  2. 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 izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Admin Penggunaan Layanan (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.

    Aktifkan API

Peran yang diperlukan

Untuk menggunakan agen data, Anda harus memiliki izin IAM yang sesuai dengan kasus penggunaan Anda. Tabel berikut mencantumkan peran yang diperlukan berdasarkan apakah Anda membuat dan memublikasikan agen, menyediakan agen di Gemini Enterprise, atau menemukan dan menggunakan agen. Untuk mengetahui informasi selengkapnya, lihat Peran IAM Conversational Analytics API roles.

Kasus penggunaan Peran yang diperlukan
Membuat, mengedit, memublikasikan, membagikan, dan menghapus agen
  • Untuk membuat agen data dalam project: Gemini Data Analytics Data Agent Creator (roles/geminidataanalytics.dataAgentCreator) di project. Peran ini secara otomatis memberi Anda peran Gemini Data Analytics Data Agent Owner pada agen data yang Anda buat.
  • Untuk mengedit, membagikan, atau menghapus agen data: Gemini Data Analytics Data Agent Owner (roles/geminidataanalytics.dataAgentOwner) di agen atau project.
  • Untuk mengedit agen data dalam project: Gemini Data Analytics Data Agent Editor (roles/geminidataanalytics.dataAgentEditor) di project.
  • Untuk melihat agen data dalam project: Gemini Data Analytics Data Agent Viewer (roles/geminidataanalytics.dataAgentViewer) di project.
  • Selain itu, Anda harus memiliki peran berikut untuk membuat atau mengedit agen data:
Menyediakan agen di Gemini Enterprise

Agar agen yang dipublikasikan tersedia untuk pengguna di Gemini Enterprise, Anda memerlukan izin untuk mendaftarkan dan mengelola agen A2A di konsol administrasi Gemini Enterprise.
Menemukan dan menggunakan agen
  • Untuk melakukan chat dengan agen data: Gemini Data Analytics Data Agent User (roles/geminidataanalytics.dataAgentUser).
  • Untuk melihat semua agen data dalam project: Gemini Data Analytics Data Agent Viewer (roles/geminidataanalytics.dataAgentViewer).

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 GRANT dan 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 untuk 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 Agent Catalog di halaman Agents.

Membuat percakapan dengan agen data

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

Untuk membuat percakapan dengan agen data di Google Cloud Konsol, ikuti langkah-langkah berikut:

  1. Di Google Cloud Konsol, buka halaman Cloud SQL untuk PostgreSQL.

    Buka Cloud SQL

  2. Pilih instance dari daftar.

  3. Di menu navigasi, klik Agents.

  4. Dari bagian My agents atau Shared by others in your organization, klik kartu agen yang ingin Anda ajak chat.

  5. Klik Start a Conversation. Panel chat baru akan terbuka.

  6. Di kolom Ask a question, 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 diambil untuk menjawab pertanyaan Anda, lalu agen data akan menampilkan hasilnya.

    Untuk melihat setiap langkah yang diambil agen data untuk memberikan jawaban atas pertanyaan Anda, klik Show reasoning untuk melihat setiap pesan dalam proses penalaran agen.

    Untuk melihat informasi tentang cara hasil dihitung, klik Bagaimana ini dihitung? Bagian Summary 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 Conversation Management.

    Untuk melihat informasi agen, buka panel Details. Panel ini mencakup deskripsi agen dan sumber pengetahuannya.

Mengelola percakapan

Anda dapat membuka, mengganti nama, atau menghapus percakapan di halaman Agents.

Membuka percakapan yang ada

  1. Di Google Cloud Konsol, buka halaman Cloud SQL untuk PostgreSQL.

    Buka Cloud SQL

  2. Pilih instance dari daftar.

  3. Di menu navigasi, klik Agents.

  4. Di tab Conversations, dalam daftar percakapan, klik percakapan yang ingin Anda buka.

Mengganti nama percakapan

  1. Di Google Cloud Konsol, buka halaman Cloud SQL untuk PostgreSQL.

    Buka Cloud SQL

  2. Pilih instance dari daftar.

  3. Di menu navigasi, klik Agents.

  4. Di tab Conversations, dalam daftar percakapan, klik percakapan yang ingin Anda ganti namanya.

  5. Klik View actions > Rename.

  6. Di dialog Rename conversation, masukkan nama baru untuk percakapan di kolom Conversation name.

  7. Klik Rename.

Menghapus percakapan

  1. Di Google Cloud Konsol, buka halaman Cloud SQL untuk PostgreSQL.

    Buka Cloud SQL

  2. Pilih instance dari daftar.

  3. Di menu navigasi, klik Agents.

  4. Di tab Conversations, dalam daftar percakapan, klik percakapan yang ingin Anda hapus.

  5. Klik View actions > Delete.

  6. Di dialog Delete conversation?, klik Delete.

Lokasi

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

Langkah berikutnya