סוכן

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.

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

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

מידע מפורט על הגדרה ושימוש בסוכני לוחות בקרה של 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
  enabled_dashboard_agents: true
  default_dashboard_agent: customer_insights_agent

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