Membuat dan mengelola agen data

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

Halaman ini memandu Anda melalui proses berikut:

• Membuat dan mengedit agen data
• Membagikan agen data kepada pengguna lain
• Menghapus agen data

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

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 Conversations.
2. Di tab Agents, pilih + New agent. Atau, di panel kiri, pilih sparkManage agents, lalu pilih + New agent.

3. Di halaman New agent, 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 + Select Explores.
     2. Di jendela Search Explores, 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 Save.

4. Instruksi: 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 Enable Advanced Analytics.

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

7. Untuk menyimpan agen data baru, klik Save.

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 yang perlu dipertimbangkan sebelum memproses perintah pengguna.

Penting: Meskipun kolom Instructions 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 Instructions:

• 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 jenis konteks yang dapat Anda berikan kepada agen yang Anda buat menggunakan Conversational Analytics API. Beberapa hal yang Anda berikan di kolom Instructions 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 Explore actions , lalu pilih Get LookML.
2. Pilih tab Dashboard.
3. Salin detail kueri dari LookML. Misalnya, gambar berikut menunjukkan LookML untuk Eksplorasi yang disebut Order Items:

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 Preview your agent. Anda dapat menguji setelan dan petunjuk agen dengan memulai percakapan dengan agen.

Anda harus mengklik Update 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 Conversations, pilih sparkManage agents.
2. Di halaman Manage agents, pilih agen data yang ingin Anda edit.
3. Perbarui detail tentang agen sesuai kebutuhan. Anda dapat mengubah detail yang Anda tentukan saat Anda membuat agen, termasuk kolom Agent name, Agent description, Data, dan Instructions. Anda juga dapat memilih untuk mengaktifkan Penafsir Kode untuk agen Anda.
4. Untuk menyimpan perubahan, klik Update.

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 kepada pengguna ke agen tidak memberikan akses kepada 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 Conversations, pilih sparkManage agents di panel kiri.
2. Buka menu untuk agen yang dipilih dengan mengklik ikon More options, lalu klik Share.
3. Setelah Anda menambahkan individu atau grup ke bagian Who can access this agent, dan memilih tingkat izin yang harus mereka miliki, klik Add untuk menempatkan mereka dalam daftar yang dibagikan.
4. Jika Anda ingin pengguna atau grup baru menerima email notifikasi, centang kotak Email the people you have just added.
5. Setelah semua perubahan dilakukan, klik Save.

Anda juga dapat membagikan agen yang baru saja Anda buat atau agen yang sedang Anda edit dengan mengklik Share 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 Conversations, klik sparkManage agents di panel kiri.
2. Buka menu untuk agen yang dipilih dengan mengklik ikon More options, lalu klik Share.
3. Klik X di samping pengguna atau grup yang aksesnya harus dihapus.
4. Setelah semua perubahan dilakukan, klik Save.

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 menghapus agen; namun, percakapan yang ada dengan agen data akan dipertahankan.

Jika Anda menghapus agen, Anda juga akan menghapus dan membatalkan publikasi agen di Gemini Enterprise.

Untuk menghapus agen data, ikuti langkah-langkah berikut:

1.Di halaman Conversations, klik sparkManage agents di panel kiri. 1. Buka menu untuk agen yang dipilih dengan mengklik ikon More options, lalu klik Delete. 1. Di jendela Delete agent?, klik Move to trash 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 Conversations.
2. Di panel navigasi kiri, luaskan bagian Trash.
3. Untuk membuka menu agen yang dipilih, pilih ikon , lalu klik Delete Permanently.
4. Di jendela Are you sure?, klik Hapus selamanya.

Memulihkan agen data dari sampah

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

1. Buka halaman Conversations.
2. Di panel navigasi kiri, luaskan bagian Trash.
3. Untuk membuka menu agen yang dipilih, pilih ikon , lalu klik Restore.

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.