Menganalisis data dengan percakapan

Dokumen ini menjelaskan cara membuat, mengedit, dan menghapus percakapan di Spanner. 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 dalam bentuk teks dan kode, serta membuat diagram jika diperlukan. Respons mencakup alasan di balik hasil.

Anda dapat membuat percakapan dengan agen data. Saat Anda membuat percakapan langsung, Conversational Analytics API menafsirkan pertanyaan Anda tanpa konteks dan petunjuk pemrosesan yang ditawarkan oleh agen data.

Sebelum memulai

  1. Verifikasi bahwa penagihan diaktifkan untuk project Google Cloud Anda.

  2. Aktifkan Spanner, Data Analytics API with Gemini, dan Gemini for Google Cloud APIs, jika ada yang belum diaktifkan.

    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 Identity and Access Management Conversational Analytics API.

Kasus penggunaan Peran yang diperlukan
Membuat, mengedit, memublikasikan, membagikan, dan menghapus agen
  • Untuk membuat agen data dalam project: Pembuat Agen Data Analytics Gemini (roles/geminidataanalytics.dataAgentCreator) di project. Peran ini secara otomatis memberi Anda peran Pemilik Agen Data Gemini Data Analytics di agen data yang Anda buat.
  • Untuk mengedit, membagikan, atau menghapus agen data: Pemilik Agen Data Analisis Data Gemini (roles/geminidataanalytics.dataAgentOwner) di agen atau project.
  • Untuk mengedit agen data dalam project: Editor Agen Data Analisis Data Gemini (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:
    • Akun pengguna atau layanan IAM ditambahkan ke cluster. Untuk mengetahui informasi selengkapnya, lihat Menerapkan peran IAM.
    • Peran spanner.databaseReader yang diberikan kepada pengguna IAM di tingkat project. Untuk mengetahui informasi selengkapnya, lihat Menambahkan binding kebijakan IAM untuk project.
    • Peran dan izin yang diberikan kepada pengguna IAM di tingkat project untuk database yang diperlukan. Untuk mengetahui informasi selengkapnya, lihat Memberikan peran dan izin.
Menyediakan agen di Gemini Enterprise

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

Untuk menggunakan resource Spanner, lihat Peran dan izin Spanner.

Membuat percakapan

Anda dapat membuat percakapan persisten dengan agen atau dengan sumber data di konsol Google Cloud untuk Spanner dari tab Agent Catalog di halaman Agents.

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 orang lain kepada Anda.

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

  1. Di konsol Google Cloud , buka halaman Spanner.

    Buka Spanner

  2. Pilih instance dari daftar, lalu pilih database.

  3. Di menu navigasi, klik Agen.

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

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

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

    Agen data akan merespons dengan menyatakan tindakan yang diambilnya 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 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 menyalin kode, lalu mengklik Studio untuk menempelkan kode di editor kueri.

    Jika sesuai untuk data, agen data akan menyediakan diagram, tabel, dan visualisasi lainnya. Untuk melihat histori percakapan Anda, 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

  1. Di konsol Google Cloud , buka halaman Spanner.

    Buka Spanner

  2. Pilih instance dari daftar, lalu pilih database.

  3. Di menu navigasi, klik Agen.

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

Mengganti nama percakapan

  1. Di konsol Google Cloud , buka halaman Spanner.

    Buka Spanner

  2. Pilih instance dari daftar, lalu pilih database.

  3. Di menu navigasi, klik Agen.

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

  5. Klik Lihat tindakan > Ganti nama.

  6. Dalam dialog Ganti nama percakapan, masukkan nama baru untuk percakapan di kolom Nama percakapan.

  7. Klik Ganti nama.

Menghapus percakapan

  1. Di konsol Google Cloud , buka halaman Spanner.

    Buka Spanner

  2. Pilih instance dari daftar, lalu pilih database.

  3. Di menu navigasi, klik Agen.

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

  5. Klik Lihat tindakan > Hapus.

  6. Pada dialog Hapus percakapan?, klik Hapus.

Lokasi

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

Langkah berikutnya