סוכן

שימוש

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]