Membuat dan mengelola agen data

Agen data memungkinkan Anda mengelola pengalaman Analisis Percakapan untuk data Anda. Dengan agen, Anda dapat memberikan konteks dan petunjuk kepada Analisis Percakapan agar dapat menjawab pertanyaan dengan 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 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 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
• Sinonim: Istilah alternatif untuk kolom utama
• Kueri terbaik: Pasangan pertanyaan bahasa alami dan kueri Eksplorasi yang sesuai
• Persona: Peran atau keahlian, karakter, atau nada yang Anda tetapkan ke agen

Tips: Jika memiliki peran Looker yang memungkinkan Anda mengedit LookML, Anda dapat menentukan sinonim untuk kolom di Eksplorasi menggunakan parameter LookML synonyms.

Berikut beberapa contoh petunjuk untuk disesuaikan dan diuji dengan agen Anda:

Agent Instructions

You are an expert e-commerce analyst. When answering questions about our sales
data, adhere to the following definitions and patterns:

Default Filtering: Unless stated otherwise, always filter the data on Order
Items Created Year = 2024. Customer Loyalty: We consider "loyal" customers to be
those with Order Items Count > 5. Business Terms:  "Successful" orders are those
where Order Items status = "Complete".  "Revenue" always refers to the Total
Sales field.  "Location" means User City. Grouping Rules: When someone says "by
product", unless they specifically say "name", group by product category.

Looker Golden Queries

Pay close attention to the patterns in the provided golden query below. Use it
as a primary reference for generating Looker queries that are
related to revenue and order status:

Question: "How much revenue did we generate from successful orders in 2024?"
Looker query:
    Model: thelook_ecommerce
    Explore: order_items
    Fields: [order_items.total_sales]
    Filters: [{field: order_items.status, value: "Complete"},
    {field: order_items.created_year, value: "2024"}]

Always keep these patterns and definitions in mind when generating your answers.

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, setiap 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 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 agen dibuat, mungkin perlu waktu beberapa menit agar agen 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 yang dibagikan.
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 saja dibuat 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 ajak berbagi 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 bahasa alami 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.