Membuat dan mengelola agen data Explore

Agen data memungkinkan Anda mengatur pengalaman Analisis Percakapan untuk pengguna. Dengan agen, Anda dapat memberikan konteks dan petunjuk ke Analisis Percakapan agar dapat menjawab pertanyaan secara lebih efektif untuk kasus penggunaan tertentu. Agen memungkinkan analis memetakan istilah bisnis ke kolom tertentu, menentukan kolom terbaik untuk pemfilteran, dan menentukan penghitungan kustom.

Halaman ini memandu Anda melalui proses berikut:

Pelajari cara dan waktu Gemini untuk Google Cloud menggunakan data Anda.

Sebelum memulai

Penggunaan Analisis Percakapan dikelola melalui kombinasi akses konten, akses data, dan akses fitur. Anggap agen data sebagai jenis konten Looker lainnya — seperti dasbor, Look, atau folder. Untuk berinteraksi dengan agen data, Anda harus diberi peran Looker yang memiliki izin yang diperlukan untuk model yang mendasari setiap Jelajah atau yang akan dikueri oleh agen data. Dalam beberapa kasus, Anda juga memerlukan akses ke agen itu sendiri.

Untuk mengetahui informasi selengkapnya tentang izin dan akses yang diperlukan untuk mengelola dan menggunakan agen data, lihat tabel izin di halaman dokumentasi Menyiapkan Analisis Percakapan di Looker.

Agen Eksplorasi Analisis Percakapan tersedia jika admin Looker telah mengaktifkan fitur berikut di halaman admin Gemini in Looker:

  • Conversational Analytics
  • Mengaktifkan Fitur Penguji Tepercaya
    • Agentic Workflows [Pratinjau]: Untuk membuat Agentic Workflows yang menginstruksikan agen Anda untuk memantau perubahan pada data Anda.
    • Kueri Terverifikasi [Pratinjau]: Untuk menentukan kueri terverifikasi, pasangan pertanyaan dalam bahasa alami dan kueri Jelajah yang sesuai, sebagai konteks untuk agen Anda. Fitur pratinjau ini hanya tersedia di Looker (asli).
    • Publikasikan ke Gemini Enterprise [Pratinjau]: Untuk memublikasikan agen Anda ke Gemini Enterprise, sehingga konteks dan analisis yang telah ditentukan sebelumnya untuk agen Anda tersedia bagi audiens yang lebih luas.

Membuat dan mengedit agen data

Untuk membuat agen data baru, ikuti langkah-langkah berikut:

  1. Buka halaman Percakapan.
  2. Di tab Agen, pilih + Agen baru. Atau, di panel kiri, pilih sparkKelola agen, lalu pilih + Agen baru.

  3. Di halaman Agen baru, berikan informasi berikut tentang agen data Anda.

    • Nama agen: Masukkan nama untuk agen. Nama harus unik dan deskriptif.
    • Deskripsi agen: Jelaskan secara singkat kemampuan agen ini dan data yang digunakannya. Pengguna akan melihat deskripsi ini saat mereka memilih agen untuk memulai percakapan atau saat Anda membagikan agen tersebut kepada mereka. Jadi, pastikan deskripsi menjelaskan dengan jelas tujuan agen dan cara agen tersebut dapat membantu.
    • Data: Ikuti langkah-langkah berikut untuk terhubung ke maksimal lima Eksplorasi Looker yang ada:
      1. Di kolom Data, klik + Pilih Eksplorasi.
      2. Di jendela Telusuri Eksplorasi, klik Eksplorasi yang ingin Anda sertakan dalam agen data. Eksplorasi ini akan muncul di panel Selected Explores di jendela.
      3. Untuk menambahkan Eksplorasi yang dipilih ke agen data, klik Simpan.

  4. Petunjuk: Berikan konteks untuk membantu Analisis Percakapan memahami cara berinteraksi dengan data Anda dan memberikan respons yang akurat dan relevan. Untuk mengetahui contoh jenis konteks yang dapat Anda berikan, lihat Menulis petunjuk agen.

  5. Secara opsional, untuk mengaktifkan Analisis Lanjutan untuk semua percakapan dengan agen Anda, pilih Aktifkan Analisis Lanjutan.

  6. Jika ingin, pilih Advanced options untuk meluaskan bagian dan mengonfigurasi setelan berikut:

    • Tampilkan proses berpikir: Aktifkan tombol ini untuk menampilkan langkah-langkah penalaran agen, kueri Looker yang dihasilkan, dan tabel data pokok dalam respons.
    • Tampilkan info debug: Aktifkan tombol ini untuk menampilkan langkah-langkah yang dijalankan oleh agen per respons untuk membantu pemecahan masalah.

  7. Secara opsional, Anda dapat menguji agen Anda untuk menyempurnakan petunjuk dan setelannya.

  8. Untuk menyimpan agen data baru, klik Simpan.

Setelah menyimpan agen data, Anda dapat membagikan agen kepada pengguna lain dan memulai percakapan dengan agen tersebut.

Menulis petunjuk agen

Saat membuat agen data, Anda dapat menambahkan petunjuk bentuk bebas yang menentukan perilaku inti agen data dan memberikan konteks dasar untuk dipertimbangkan sebelum memproses perintah pengguna.

Berikut beberapa contoh jenis konteks yang dapat Anda berikan di kolom Petunjuk:

  • Kolom utama: Kolom terpenting untuk analisis
  • Kolom yang dikecualikan: Kolom yang harus dihindari oleh agen data
  • Pemfilteran dan pengelompokan: Kolom yang harus digunakan agen untuk memfilter dan mengelompokkan data
  • Persona: Peran atau keahlian, karakter, atau gaya bahasa yang Anda tetapkan untuk agen

Untuk mendapatkan tips dan praktik terbaik dalam menulis petunjuk agen, lihat halaman dokumentasi Praktik terbaik untuk mengonfigurasi Analisis Percakapan di Looker.

Menentukan kueri terverifikasi

Kueri terverifikasi (juga disebut sebagai kueri emas dalam beberapa dokumentasi Google) adalah pasangan pertanyaan bahasa alami yang telah ditentukan sebelumnya dan kueri Eksplorasi Looker yang tepat dan sesuai. Pasangan pertanyaan dan kueri ini berfungsi sebagai "standar emas" kebenaran yang terverifikasi yang mengajarkan agen Anda cara menangani permintaan bisnis yang kompleks tanpa menebak-nebak. Kueri terverifikasi yang ditentukan dengan baik dapat membantu meningkatkan akurasi respons dari agen data Jelajah Anda.

Batasan kueri terverifikasi

Saat menggunakan kueri terverifikasi, perhatikan batas berikut:

  • Kueri terverifikasi hanya tersedia untuk agen data Jelajahi. Fitur ini tidak tersedia untuk percakapan mandiri atau untuk agen data dasbor.
  • Anda harus menggunakan Eksplorasi yang sudah ditentukan untuk agen. Jika Anda mereferensikan Eksplorasi yang tidak digunakan oleh agen data, Anda akan melihat pesan error This query will not be used as it references an Explore that has not been defined in this agent. For best results, make sure that verified queries are based on Explores used in this agent.
  • Kueri terverifikasi tidak mendukung kueri Jelajah yang berisi kolom kustom atau pivot.
  • Meskipun tidak ada batasan jumlah kueri terverifikasi yang dapat Anda tambahkan, sebaiknya sertakan tidak lebih dari 30 hingga 50 pasangan pertanyaan dan kueri per agen.

Membuat kueri terverifikasi

Untuk menambahkan kueri terverifikasi ke agen data baru atau yang sudah ada, ikuti langkah-langkah berikut:

  1. Buat agen data baru, atau edit agen data yang ada yang menggunakan setidaknya satu Eksplorasi sebagai sumber data.
  2. Di halaman pembuatan atau pengeditan agen, pilih + Tambahkan kueri terverifikasi.
  3. Di bagian Tambahkan kueri terverifikasi, masukkan pertanyaan dalam bahasa alami dan jawabannya yang sesuai:
    • Pertanyaan: Masukkan pertanyaan dalam bahasa alami yang mungkin diajukan pengguna.
    • Jawaban: Tempelkan URL Eksplorasi yang merekam kueri atau visualisasi yang benar.
  4. Untuk memverifikasi kueri Jelajahi, klik Pratinjau.
    • Atau: Kosongkan kolom Jawaban dan klik Pratinjau untuk membuat kueri dari awal di builder Jelajahi, lalu simpan URL yang dihasilkan untuk digunakan.
  5. Klik Simpan.

Mengedit kueri terverifikasi

Untuk mengedit kueri terverifikasi yang ada, ikuti langkah-langkah berikut:

  1. Dalam percakapan Anda dengan agen, pilih Edit agen.
  2. Di bagian Kueri terverifikasi, cari kueri terverifikasi yang ingin Anda edit.
  3. Klik Edit verified query.
  4. Dalam dialog Edit kueri terverifikasi, lakukan perubahan pada pertanyaan atau jawaban.
  5. Klik Simpan.

Menghapus kueri terverifikasi

Untuk menghapus kueri terverifikasi, ikuti langkah-langkah berikut:

  1. Dalam percakapan Anda dengan agen, pilih Edit agen.
  2. Di bagian Kueri terverifikasi, cari kueri terverifikasi yang ingin Anda hapus.
  3. Klik Hapus kueri terverifikasi.

Menguji agen

Saat Anda membuat atau mengedit agen, halaman detail agen akan menyertakan panel Pratinjau agen Anda. Anda dapat menguji setelan dan petunjuk agen dengan memulai percakapan dengan agen.

Anda harus mengklik Perbarui agar perubahan ditampilkan dalam pratinjau. Jika status penyimpanan adalah Not saved, semua pembaruan pada setelan tidak akan ditampilkan dalam pratinjau.

Mengedit agen data yang ada

Untuk mengedit agen data yang ada, ikuti langkah-langkah berikut:

  1. Di halaman Percakapan, pilih sparkKelola agen.
  2. Di halaman Kelola agen, pilih agen data yang ingin Anda edit.
  3. Perbarui detail tentang agen sesuai kebutuhan. Anda dapat mengubah detail yang Anda tentukan saat membuat agen, termasuk setelan Agent name, Agent description, Data, Instructions, dan Advanced options. Anda juga dapat memilih untuk mengaktifkan Code Interpreter untuk agen Anda.
  4. Untuk menyimpan perubahan, klik Perbarui.

Membagikan agen data

Berbagi memungkinkan pengguna lain melakukan chat dengan agen Anda dan Eksplorasinya. Anda dapat membagikan agen data kepada pengguna lain dengan memberikan akses konten ke agen tersebut. Hanya pengguna dengan izin dan akses konten yang sesuai yang dapat membagikan agen. Setelah dibuat, agen mungkin memerlukan waktu beberapa menit agar dapat dibagikan.

Untuk membagikan agen data, ikuti langkah-langkah berikut:

  1. Di halaman Percakapan, pilih sparkKelola agen di panel kiri.
  2. Buka menu untuk agen yang dipilih dengan mengklik ikon Opsi lainnya , lalu klik Bagikan.
  3. Setelah Anda menambahkan individu atau grup ke bagian Siapa yang dapat mengakses agen ini, dan memilih tingkat izin yang harus mereka miliki, klik Tambahkan untuk menempatkan mereka dalam daftar bersama.
  4. Jika Anda ingin pengguna atau grup baru menerima email notifikasi, centang kotak Kirim email kepada orang yang baru saja Anda tambahkan.
  5. Setelah semua perubahan dilakukan, klik Simpan.

Anda juga dapat membagikan agen yang baru saja Anda buat atau yang sedang Anda edit dengan mengklik Bagikan di halaman setelan agen dan mengikuti langkah-langkah yang disebutkan di atas.

Mencabut akses ke agen data

Untuk mencabut akses ke agen, ikuti langkah-langkah berikut:

  1. Di halaman Percakapan, klik sparkKelola agen di panel kiri.
  2. Buka menu untuk agen yang dipilih dengan mengklik ikon Opsi lainnya , lalu klik Bagikan.
  3. Klik X di samping pengguna atau grup yang aksesnya harus dihapus.
  4. Setelah semua perubahan dilakukan, klik Simpan.

Jika pengguna yang dihapus memiliki percakapan yang sedang berlangsung, mereka akan tetap memiliki akses selama satu atau dua menit saat perubahan diterapkan.

Jika pengguna mencoba mengajukan lebih banyak pertanyaan setelah akses ke agen dihapus, pengguna tersebut akan melihat pesan The agent in this conversation may not be shared with you, or may have been deleted. You can view any past conversations with the agent, but can't ask new questions.

Memublikasikan agen data

Anda dapat memublikasikan agen data di Gemini Enterprise, sehingga konteks dan analisis yang telah ditentukan sebelumnya oleh agen Anda tersedia untuk audiens yang lebih luas, termasuk pengguna yang mungkin belum terbiasa dengan antarmuka Looker. Gemini Enterprise berfungsi sebagai hub pusat tempat pengguna dapat mengelola agen data yang dibuat di seluruh aplikasi, sehingga membantu pengguna menemukan agen terbaik untuk kebutuhan analisis mereka. Google Cloud

Sebelum memulai

Prosedur untuk membuat agen data di Looker dan menyediakannya bagi pengguna di Gemini Enterprise melibatkan tugas yang dilakukan di instance Looker, di halaman Gemini Enterprise di konsol Google Cloud , dan di instance Gemini Enterprise.

Pengguna dengan peran berikut harus mengikuti langkah-langkah yang dijelaskan di bagian terkait:

  1. Editor agen data (kemampuan Looker): Memublikasikan agen di Looker.
  2. Admin Discovery Engine (peran IAM): Memberikan akses ke agen di konsol Google Cloud .
  3. Pengguna Gemini Enterprise (peran IAM); Pengguna agen data (kemampuan Looker): Melakukan percakapan dengan agen di instance Gemini Enterprise.

Sebelum Anda dapat memublikasikan agen, persyaratan berikut harus dipenuhi:

  • Admin Looker harus mengaktifkan setelan Publikasikan ke Gemini Enterprise di halaman Gemini in Looker pada panel Admin.
  • Admin Looker harus memberi Anda peran yang berisi izin publish_agent_externally. Anda juga harus dapat mengedit agen data.
  • Akun layanan Looker di project Google Cloud yang menghosting mesin Gemini Enterprise harus diberi peran Identity and Access Management Discovery Engine Admin. Pemberian peran ini akan menetapkan lisensi Gemini Enterprise ke akun saat agen data pertama dipublikasikan. Jika tidak ada lisensi Gemini Enterprise yang tersedia untuk ditetapkan ke akun layanan Looker, halaman mesin Gemini Enterprise di konsol Google Cloud akan menampilkan error "Failed to allocate quota for agent creation". Pengguna dengan peran Identity and Access Management Admin Discovery Engine kemudian harus menyediakan lisensi Gemini Enterprise baru atau menetapkan ulang lisensi yang ada untuk akun layanan Looker.

Memublikasikan agen data ke Gemini Enterprise

Untuk menyelesaikan langkah-langkah yang dijelaskan di bagian ini, Anda harus memiliki peran Looker yang berisi izin publish_agent_externally dan izin serta akses konten yang sesuai untuk mengedit agen data.

Untuk memublikasikan agen, ikuti langkah-langkah berikut:

  1. Edit agen.
  2. Pilih Setelan publikasi untuk membuka jendela Setelan publikasi agen.
  3. Di jendela Setelan publikasi agen, aktifkan setelan Gemini Enterprise, lalu pilih Perbarui. Mengaktifkan setelan ini akan memublikasikan agen ke instance Gemini Enterprise yang ditampilkan di halaman Gemini in Looker di panel Admin.
  4. Setelah memublikasikan agen, Anda dapat memilih Bagikan untuk memberi pengguna Looker lain akses ke agen data Anda, atau memilih Mulai percakapan untuk membuka percakapan baru dengan agen data.

Memberi pengguna akses ke agen di Gemini Enterprise

Untuk menyelesaikan langkah-langkah yang dijelaskan di bagian ini, Anda harus memiliki peran Identity and Access Management Admin Discovery Engine untuk Google Cloud project yang berisi mesin Gemini Enterprise.

Untuk dapat melakukan percakapan dengan agen di Gemini Enterprise, pengguna harus memiliki akses ke instance Gemini Enterprise dan ke agen tertentu.

Untuk memberi pengguna akses ke instance Gemini Enterprise, Admin Discovery Engine harus menetapkan peran IAM Gemini Enterprise User kepada pengguna untuk project Google Cloud yang berisi mesin Gemini Enterprise.

Untuk memberikan akses pengguna ke masing-masing agen, Admin Discovery Engine harus menyelesaikan langkah-langkah berikut di konsol Google Cloud :

  1. Buka project Google Cloud yang berisi mesin Gemini Enterprise.
  2. Buka halaman produk Gemini Enterprise.
  3. Pilih halaman Apps dari navigasi utama, lalu pilih nama instance Gemini Enterprise.
  4. Di navigasi utama, pilih Agen.
  5. Pilih agen yang ingin Anda beri akses.
  6. Pilih tab Izin pengguna.
  7. Pilih Tambahkan pengguna.
  8. Di jendela Tambahkan peran izin pengguna ke agen, tambahkan setiap pengguna dan tetapkan peran Pengguna Agen kepada mereka.

Mulai percakapan dengan agen di Gemini Enterprise

Untuk menyelesaikan langkah-langkah yang dijelaskan di bagian ini, Anda harus memiliki peran Identity and Access Management Pengguna Gemini Enterprise untuk Google Cloud project yang berisi mesin Gemini Enterprise. Anda juga harus memiliki izin dan akses konten yang sesuai untuk memulai percakapan dengan agen di instance Looker.

Untuk memulai percakapan dengan agen data di instance Gemini Enterprise, ikuti langkah-langkah berikut:

  1. Buka instance Gemini Enterprise Anda.
  2. Pilih Agen di navigasi utama.
  3. Di halaman Agen, pilih agen yang ingin Anda ajak chat. Saat Anda memilih agen, jendela percakapan akan terbuka dan Anda dapat mengajukan pertanyaan tentang data Anda.

Saat pertama kali melakukan chat dengan agen, Anda harus mengizinkan akses agen ke identitas Looker Anda.

Menghapus agen data

Untuk menghapus agen data, ikuti langkah-langkah berikut:

  1. Di halaman Percakapan, klik sparkKelola agen di panel kiri.
  2. Buka menu untuk agen yang dipilih dengan mengklik ikon Opsi lainnya, lalu klik Hapus.
  3. Di jendela Hapus agen?, klik Pindahkan ke sampah untuk menghapus agen data.

Agen yang dipindahkan ke sampah akan dihapus secara permanen setelah 30 hari. Anda dapat menghapus agen data secara permanen secara manual, atau Anda dapat memulihkan agen data dari sampah sebelum agen data tersebut dihapus secara permanen. Jika Anda tidak mengambil tindakan, agen akan dihapus secara permanen setelah 30 hari secara otomatis.

Menghapus agen data secara permanen

Untuk menghapus agen data secara permanen, ikuti langkah-langkah berikut:

  1. Buka halaman Percakapan.
  2. Di panel navigasi kiri, luaskan bagian Sampah.
  3. Untuk membuka menu agen yang dipilih, pilih ikon -nya, lalu klik Hapus Permanen.
  4. Di jendela Yakin?, klik Hapus selamanya.

Memulihkan agen data dari sampah

Untuk memulihkan agen data dari sampah, ikuti langkah-langkah berikut:

  1. Buka halaman Percakapan.
  2. Di panel navigasi kiri, luaskan bagian Sampah.
  3. Untuk membuka menu agen yang dipilih, pilih ikon -nya, lalu klik Pulihkan.