Membuat agen data

Agen data percakapan memungkinkan Anda berinteraksi dengan data database menggunakan antarmuka bahasa alami. Dengan membangun agen ini, Anda membantu pengguna "berinteraksi dengan data mereka", sehingga mendapatkan insight dari database operasional tanpa mengharuskan mereka 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. Konteks ini mencakup deskripsi skema, petunjuk sistem, dan konteks terstruktur yang memberikan informasi tambahan tentang kueri database yang diharapkan.
  • Kompleksitas berkurang: agen menerjemahkan bahasa alami ke dalam kueri SQL, eksekusi, dan bahkan ringkasan atau visualisasi data.
  • Fleksibilitas: Anda dapat membuat draf agen untuk pengujian pribadi, atau memublikasikannya agar tersedia untuk pengguna lain di project Anda atau secara terprogram menggunakan API.

Sebelum memulai

  1. Pastikan penagihan diaktifkan untuk Google Cloud project Anda.

  2. Aktifkan AlloyDB untuk PostgreSQL, Data Analytics API dengan Gemini, dan Gemini untuk 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:

  • Mengkueri data dari sumber database yang didukung menggunakan metode QueryData: Pengguna Kueri Data Gemini Data Analytics (roles/geminidataanalytics.queryDataUser) di tingkat project.
  • Membuat agen data Anda sendiri di 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.
  • Mengedit, membagikan, dan menghapus semua agen data di project: Pemilik Agen Data Gemini Data Analytics (roles/geminidataanalytics.dataAgentOwner) di tingkat project.
  • Melihat dan mengedit semua agen data di project: Editor Agen Data Gemini Data Analytics (roles/geminidataanalytics.dataAgentEditor) di tingkat project.
  • Melihat semua agen data di 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 cluster di tingkat database. Untuk mengetahui informasi selengkapnya, lihat Mengelola pengguna database.
  • Peran alloydb.databaseUser dan izin serviceusage.serviceUsageConsumer yang diberikan kepada pengguna IAM di tingkat project. Untuk mengetahui informasi selengkapnya, lihat Menambahkan binding kebijakan IAM untuk project.

Untuk menggunakan resource AlloyDB, seperti melihat tabel atau menjalankan kueri, lihat Peran dan izin IAM untuk AlloyDB.

Membuat agen data

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

Mengonfigurasi dasar

  1. Di Google Cloud konsol, buka halaman AlloyDB.

    Buka AlloyDB

  2. Pilih cluster dari daftar.

  3. Di menu navigasi, klik Agents.

  4. Klik tab Agents.

  5. Pilih database dan login menggunakan akun IAM Anda.

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

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

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

  9. Di bagian Knowledge sources, klik Add source. Halaman Add data akan terbuka.

  10. Pilih tabel yang akan difokuskan agen saat menjawab pertanyaan. Untuk melihat sumber pengetahuan tambahan, pilih Show more.

  11. Klik Add. 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 guna membantu agen memahami data Anda. Jika Anda tidak menambahkan deskripsi, agen akan menggunakan deskripsi skema dari definisi data Anda.

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

  • Tambahkan deskripsi ke definisi data Anda, bukan hanya ke definisi agen data Anda. 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 tersebut memiliki dampak yang diinginkan, Anda dapat memutuskan apakah akan menambahkan deskripsi dalam definisi data Anda.

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 Knowledge Sources, temukan tabel yang ingin Anda sesuaikan, lalu klik Customize.
  4. Masukkan deskripsi tabel.
  5. Untuk mengedit deskripsi kolom, klik Edit di samping kolom. Panel Edit field akan terbuka.
    1. Di kolom ID, masukkan deskripsi kolom.
    2. Untuk menyimpan deskripsi kolom, klik Update.
  6. Untuk menyimpan deskripsi dan pembaruan kolom, klik Update. 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 Agent Settings, Anda dapat membuat label untuk mengatur resource Anda Google Cloud . Label adalah pasangan nilai kunci yang memungkinkan Anda mengelompokkan objek terkait secara bersamaan atau dengan Google Cloud resource lainnya.

  1. Di tab Agent Catalog, buka agen yang ingin Anda tambahkan label.
  2. Klik Edit Agent.
  3. Di bagian Agent Settings, klik Add label. Panel Manage labels akan terbuka.
  4. Klik Add label.
  5. Di kolom key dan value, masukkan pasangan nilai kunci untuk label.
  6. Jika Anda ingin menambahkan lebih banyak label, klik Add label lagi.
  7. Untuk menghapus label, klik delete.
  8. Setelah selesai, klik Add. 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 Preview, masukkan contoh pertanyaan di kolom Ask a question, lalu tekan Enter.

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

  2. Klik Save.

  3. Untuk menempatkan agen data dalam mode draf, yang dapat Anda edit kembali nanti, klik Go back untuk kembali ke halaman Agent Catalog. Karena agen Anda sekarang dalam mode draf, agen tersebut akan muncul di bagian My draft agents di tab Agent Catalog.

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

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

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

  5. Opsional: Di dialog Your agent has been published, klik Share 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 chat dengan agen data.
      • Editor Agen Data Gemini Data Analytics (roles/geminidataanalytics.dataAgentEditor): memberikan izin untuk mengedit agen data.
      • Penampil Agen Data Gemini Data Analytics (roles/geminidataanalytics.dataAgentViewer): memberikan izin untuk melihat agen data.

  6. Klik Save.

  7. Untuk kembali ke halaman agen baru, klik Close. Setelah menyimpan atau memublikasikan agen, Anda dapat melihatnya di Agent Catalog.

Mengelola agen data

Anda dapat menemukan agen yang ada di tab Agent Catalog, 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 di 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 Google Cloud konsol, buka halaman AlloyDB.

    Buka AlloyDB

  2. Pilih cluster dari daftar.

  3. Di menu navigasi, klik Agents.

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

  5. Klik tab Agent Catalog.

  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 Save.

  10. Untuk memublikasikan perubahan, klik Publish. Di dialog Share , Anda dapat membagikan agen kepada orang lain, atau Anda dapat mengklik Cancel.

  11. Untuk kembali ke panel Agents, klik Go back.

Membagikan agen data

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

  1. Di Google Cloud konsol, buka halaman AlloyDB.

    Buka AlloyDB

  2. Pilih cluster dari daftar.

  3. Di menu navigasi, klik Agents.

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

  5. Klik tab Agent Catalog.

  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 Share.

  9. Di panel Share permissions, klik Add principal.

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

  11. Klik Select a role.

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

    • Pengguna Agen Data Gemini Data Analytics (roles/geminidataanalytics.dataAgentUser): memberikan izin untuk melakukan chat dengan agen data.
    • Editor Agen Data Gemini Data Analytics (roles/geminidataanalytics.dataAgentEditor): memberikan izin untuk mengedit agen data.
    • Penampil Agen Data Gemini Data Analytics (roles/geminidataanalytics.dataAgentViewer): memberikan izin untuk melihat agen data.

  13. Klik Save.

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

  15. Untuk kembali ke panel Agents, klik Go back.

Menghapus agen data

  1. Di Google Cloud konsol, buka halaman AlloyDB.

    Buka AlloyDB

  2. Pilih cluster dari daftar.

  3. Di menu navigasi, klik Agents.

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

  5. Pilih tab Agent Catalog.

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

  7. Klik Open actions > Delete.

  8. Di dialog Delete agent?, klik Delete. Menghapus agen akan menghapus agen secara permanen 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