Membuat agen data

Agen data percakapan memungkinkan Anda berinteraksi dengan data database menggunakan antarmuka bahasa alami. Dengan membuat agen ini, Anda membantu pengguna "berbicara dengan data mereka", sehingga mereka dapat memperoleh insight dari database operasional tanpa harus menulis kueri SQL yang kompleks.

Secara umum, agen data adalah kombinasi persona, sekumpulan sumber data, dengan akses ke sekumpulan pengetahuan bisnis yang penting untuk tujuannya.

Untuk developer aplikasi, agen ini memberikan manfaat berikut:

  • Akurasi tinggi: dengan menggunakan konteks yang dibuat, Anda dapat mencapai akurasi tinggi untuk pertanyaan bisnis tertentu. Konteks yang dibuat adalah faktor kunci utama yang dapat digunakan pembuat agen untuk meningkatkan akurasi. Bagian ini mencakup deskripsi skema, petunjuk sistem, dan konteks terstruktur yang memberikan informasi tambahan tentang kueri database yang diharapkan.
  • Kompleksitas yang lebih rendah: agen menerjemahkan bahasa alami ke dalam kueri, eksekusi, dan bahkan perangkuman atau visualisasi data SQL.
  • Fleksibilitas: Anda dapat membuat draf agen untuk pengujian pribadi, atau Anda dapat memublikasikannya agar tersedia bagi pengguna lain dalam project atau secara terprogram menggunakan API.

Sebelum memulai

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

  2. Aktifkan Cloud SQL, Data Analytics API with Gemini, dan Gemini for Google Cloud API.

    Peran yang diperlukan untuk mengaktifkan API

    Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), yang berisi izin serviceusage.services.enable. Pelajari cara memberikan peran.

    Aktifkan API

Peran yang diperlukan

Untuk menggunakan agen data, Anda harus memiliki salah satu peran Identity and Access Management (IAM) Conversational Analytics API berikut:

  • Buat kueri data dari sumber database yang didukung menggunakan metode QueryData: Pengguna Kueri Data Analisis Data Gemini (roles/geminidataanalytics.queryDataUser) di tingkat project.
  • Membuat, mengedit, membagikan, dan menghapus semua agen data dalam project: Pemilik Agen Data Analisis Data Gemini (roles/geminidataanalytics.dataAgentOwner) di tingkat project.
  • Buat agen data Anda sendiri dalam project: Pembuat Agen Data Analisis Data Gemini (roles/geminidataanalytics.dataAgentCreator) di tingkat project. Peran ini secara otomatis memberi Anda peran Pemilik Agen Data Gemini Data Analytics di agen data yang Anda buat.
  • Melihat dan mengedit semua agen data dalam project: Editor Agen Data Analisis Data Gemini (roles/geminidataanalytics.dataAgentEditor) di tingkat project.
  • Melihat semua agen data dalam project: Pelihat Agen Data Analisis Data Gemini (roles/geminidataanalytics.dataAgentViewer) di tingkat project.

Selain itu, Anda harus memiliki peran berikut untuk membuat atau mengedit agen data:

Saat mengelola akses ke resource database Cloud SQL untuk PostgreSQL, pertimbangkan tingkatan izin berikut:

  • Google Cloud IAM: mengontrol akses ke instance database sebagai resource cloud. Hal ini mencakup izin untuk terhubung, mengelola instance, dan mengeksekusi kueri SQL, misalnya, menggunakan izin executeSql.
  • Izin database: mengontrol akses ke objek dalam database—seperti tabel, tampilan, dan skema. Pengguna dan peran ini dikelola menggunakan perintah SQL seperti GRANT serta sistem pengguna dan peran khusus database.

Untuk Cloud SQL untuk PostgreSQL, Anda memerlukan peran IAM Cloud SQL yang sesuai untuk terhubung ke instance dan diberi otorisasi 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 agen data

Bagian berikut menjelaskan cara membuat agen data. Setelah membuat agen, Anda dapat mengedit setelannya.

Mengonfigurasi dasar-dasar

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

    Buka Cloud SQL

  2. Pilih instance dari daftar.

  3. Di menu navigasi, klik Agen.

  4. Klik tab Agen.

  5. Pilih database dan login menggunakan akun IAM Anda.

  6. Klik Agen baru. Halaman New agent akan terbuka.

  7. Di bagian Editor, di kolom Nama agen, masukkan nama deskriptif untuk agen data—misalnya, Q4 sales data atau User activity logs.

  8. Di kolom Deskripsi agen, masukkan deskripsi agen data. Deskripsi yang baik menjelaskan apa yang dilakukan agen, data apa yang digunakannya, dan membantu Anda menentukan apakah agen data ini adalah agen yang tepat untuk digunakan dalam percakapan—misalnya, What are the top 10 selling products in Q2?

  9. Di bagian Sumber pengetahuan, klik Tambahkan sumber. Halaman Tambahkan data akan terbuka.

  10. Pilih tabel yang akan difokuskan agen saat menjawab pertanyaan. Untuk melihat sumber pengetahuan tambahan, pilih Tampilkan lebih banyak.

  11. Klik Tambahkan. Halaman agen baru akan terbuka kembali.

Menyesuaikan deskripsi tabel dan kolom

Untuk meningkatkan akurasi agen data percakapan, Anda dapat secara opsional memberikan metadata tabel tambahan. Hanya agen data yang menggunakan metadata ini, dan metadata ini tidak memengaruhi tabel sumber. Anda dapat menambahkan metadata berikut:

  • Deskripsi skema: tambahkan deskripsi untuk tabel dan kolom Anda untuk membantu agen memahami data Anda. Jika Anda tidak menambahkan deskripsi, agen akan menggunakan deskripsi skema dari definisi data Anda.

Ikuti praktik terbaik berikut saat Anda menambahkan deskripsi tabel dan kolom:

  • Tambahkan deskripsi ke definisi data, bukan hanya ke definisi agen data. Hal ini memastikan bahwa agen lain juga mendapatkan manfaat dari deskripsi tersebut.
  • Untuk membuat prototipe deskripsi yang sesuai guna membantu agen data memahami data Anda, tambahkan deskripsi ke agen tertentu Anda. Setelah memverifikasi bahwa deskripsi memiliki dampak yang diinginkan, Anda dapat memutuskan apakah akan menambahkan deskripsi dalam definisi data.

Untuk mengonfigurasi deskripsi tabel dan kolom, ikuti langkah-langkah berikut:

  1. Di tab Agent Catalog, buka agen yang ingin Anda sesuaikan.
  2. Klik Edit Agent.
  3. Di Sumber Pengetahuan, cari tabel yang ingin Anda sesuaikan, lalu klik Sesuaikan.
  4. Masukkan deskripsi tabel.
  5. Untuk mengedit deskripsi kolom, klik Edit di samping kolom. Panel Edit kolom akan terbuka.
    1. Di kolom ID, masukkan deskripsi kolom.
    2. Untuk menyimpan deskripsi kolom, klik Perbarui.
  6. Untuk menyimpan deskripsi dan pembaruan kolom, klik Perbarui. Halaman agen baru akan terbuka kembali.
  7. Ulangi langkah-langkah ini untuk setiap tabel yang ingin Anda sesuaikan.

Menambahkan label ke agen data

Di bagian Setelan Agen, Anda dapat membuat label untuk mengatur resource Google Cloud . Label adalah key-value pair yang memungkinkan Anda mengelompokkan objek terkait secara bersamaan atau dengan Google Cloud resource lainnya.

  1. Di tab Agent Catalog, buka agen yang ingin Anda tambahi label.
  2. Klik Edit Agent.
  3. Di bagian Agent Settings, klik Add label. Panel Kelola label akan terbuka.
  4. Klik Tambahkan label.
  5. Di kolom key dan value, masukkan pasangan nilai kunci untuk label.
  6. Jika Anda ingin menambahkan lebih banyak label, klik Tambahkan label lagi.
  7. Untuk menghapus label, klik hapus.
  8. Setelah selesai, klik Tambahkan. Halaman agen baru akan terbuka kembali.

Lanjutkan ke bagian berikutnya untuk menempatkan agen dalam mode draf atau memublikasikan agen.

Melihat pratinjau dan memublikasikan agen

  1. Di bagian Pratinjau, masukkan contoh pertanyaan di kolom Ajukan pertanyaan, lalu tekan Enter.

    Untuk memverifikasi bahwa agen data menampilkan data yang Anda harapkan, tinjau respons agen. Jika respons tidak sesuai dengan yang Anda harapkan, ubah setelan di bagian Editor untuk menyempurnakan konfigurasi agen data hingga Anda mendapatkan respons yang memuaskan. Anda dapat terus menguji dan mengubah agen untuk meningkatkan kualitas hasil agen.

  2. Klik Simpan.

  3. Untuk menempatkan agen data dalam mode draf, yang dapat Anda edit ulang nanti, klik Kembali untuk kembali ke halaman Katalog Agen. Karena agen Anda sekarang dalam mode draf, agen tersebut akan muncul di bagian Agen draf saya pada tab Katalog Agen.

    Untuk memublikasikan agen, tetap berada di halaman pembuatan agen dan lanjutkan ke langkah berikutnya.

  4. Untuk memublikasikan agen data dan menyediakannya untuk digunakan dalam project, klik Publikasikan. Dengan memublikasikan agen, pengguna lain—yang memiliki akses ke tabel database yang sama—dapat melihat dan berinteraksi dengan agen Anda, serta mendapatkan manfaat dari petunjuk dan konteks yang Anda buat.

    Anda dapat membuat percakapan dengan agen data menggunakan halaman Agen di konsol Google Cloud . Anda juga dapat membuat antarmuka sendiri untuk memulai percakapan dengan agen data menggunakan Conversational Analytics API.

  5. Opsional: Di dialog Agen Anda telah dipublikasikan, klik Bagikan untuk membagikan agen data kepada pengguna lain.

    1. Di panel Share permissions, klik Add principal.
    2. Di kolom New principals, masukkan satu atau beberapa akun utama.
    3. Klik daftar Select a role.
    4. Di daftar Role, pilih salah satu peran berikut:
      • Pengguna Agen Data Gemini Data Analytics (roles/geminidataanalytics.dataAgentUser): memberikan izin untuk melakukan percakapan dengan agen data.
      • Editor Agen Data Gemini Data Analytics (roles/geminidataanalytics.dataAgentEditor): memberikan izin untuk mengedit agen data.
      • Pelihat Agen Data Gemini Data Analytics (roles/geminidataanalytics.dataAgentViewer): memberikan izin untuk melihat agen data.

  6. Klik Simpan.

  7. Untuk kembali ke halaman agen baru, klik Tutup. Setelah menyimpan atau memublikasikan agen, Anda dapat melihatnya di Katalog Agen.

Mengelola agen data

Anda dapat menemukan agen yang ada di tab Katalog Agen, yang terdiri dari tiga bagian:

  • Agen saya: daftar semua agen yang Anda buat dan publikasikan. Anda dapat mengubah dan membagikan agen yang dipublikasikan kepada orang lain.
  • Agen draf saya: agen yang belum Anda publikasikan. Anda tidak dapat membagikan agen draf.
  • Dibagikan oleh orang lain dalam organisasi Anda: agen yang dibuat dan dibagikan kepada Anda oleh orang lain. Jika orang lain memberi Anda izin, Anda dapat mengedit agen bersama ini.

Mengedit agen data

Untuk mengedit agen data, ikuti langkah-langkah berikut:

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

    Buka Cloud SQL

  2. Pilih instance dari daftar.

  3. Di menu navigasi, klik Agen.

  4. Login ke Agen menggunakan autentikasi Identity and Access Management (IAM).

  5. Klik tab Katalog Agen.

  6. Temukan kartu agen dari agen data yang ingin Anda ubah.

  7. Untuk membuka agen data di editor agen, klik Open actions, lalu klik Edit di kartu agen.

  8. Edit konfigurasi agen data sesuai kebutuhan.

  9. Untuk menyimpan perubahan tanpa memublikasikan, klik Simpan.

  10. Untuk memublikasikan perubahan, klik Publikasikan. Dalam dialog Bagikan, Anda dapat membagikan agen kepada orang lain, atau mengklik Batal.

  11. Untuk kembali ke panel Agen, klik Kembali.

Membagikan agen data

Ikuti langkah-langkah berikut untuk membagikan agen data yang dipublikasikan. Anda tidak dapat membagikan agen draf.

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

    Buka Cloud SQL

  2. Pilih instance dari daftar.

  3. Di menu navigasi, klik Agen.

  4. Login ke Agen menggunakan autentikasi Identity and Access Management (IAM).

  5. Klik tab Katalog Agen.

  6. Temukan kartu agen dari agen data yang ingin Anda ubah.

  7. Untuk membuka agen data di editor agen, klik Open actions > klik Edit di kartu agen.

  8. Untuk membagikan agen data kepada pengguna lain, klik Bagikan.

  9. Di panel Share permissions, klik Add principal.

  10. Di kolom Add principals, masukkan satu atau beberapa akun utama.

  11. Klik Pilih peran.

  12. Di daftar Peran, pilih salah satu peran berikut:

    • Pengguna Agen Data Gemini Data Analytics (roles/geminidataanalytics.dataAgentUser): memberikan izin untuk memulai percakapan dengan agen data.
    • Editor Agen Data Gemini Data Analytics (roles/geminidataanalytics.dataAgentEditor): memberikan izin untuk mengedit agen data.
    • Gemini Data Analytics Data Agent Viewer (roles/geminidataanalytics.dataAgentViewer): memberikan izin untuk melihat agen data.

  13. Klik Simpan.

  14. Untuk kembali ke halaman pengeditan agen, klik Tutup.

  15. Untuk kembali ke panel Agen, klik Kembali.

Menghapus agen data

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

    Buka Cloud SQL

  2. Pilih instance dari daftar.

  3. Di menu navigasi, klik Agen.

  4. Login ke Agen menggunakan autentikasi Identity and Access Management (IAM).

  5. Pilih tab Katalog Agen.

  6. Di bagian Agents pada tab Agent Catalog, temukan kartu agen data yang ingin Anda hapus.

  7. Klik Buka tindakan > Hapus.

  8. Pada dialog Hapus agen?, klik Hapus. Menghapus agen secara permanen akan menghapus agen dari project.

    Setelah Anda menghapus agen, percakapan yang ada akan tersedia dalam mode hanya lihat. Anda tidak dapat mengajukan pertanyaan baru kepada agen yang dihapus.

Lokasi

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

Langkah berikutnya