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 mendeskripsikan agen.
  • instructions: String yang menentukan perintah kustom dan aturan perilaku. Mendukung konstanta LookML (@{CONSTANT_NAME}).
  • is_dashboard_agent: yes | no (Diperlukan sebagai yes untuk agen dasbor).
  • show_debuginfo: yes | no (Defaultnya adalah no).
  • show_thinking: yes | no (Defaultnya adalah no).

Definisi

Parameter agent menentukan agen data untuk dasbor LookML. Developer dapat menggunakan parameter ini dan subparameternya untuk menentukan petunjuk agen kustom, perilaku analitis, dan preferensi tampilan dalam LookML yang dikontrol versinya untuk satu agen yang terkait dengan satu dasbor LookML.

Developer dapat mengaitkan agen dasbor dengan satu dasbor LookML menggunakan parameter default_dashboard_agent.

Agen data untuk dasbor yang ditentukan pengguna atau untuk Eksplorasi tidak dapat ditentukan di LookML.

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

Subparameter

Definisi agen dasbor mendukung subparameter berikut:

advanced_analytics

Subparameter advanced_analytics mengontrol apakah agen dapat menggunakan Analytics Lanjutan untuk membuat dan menjalankan kode Python untuk komputasi yang 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 memberikan konteks bisnis, kolom pilihan, aturan pemfilteran, atau gaya bahasa kepada agen 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 tidak disertakan, 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 proses berpikir 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
  enabled_dashboard_agents: true
  default_dashboard_agent: customer_insights_agent

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