Membuat dan mengelola agen data untuk dasbor LookML

Analisis Percakapan, yang didukung oleh Gemini untuk Google Cloud, memungkinkan Anda menyelidiki data dengan mengajukan pertanyaan dalam bahasa percakapan melalui antarmuka chat yang intuitif. Saat menggunakan Analisis Percakapan dengan dasbor LookML, Anda dapat menentukan dan menyesuaikan agen data langsung di kode LookML yang dikontrol versinya.

Agen data untuk dasbor LookML memungkinkan developer menyuntikkan logika bisnis yang disesuaikan, petunjuk kustom, dan setelan analisis ke dalam dasbor yang dikelola LookML. Karena dasbor LookML merepresentasikan sumber kebenaran yang diatur dan dikontrol versinya di seluruh organisasi, agen dasbor LookML memastikan bahwa interaksi AI tetap konsisten di seluruh lingkungan dan mematuhi standar data organisasi.

Halaman ini membahas beberapa topik berikut:

Sebelum memulai

Sebelum Anda dapat mengonfigurasi atau menggunakan agen dasbor LookML, pastikan persyaratan berikut terpenuhi:

  • Persyaratan instance: Admin Looker harus mengaktifkan Analisis Percakapan di halaman admin Gemini in Looker. Admin juga harus mengaktifkan setelan Aktifkan Fitur Penguji Tepercaya dan Agen Dasbor yang Diaktifkan. Analytics Lanjutan untuk agen dasbor, setelan admin Analytics Lanjutan juga harus diaktifkan. Setelan ini tidak berlaku untuk agen dasbor LookML di Looker 26.14.
  • Izin untuk developer: Untuk membuat, mengedit, atau mengonfigurasi agen dan dasbor LookML, Anda harus memiliki peran Looker dengan izin develop dan see_lookml_dashboards, serta akses ke model LookML yang mendasari dasbor.
  • Izin untuk pelihat: Untuk memulai percakapan dengan agen dasbor LookML, pengguna harus memiliki izin see_lookml_dashboards dan akses ke model LookML yang mendasari kartu dasbor.

Menentukan agen dasbor di LookML

Untuk menentukan agen dasbor di LookML, deklarasikan parameter agent dalam file model LookML atau file LookML khusus dalam project Anda.

Definisi agen dasbor LookML menggunakan sintaksis berikut:

agent: agent_name {
  advanced_analytics: yes | no
  description: "Description of the agent"
  instructions: "Custom agent prompt and instructions"
  is_dashboard_agent: yes
  show_debuginfo: yes | no
  show_thinking: yes | no
}

Agen dasbor mendukung parameter LookML berikut:

  • agent: Mendeklarasikan agen baru dan menentukan namanya.
  • advanced_analytics: (Opsional) Menerima yes atau no (default adalah no). Jika disetel ke yes, agen dapat menggunakan Analytics Lanjutan untuk menerjemahkan pertanyaan natural language menjadi kode Python dan menjalankan kode tersebut untuk komputasi dan visualisasi lanjutan. Parameter ini tersedia untuk agen dasbor LookML; namun, parameter ini tidak berfungsi di Looker 26.14.
  • description: (Opsional) Deskripsi singkat tentang agen.
  • instructions: (Opsional) String yang memberikan petunjuk bentuk bebas dan konteks bisnis untuk memandu agen saat menjawab kueri. Jika tidak ada, agen akan menggunakan pemrosesan percakapan default tanpa konteks perintah kustom.
  • is_dashboard_agent: (Wajib untuk agen dasbor) Setel ke yes untuk mengidentifikasi agen secara khusus sebagai agen dasbor.
  • show_debuginfo: (Opsional) Menerima yes atau no (default adalah no). Jika disetel ke yes, agen akan menampilkan informasi eksekusi dan pemecahan masalah yang mendetail dalam respons percakapan.
  • show_thinking: (Opsional) Menerima yes atau no (default-nya adalah no). Jika disetel ke yes, agen akan menampilkan proses penalaran langkah demi langkah dalam respons percakapan.

Contoh definisi agen dasbor

Contoh berikut menentukan agen dasbor LookML yang menerapkan aturan pemfilteran dan gaya bahasa tertentu:

agent: sales_dashboard_agent {
  instructions: "Focus on revenue metrics. Always filter by the current fiscal year unless the user specifies otherwise."
  description: "LookML Dashboard Agent for sales performance analytics."
  is_dashboard_agent: yes
  advanced_analytics: yes
  show_thinking: yes
  show_debuginfo: no
}

Menggunakan konstanta LookML dalam petunjuk agen

Jika mengelola beberapa dasbor LookML di seluruh organisasi, Anda dapat menggunakan konstanta LookML untuk membagikan aturan bisnis standar, glosarium, atau persyaratan pemfilteran di seluruh definisi agen tanpa menduplikasi teks.

Untuk menggunakan konstanta dalam petunjuk agen, ikuti langkah-langkah berikut:

  1. Tentukan konstanta dalam file manifest.lkml project Anda:

    constant: FISCAL_YEAR_RULE {
  value: "Always filter all requests by the current fiscal year unless the user explicitly specifies a different timeframe."
}

  2. Referensi konstanta dalam parameter instructions agen dasbor Anda menggunakan sintaksis @{<var>CONSTANT_NAME</var>}:

    agent: finance_dashboard_agent {
  instructions: "Prioritize gross margin and operating expense metrics. @{FISCAL_YEAR_RULE}"
  is_dashboard_agent: yes
  advanced_analytics: yes
}

Saat agen memproses kueri, Looker akan mengganti string konstanta secara dinamis ke dalam petunjuk agen.

Mengaitkan agen dasbor dengan dasbor LookML

Untuk melampirkan agen dasbor ke dasbor LookML, konfigurasikan parameter level dasbor dalam file .dashboard.lookml.

Parameter dasbor berikut mengontrol perilaku agen untuk dasbor LookML:

  • enabled_dashboard_agent: (Opsional) Menerima true atau false. Menentukan apakah pengguna dapat melihat ikon spark Chat dengan dasbor ini dan berinteraksi dengan agen dasbor. Jika dihilangkan, parameter ini akan ditetapkan secara default ke true di lapisan API.
  • default_dashboard_agent: (Opsional) Menentukan nama agen LookML (ditentukan dengan parameter agent) yang berfungsi sebagai agen default untuk dasbor.

Contoh konfigurasi dasbor LookML

Cuplikan berikut menunjukkan cara memetakan sales_dashboard_agent ke dasbor LookML:

- dashboard: executive_sales_overview
  title: "Executive Sales Overview"
  layout: newspaper
  enabled_dashboard_agent: true
  default_dashboard_agent: sales_dashboard_agent

  elements:
  - name: total_revenue_by_quarter
    type: looker_column
    model: sales_ops
    explore: orders
    measures: [orders.total_revenue]
    dimensions: [orders.created_quarter]

Jika enabled_dashboard_agent disetel ke true dan tidak ada default_dashboard_agent yang ditentukan, pengguna tetap dapat memulai percakapan dengan dasbor; agen akan berjalan tanpa petunjuk kustom.

Menguji agen dasbor LookML dalam Mode Pengembangan

Jika agen telah di-deploy ke produksi, developer LookML dapat memodifikasi petunjuk agen dan menguji respons secara iteratif langsung di UI Looker sebelum men-deploy perubahan ke produksi.

Untuk menguji perubahan pada agen dasbor LookML dari Mode Pengembangan, ikuti langkah-langkah berikut:

  1. Pastikan agen memiliki setidaknya definisi dasar yang di-deploy ke produksi.
  2. Aktifkan Mode Pengembangan.
  3. Edit instructions atau setelan agen di file LookML Anda, lalu simpan perubahan Anda.
  4. Buka dasbor LookML di UI Looker.
  5. Pilih kilauan Chat dengan dasbor ini untuk membuka panel chat.
  6. Ajukan pertanyaan untuk menguji cara agen menafsirkan dan merespons perintah Anda.

Jika Mode Pengembangan diaktifkan, Analisis Percakapan akan mereferensikan definisi agen dalam memori, definisi dasbor LookML, dan file model dari cabang pengembangan Anda. Saat Anda menonaktifkan Mode Pengembangan, Analisis Percakapan akan kembali merujuk pada definisi yang di-deploy dari cabang produksi.

Histori percakapan yang dibuat selama Mode Pengembangan akan tetap ada dan terlihat di daftar percakapan terbaru Anda di seluruh sesi.

Menyalin LookML agen dasbor dari dasbor yang ditentukan pengguna

Jika Anda membuat prototipe dasbor sebagai dasbor yang ditentukan pengguna di UI, Anda dapat mengekspor konfigurasi lengkapnya—termasuk setelan dan petunjuk agen dasbor—ke dalam kode LookML.

Untuk menyalin LookML dari dasbor yang ditentukan pengguna:

  1. Buka dasbor yang ditentukan pengguna.
  2. Pilih menu tiga titik more_vert Tindakan dasbor, lalu pilih Dapatkan LookML.
  3. Dalam dialog Get LookML, salin LookML dasbor yang dihasilkan dan kode definisi agen dasbor.
  4. Tempelkan LookML dasbor ke file .dashboard.lookml, dan tempelkan blok agent ke file LookML model atau agen Anda.

LookML yang diekspor mempertahankan status tombol Aktifkan chat dengan dasbor dengan menggunakan nilai parameter enabled_dashboard_agent bersama dengan petunjuk agen kustom.

Melihat detail agen di UI Looker

Saat melihat dasbor LookML dengan agen dasbor yang aktif, Anda dapat memeriksa konfigurasi agen dari panel chat:

  1. Pilih spark Chat dengan dasbor ini.
  2. Pilih tune Kelola agen.

Untuk dasbor LookML, panel Kelola agen menampilkan petunjuk agen, status Analisis Lanjutan, dan opsi debug dalam mode hanya baca. Setelan tidak dapat diedit langsung di dalam UI.

Untuk mengedit konfigurasi, developer dengan izin develop pada model pokok dapat mengklik Edit di LookML untuk membuka langsung file LookML yang relevan di IDE.

Mengkueri dasbor LookML dengan agen dasbor

Untuk memulai percakapan dengan agen dasbor LookML:

  1. Buka dasbor LookML.
  2. Pilih spark Chat dengan dasbor ini.
  3. Di kolom Ajukan pertanyaan, masukkan kueri Anda dalam bahasa alami.
  4. Jika show_thinking diizinkan untuk agen dasbor Anda, Anda dapat memilih mode pertanyaan:
    • Cepat: Menerjemahkan kueri Anda dengan cepat menjadi pencarian metrik LookML langsung.
    • Pemikiran: Mengevaluasi pertanyaan analitis yang kompleks dan menampilkan penalaran langkah demi langkah.
  5. Klik kirim Kirim.

Untuk membatalkan kueri yang sedang berlangsung, klik Hentikan respons.

Mengelola percakapan

  • Percakapan terbaru: Untuk membuka percakapan sebelumnya, pilih more_vert Menu > Percakapan terbaru.
  • Mengganti nama percakapan: Pilih more_vert di samping percakapan, lalu pilih edit Ganti nama.
  • Menghapus percakapan: Pilih more_vert di samping percakapan, lalu pilih hapus Hapus.

Batasan agen dasbor LookML

Agen dasbor LookML memiliki batasan berikut:

  • Hanya ditentukan di LookML: Agen dasbor LookML harus dideklarasikan di LookML. Anda tidak dapat membuat, mengonfigurasi, atau mengeditnya di UI Looker.
  • Persyaratan project yang sama: Agen harus ditentukan dalam project LookML yang sama dengan dasbor yang mereferensikannya.
  • Satu agen per dasbor: Anda hanya dapat mengaitkan satu agen dasbor dengan dasbor LookML.
  • Khusus agen dasbor: LookML tidak mendukung pembuatan agen data Jelajah. Semua deklarasi agent di LookML harus menyertakan is_dashboard_agent: yes.
  • Analytics Lanjutan di Looker 26.14: Agen dasbor LookML di Looker 26.14 tidak mendukung parameter advanced_analytics.
  • Mode Pengembangan dan agen yang belum di-deploy: Antarmuka percakapan mengabaikan perubahan apa pun yang dilakukan saat berada dalam Mode Pengembangan pada konfigurasi agen dasbor LookML yang belum di-deploy ke produksi.