Membuat dan mengelola agen data

Agen data memungkinkan Anda mengatur pengalaman Analisis Percakapan untuk pengguna. Dengan agen, Anda dapat memberikan konteks dan petunjuk kepada 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 kalkulasi kustom.

Halaman ini memandu Anda melalui proses berikut:

• Membuat dan mengedit agen data
• Membagikan agen data
• Menghapus agen data

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

Sebelum memulai

Anggap agen data sebagai jenis konten Looker lainnya — seperti dasbor, Look, atau folder.

Penggunaan agen data dikelola melalui kombinasi akses konten, akses data, dan akses fitur. Untuk melakukan tugas yang dijelaskan dalam tabel berikut, Anda harus diberi peran Looker yang memiliki izin yang diperlukan untuk model yang akan dikueri oleh agen data Anda dan, dalam beberapa kasus, akses ke agen itu sendiri.

Tugas	Izin Looker yang diperlukan	Tingkat akses agen data yang diperlukan
Membuat, mengedit, membagikan, dan menghapus agen	Ditambahkan 25.18 admin_agents	Tidak ada akses konten yang harus diberikan
Membuat, mengedit, membagikan, dan menghapus agen	Ditambahkan 25.18 save_agents Pengguna dapat membuat agen yang hanya menggunakan Eksplorasi yang telah diberi izin ini pada model yang mendasarinya. Untuk mengedit, menghapus, atau membagikan agen data yang dibuat oleh pengguna lain, pengguna harus diberi peran yang berisi izin ini pada setiap model yang digunakan oleh agen.	Kelola akses; Edit (akses ini diberikan secara otomatis jika pengguna membuat agen; jika tidak, akses Kelola akses; Edit harus diberikan oleh pembuat agen dengan membagikan agen)
Melakukan chat dengan agen data dari tab Agen di Analisis Percakapan	access_data (pada setiap model yang berisi Eksplorasi yang digunakan oleh agen data) Ditambahkan 25.18 chat_with_agent (pada setiap model yang berisi Eksplorasi yang digunakan oleh agen data)	Akses Lihat
Melakukan chat dengan Eksplorasi Looker dari tab Eksplorasi di Analisis Percakapan	access_data (pada setiap model yang berisi Eksplorasi yang digunakan oleh agen data) Ditambahkan 25.18 chat_with_explore

Looker juga memiliki peran default berikut yang berisi subset izin ini untuk semua model di instance:

• Pengelola Agen Analisis Percakapan: Dengan peran ini, pengguna dapat membuat, mengedit, membagikan, menghapus, dan melakukan chat dengan agen yang memiliki akses Kelola akses; Edit dan melakukan chat dengan Eksplorasi
• Pengguna Analisis Percakapan: Dengan peran ini, pengguna dapat melakukan chat dengan agen yang memiliki akses Lihat
• Admin: Secara default, peran ini (Admin Looker) memiliki semua izin dan akses konten di seluruh instance.

Admin Looker dapat memberikan peran dan izin ini di halaman Peran di bagian Admin instance Looker. Untuk mengetahui informasi selengkapnya tentang peran Looker, lihat halaman dokumentasi Setelan admin – Peran.

Pembuat agen data dapat mengelola akses pengguna ke agen dengan membagikan agen.

Membuat dan mengedit agen data

Sebagai teknologi tahap awal, Gemini untuk Google Cloud produk dapat menghasilkan output yang seolah masuk akal tetapi mengandung fakta yang salah. Sebaiknya validasi semua output dari Gemini untuk Google Cloud produk sebelum Anda menggunakannya. Untuk mengetahui informasi selengkapnya, lihat Gemini untuk Google Cloud dan responsible AI.

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 kepada mereka. Jadi, pastikan deskkripsi menjelaskan dengan jelas tujuan agen dan manfaatnya.
   • Data: Ikuti langkah-langkah berikut untuk menghubungkan hingga 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 Eksplorasi yang Dipilih 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 Penafsir Kode untuk semua percakapan dengan agen Anda, pilih Aktifkan Analisis Lanjutan.

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

7. Untuk menyimpan agen data baru, klik Simpan.

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

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.

Penting: Meskipun kolom Petunjuk bersifat opsional dan strukturnya terserah Anda, sebaiknya berikan petunjuk yang terstruktur dengan baik agar agen dapat memberikan respons yang lebih akurat dan relevan.

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

• Kolom kunci: 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
• Kueri unggulan: Pasangan pertanyaan natural language dan kueri Eksplorasi yang sesuai
• Persona: Peran atau keahlian, karakter, atau nada yang Anda tetapkan ke agen

Catatan: Jenis konteks yang dibuat yang dapat Anda berikan kepada agen data di Looker sedikit berbeda dengan yang dapat Anda berikan kepada agen yang Anda buat menggunakan Conversational Analytics API. Beberapa hal yang Anda berikan di kolom Petunjuk di Looker — seperti kueri unggulan — dapat diberikan kepada agen sebagai konteks terstruktur menggunakan Conversational Analytics API.

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

Menentukan kueri unggulan Looker

Untuk menentukan setiap kueri unggulan Looker untuk Eksplorasi tertentu, berikan nilai untuk kedua kolom berikut:

• natural_language_questions: Pertanyaan natural language yang mungkin diajukan pengguna
• looker_query: Kueri unggulan Looker yang sesuai dengan pertanyaan natural language

Tips untuk menentukan kueri unggulan Looker:

Sertakan berbagai jenis pertanyaan dan kueri yang memiliki beragam filter dan nilai filter.

Meskipun tidak ada batasan jumlah kueri unggulan yang dapat Anda sertakan ke looker_golden_queries, sebaiknya sertakan tidak lebih dari 30-50 pasangan pertanyaan dan kueri.

Untuk kolom natural_language_questions, pertimbangkan pertanyaan yang mungkin diajukan pengguna tentang Eksplorasi tersebut, dan tulis pertanyaan tersebut dalam natural language. Anda dapat menyertakan lebih dari satu pertanyaan dalam nilai kolom ini. Anda dapat memperoleh nilai untuk kolom looker_query dari metadata kueri Eksplorasi.

Kueri unggulan mendukung kolom berikut:

• model (string): Model LookML yang digunakan untuk membuat kueri. Kolom ini wajib diisi.
• explore (string): Eksplorasi yang digunakan untuk membuat kueri. Kolom ini wajib diisi.
• fields[] (string): Kolom yang akan diambil dari Eksplorasi, termasuk dimensi dan ukuran. Kolom ini bersifat opsional.
• filters[] (string): Filter yang akan diterapkan ke Eksplorasi. Kolom ini bersifat opsional.
• sorts[] (string): Pengurutan yang akan diterapkan ke Eksplorasi. Kolom ini bersifat opsional.
• limit (string): Batas baris data yang akan diterapkan ke Eksplorasi. Kolom ini bersifat opsional.

Catatan: Analisis Percakapan tidak mendukung kueri unggulan yang berisi pivots atau kolom kustom.

Anda dapat mengambil metadata kueri Eksplorasi langsung dari Eksplorasi dengan mengikuti langkah-langkah berikut:

1. Di Eksplorasi, pilih menu Tindakan Eksplorasi , lalu pilih Dapatkan LookML.
2. Pilih tab Dasbor.
3. Salin detail kueri dari LookML. Misalnya, gambar berikut menunjukkan LookML untuk Eksplorasi yang disebut Item Pesanan:

Salin metadata yang dipilih untuk digunakan dalam kueri unggulan Looker Anda:

  model: thelook
  explore: order_items
  fields: [order_items.order_id, orders.status]
  sorts: [orders.status, order_items.order_id]
  limit: 500

Menguji agen

Saat Anda membuat atau mengedit agen, halaman detail agen akan menyertakan panel Pratinjau agen. 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 update 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 kolom Nama agen, Deskripsi agen, Data, dan Petunjuk. Anda juga dapat memilih untuk mengaktifkan Penafsir Kode untuk agen Anda.
4. Untuk menyimpan perubahan, klik Perbarui.

Membagikan agen data

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

Catatan: Memberikan akses konten pengguna ke agen tidak memberikan akses pengguna tersebut ke Eksplorasi yang digunakan agen. Saat Anda membagikan agen, pastikan pengguna juga memiliki izin yang mereka perlukan untuk menggunakan Analisis Percakapan dengan model yang menjadi dasar Eksplorasi. Admin Looker Anda mungkin perlu memberikan izin ini.

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 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 Anda tambahkan.
5. Setelah semua perubahan dilakukan, klik Simpan.

Anda juga dapat membagikan agen yang baru 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.

Menghapus agen data

Perhatian:Pengguna yang Anda bagikan agen data ini tidak akan dapat mengajukan pertanyaan baru setelah Anda menghapusnya; namun, percakapan dengan agen data akan dipertahankan.

Untuk menghapus agen data, ikuti langkah-langkah berikut:

1.Di halaman Percakapan, klik sparkKelola agen di panel kiri. 1. Buka menu untuk agen yang dipilih dengan mengklik ikon Opsi lainnya, lalu klik Hapus. 1. 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 dihapus secara permanen. Jika Anda tidak melakukan tindakan apa pun, 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 , 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 , lalu klik Pulihkan.

Referensi terkait

• Ringkasan Analisis Percakapan di Looker: Halaman landing untuk Analisis Percakapan dengan daftar link fitur utama ke semua dokumentasi Analisis Percakapan.

• Praktik terbaik untuk mengonfigurasi Analisis Percakapan di Looker: Strategi dan praktik terbaik untuk membantu administrator Looker dan developer LookML berhasil mengonfigurasi dan mengoptimalkan Analisis Percakapan.

• Mengaktifkan analisis lanjutan dengan Penafsir Kode: Penafsir Kode dalam Analisis Percakapan menerjemahkan pertanyaan natural language Anda menjadi kode Python dan menjalankan kode tersebut. Dibandingkan dengan kueri berbasis SQL standar, penggunaan Python oleh Penafsir Kode memungkinkan analisis dan visualisasi yang lebih kompleks.