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 memasukkan logika bisnis yang disesuaikan, petunjuk kustom, dan setelan analisis ke dalam dasbor yang dikelola LookML. Setiap dasbor menyediakan satu agen default bersama yang tersedia untuk semua pengguna yang memiliki izin untuk melakukan chat dengan dasbor. 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 dapat menggunakan Conversational Analytics untuk berinteraksi dengan data dasbor, pastikan penyiapan dan persyaratan untuk instance Looker Anda telah terpenuhi dan Anda telah diberi izin yang sesuai untuk melakukan tugas yang dijelaskan di halaman ini.

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 (defaultnya adalah no). Jika ditetapkan ke yes, agen dapat menggunakan Advanced Analytics untuk menerjemahkan pertanyaan natural language menjadi kode Python dan mengeksekusi 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) Tetapkan 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.

Agen di dasbor LookML tidak mendukung kueri terverifikasi.

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 Anda 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 di 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 tingkat 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 with this dashboard 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 secara iteratif mengubah petunjuk agen dan menguji respons 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 pengukuran yang di-deploy ke produksi.
  2. Aktifkan Mode Pengembangan.
  3. Edit instructions atau setelan agen di file LookML Anda, lalu simpan perubahan.
  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.

Saat Mode Pengembangan diaktifkan, Conversational Analytics akan merujuk ke definisi agen dalam memori, definisi dasbor LookML, dan file model dari cabang pengembangan Anda. Saat Anda menonaktifkan Mode Pengembangan, Conversational Analytics akan kembali merujuk ke definisi yang di-deploy dari cabang produksi.

Histori percakapan apa pun 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 Dashboard actions, lalu pilih Get 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 aktif, Anda dapat memeriksa konfigurasi agen dari panel chat:

  1. Pilih spark Chat with this dashboard.
  2. Pilih tune Kelola agen.

Untuk dasbor LookML, panel Manage agent menampilkan petunjuk agen, status Advanced Analytics, dan opsi debug dalam mode hanya baca. Setelan tidak dapat diedit langsung dalam UI.

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

Membuat kueri 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 Ask a question, masukkan kueri Anda dalam bahasa alami.
  4. Jika show_thinking diizinkan untuk agen dasbor, Anda dapat memilih mode pertanyaan:
    • Cepat: Menerjemahkan kueri Anda dengan cepat menjadi pencarian metrik LookML langsung.
    • Penalaran: Mengevaluasi pertanyaan analisis 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 delete 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.
  • Kueri terverifikasi tidak didukung: Agen data untuk dasbor LookML tidak mendukung kueri terverifikasi.
  • 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 Eksplorasi. Semua pernyataan agent di LookML harus menyertakan is_dashboard_agent: yes.
  • Advanced Analytics 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 dibuat saat dalam Mode Pengembangan pada konfigurasi agen dasbor LookML yang belum di-deploy ke produksi.