סוכן

Usage

agent: agent_name {
  advanced_analytics: yes | no
  description: "string"
  instructions: "string"
  is_dashboard_agent: yes | no
  show_debuginfo: yes | no
  show_thinking: yes | no
}
היררכיה
קובץ מודל או קובץ LookML
agent
ערך ברירת המחדל
ללא

מקבל
  • ‫advanced_analytics: yes | no (ברירת המחדל היא no).
  • ‫description: מחרוזת שמתארת את הסוכן.
  • ‫instructions: מחרוזת שמציינת הנחיות מותאמות אישית וכללי התנהגות. תמיכה בקבועים של LookML‏ (@{CONSTANT_NAME}).
  • ‫is_dashboard_agent: yes | no (חובה בתור yes לסוכני מרכז בקרה).
  • ‫show_debuginfo: yes | no (ברירת המחדל היא no).
  • ‫show_thinking: yes | no (ברירת המחדל היא no).

הגדרה

הפרמטר agent מגדיר סוכן נתונים ב-LookML. בעזרת סוכני מרכז בקרה, מפתחים יכולים להגדיר הוראות מותאמות אישית לסוכן, התנהגות אנליטית והעדפות תצוגה ב-LookML עם בקרת גרסאות, ולשייך את הסוכן למרכזי בקרה של LookML באמצעות הפרמטרים default_dashboard_agent או dashboard_agents.

מידע מפורט על הגדרה ושימוש בסוכני נתונים של לוחות בקרה ב-LookML זמין במאמר יצירה וניהול של סוכני נתונים של לוחות בקרה ב-LookML.

תת-פרמטרים

הגדרות הסוכן בלוח הבקרה תומכות בפרמטרים המשניים הבאים:

advanced_analytics

פרמטר המשנה advanced_analytics קובע אם הסוכן יכול להשתמש בניתוח מתקדם כדי ליצור ולהריץ קוד Python לחישובים מורכבים ולהדמיות בהתאמה אישית.

מקבלים yes או no. ערך ברירת המחדל הוא no.

description

פרמטר המשנה description מספק תיאור טקסט אופציונלי של מטרת הסוכן.

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

instructions

בפרמטר המשנה instructions אפשר להזין מחרוזת חופשית שמספקת לסוכן הקשר הקשרי לעסק, שדות מועדפים, כללי סינון או סגנון דיבור כשמעבדים שאלות שיחה.

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

אפשר להפנות אל קבועים של LookML בתוך instructions באמצעות התחביר @{<var>CONSTANT_NAME</var>}:

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

אם לא מציינים הקשר, הסוכן פועל ללא הקשר של הוראות מותאמות אישית.

is_dashboard_agent

פרמטר המשנה is_dashboard_agent מציין אם הסוכן מוגדר כסוכן של מרכז בקרה.

מקבלים yes או no. כדי להשתמש בסוכן עם לוח בקרה של LookML, צריך להגדיר את הפרמטר הזה לערך yes.

show_debuginfo

פרמטר המשנה show_debuginfo קובע אם הסוכן יציג יומני ביצוע ומידע אבחוני בתשובות בשיחה.

מקבלים yes או no. ערך ברירת המחדל הוא no.

show_thinking

פרמטר המשנה show_thinking קובע אם הסוכן יציג את שלבי הנימוקים ותכנון השאילתות הביניים בתשובות בשיחה.

מקבלים yes או no. ערך ברירת המחדל הוא no.

דוגמאות

הגדרת סוכן של לוח בקרה ב-LookML

בדוגמה הבאה מוגדר סוכן של לוח בקרה ב-LookML עם הוראות בהתאמה אישית, ניתוח נתונים מתקדם מופעל וחשיפת תהליך החשיבה מופעלת:

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
}

כדי להשתמש בסוכן הזה במרכז שליטה של LookML, צריך למפות אותו בקובץ .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]