agen

Penggunaan

agent: agent_name {
  advanced_analytics: yes | no
  description: "string"
  instructions: "string"
  is_dashboard_agent: yes | no
  show_debuginfo: yes | no
  show_thinking: yes | no
}
Hierarki
File model atau file LookML
agent
Nilai default
Tidak ada

Menerima
  • advanced_analytics: yes | no (Defaultnya adalah no).
  • description: String yang menjelaskan agen.
  • instructions: String yang menentukan perintah kustom dan aturan perilaku. Mendukung konstanta LookML (@{CONSTANT_NAME}).
  • is_dashboard_agent: yes | no (Wajib sebagai yes untuk agen dasbor).
  • show_debuginfo: yes | no (Defaultnya adalah no).
  • show_thinking: yes | no (Defaultnya adalah no).

Definisi

Parameter agent mendeklarasikan agen data di LookML. Dengan agen dasbor, developer dapat menentukan petunjuk agen kustom, perilaku analisis, dan preferensi tampilan di LookML yang dikontrol versi serta mengaitkan agen dengan dasbor LookML menggunakan parameter default_dashboard_agent atau dashboard_agents.

Untuk mengetahui informasi mendetail tentang cara mengonfigurasi dan menggunakan agen dasbor LookML, lihat halaman dokumentasi Membuat dan mengelola agen data dasbor LookML.

Subparameter

Definisi agen dasbor mendukung subparameter berikut:

advanced_analytics

Subparameter advanced_analytics mengontrol apakah agen dapat menggunakan Analisis Lanjutan untuk membuat dan menjalankan kode Python untuk komputasi kompleks dan visualisasi kustom.

Menerima yes atau no. Nilai defaultnya adalah no.

description

Subparameter description memberikan deskripsi teks opsional tentang tujuan agen.

agent: sales_agent {
  description: "Executive sales overview dashboard agent"
  is_dashboard_agent: yes
}

instructions

Subparameter instructions menerima string bentuk bebas yang memberi agen konteks bisnis, kolom pilihan, aturan pemfilteran, atau gaya bahasa saat memproses pertanyaan percakapan.

agent: sales_agent {
  instructions: "Focus on net revenue and filter by current quarter by default."
  is_dashboard_agent: yes
}

Anda dapat mereferensikan konstanta LookML dalam instructions menggunakan sintaksis @{<var>CONSTANT_NAME</var>}:

agent: sales_agent {
  instructions: "Focus on net revenue. @{FISCAL_YEAR_RULE}"
  is_dashboard_agent: yes
}

Jika dihilangkan, agen akan beroperasi tanpa konteks petunjuk kustom.

is_dashboard_agent

Subparameter is_dashboard_agent menentukan apakah agen dikonfigurasi sebagai agen dasbor.

Menerima yes atau no. Untuk menggunakan agen dengan dasbor LookML, tetapkan parameter ini ke yes.

show_debuginfo

Subparameter show_debuginfo menentukan apakah agen menampilkan log eksekusi dan informasi diagnostik dalam respons percakapan.

Menerima yes atau no. Nilai defaultnya adalah no.

show_thinking

Subparameter show_thinking menentukan apakah agen menampilkan langkah-langkah penalaran dan perencanaan kueri perantara dalam respons percakapan.

Menerima yes atau no. Nilai defaultnya adalah no.

Contoh

Menentukan agen dasbor LookML

Contoh berikut menentukan agen dasbor LookML dengan petunjuk kustom, Analisis Lanjutan diaktifkan, dan visibilitas pemikiran diaktifkan:

agent: customer_insights_agent {
  instructions: "Address the user politely. Prioritize active subscriber metrics and churn analysis."
  description: "Dashboard agent for Customer Insights dashboard."
  is_dashboard_agent: yes
  advanced_analytics: yes
  show_thinking: yes
  show_debuginfo: no
}

Untuk menggunakan agen ini di dasbor LookML, petakan di file .dashboard.lookml:

- dashboard: customer_insights
  title: "Customer Insights"
  layout: newspaper
  enable_dashboard_agent: true
  default_dashboard_agent: customer_insights_agent
  dashboard_agents: [customer_insights_agent]

  elements:
  - name: active_subscribers
    type: single_value
    model: subscriptions
    explore: customers
    measures: [customers.count]