יצירה וניהול של סוכני נתונים למרכזי בקרה של LookML

ניתוח נתונים באמצעות צ'אט, שמבוסס על Gemini Google Cloud, מאפשר לכם לבדוק את הנתונים על ידי שאילת שאלות בשפה טבעית בממשק צ'אט אינטואיטיבי. כשמשתמשים בניתוח נתונים של שיחות עם מרכז שליטה של LookML, אפשר להגדיר ולערוך סוכן נתונים ישירות בקוד LookML שמנוהל בגרסאות.

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

בדף הזה מפורטים הנושאים הבאים:

לפני שמתחילים

כדי להשתמש בניתוח נתונים באמצעות שיחה כדי לנהל אינטראקציה עם הנתונים במרכז הבקרה, ודאו שההגדרה והדרישות של המכונה שלכם ב-Looker הושלמו ושיש לכם את ההרשאות המתאימות לביצוע המשימות שמתוארות בדף הזה.

הגדרת סוכן למרכז בקרה ב-LookML

כדי להגדיר סוכן ללוח בקרה ב-LookML, צריך להצהיר על הפרמטר agent בקובץ מודל LookML או בקובץ LookML ייעודי בפרויקט.

הגדרת סוכן של מרכז שליטה של LookML משתמשת בתחביר הבא:

agent: agent_name {
  advanced_analytics: yes | no
  description: "Description of the agent"
  instructions: "Custom agent prompt and instructions"
  is_dashboard_agent: yes
  show_debuginfo: yes | no
  show_thinking: yes | no
}

סוכני מרכז הבקרה תומכים בפרמטרים הבאים של LookML:

  • ‫agent: מגדיר סוכן חדש ומגדיר את השם שלו.
  • ‫advanced_analytics: (אופציונלי) מקבל את הערכים yes או no (ברירת המחדל היא no). אם הערך הוא yes, הסוכן יכול להשתמש בניתוח מתקדם כדי לתרגם שאלות בשפה טבעית לקוד Python ולהריץ את הקוד הזה לחישובים מתקדמים ולתצוגות חזותיות. הפרמטר הזה זמין לסוכני מרכז שליטה של LookML, אבל הוא לא פועל ב-Looker 26.14.
  • ‫description: (אופציונלי) תיאור קצר של הנציג.
  • instructions: (אופציונלי) מחרוזת שמספקת הוראות בפריסה גמישה והקשר עסקי כדי להנחות את הסוכן כשהוא עונה על שאילתות. אם לא תגדירו את ההנחיה, הנציג ישתמש בעיבוד ברירת המחדל של השיחה בלי הקשר של הנחיה בהתאמה אישית.
  • ‫is_dashboard_agent: (חובה לנציגי מרכז הבקרה) מגדירים את הערך yes כדי לזהות את הנציג באופן ספציפי כנציג מרכז הבקרה.
  • ‫show_debuginfo: (אופציונלי) מקבל את הערכים yes או no (ברירת המחדל היא no). אם הערך הוא yes, הסוכן מציג בשיחה תשובות עם מידע מפורט על הביצוע ופתרון הבעיות.
  • ‫show_thinking: (אופציונלי) מקבל את הערכים yes או no (ברירת המחדל היא no). אם הערך הוא yes, הסוכן מציג בתשובות שלו את תהליך החשיבה המפורט.

נציגים במרכזי שליטה של LookML לא תומכים בשאילתות מאומתות.

דוגמה להגדרת סוכן בלוח בקרה

בדוגמה הבאה מוגדר סוכן של מרכז שליטה של LookML שאוכף כללי סינון וסגנון ספציפיים:

agent: sales_dashboard_agent {
  instructions: "Focus on revenue metrics. Always filter by the current fiscal year unless the user specifies otherwise."
  description: "LookML Dashboard Agent for sales performance analytics."
  is_dashboard_agent: yes
  advanced_analytics: yes
  show_thinking: yes
  show_debuginfo: no
}

שימוש בקבועי LookML בהוראות לסוכנים

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

כדי להשתמש בקבוע בהוראות לסוכן:

  1. מגדירים את הקבוע בקובץ manifest.lkml של הפרויקט:

    constant: FISCAL_YEAR_RULE {
  value: "Always filter all requests by the current fiscal year unless the user explicitly specifies a different timeframe."
}

  2. מפנים לקבוע בפרמטר instructions של סוכן מרכז הבקרה באמצעות התחביר @{<var>CONSTANT_NAME</var>}:

    agent: finance_dashboard_agent {
  instructions: "Prioritize gross margin and operating expense metrics. @{FISCAL_YEAR_RULE}"
  is_dashboard_agent: yes
  advanced_analytics: yes
}

כשהנציג מעבד שאילתות, Looker מחליף באופן דינמי את המחרוזת הקבועה בהוראות לנציג.

שיוך של סוכן מרכז בקרה למרכז בקרה של LookML

כדי לצרף סוכן לוח בקרה למרכז שליטה של LookML, צריך להגדיר את הפרמטרים ברמת לוח הבקרה בקובץ .dashboard.lookml.

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

  • ‫enabled_dashboard_agent: (אופציונלי) מקבל את הערכים true או false. ההגדרה הזו קובעת אם המשתמשים יכולים לראות את הסמל ניצוץ צ'אט עם מרכז הבקרה הזה ולקיים אינטראקציה עם הסוכן של מרכז הבקרה. אם משמיטים את הפרמטר הזה, ערך ברירת המחדל שלו הוא true בשכבת ה-API.
  • ‫default_dashboard_agent: (אופציונלי) מציין את השם של סוכן LookML (מוגדר באמצעות הפרמטר agent) שמשמש כסוכן ברירת המחדל של לוח הבקרה.

הגדרה לדוגמה של מרכז שליטה של LookML

בקטע הקוד הבא אפשר לראות איך ממפים את sales_dashboard_agent למרכז שליטה של LookML:

- dashboard: executive_sales_overview
  title: "Executive Sales Overview"
  layout: newspaper
  enabled_dashboard_agent: true
  default_dashboard_agent: sales_dashboard_agent

  elements:
  - name: total_revenue_by_quarter
    type: looker_column
    model: sales_ops
    explore: orders
    measures: [orders.total_revenue]
    dimensions: [orders.created_quarter]

אם המדיניות enabled_dashboard_agent מוגדרת לערך true ולא צוינה מדיניות default_dashboard_agent, המשתמשים עדיין יכולים להתכתב בצ'אט עם מרכז הבקרה, והנציג יפעל בלי הוראות בהתאמה אישית.

בדיקת סוכני מרכז שליטה של LookML במצב פיתוח

אם הסוכן כבר נפרס בסביבת הייצור, מפתחי LookML יכולים לשנות את ההוראות לסוכן באיטרציות ולבדוק את התשובות ישירות בממשק המשתמש של Looker לפני פריסת השינויים בסביבת הייצור.

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

  1. חשוב לוודא שהסוכן כולל לפחות הגדרה בסיסית שנפרסה בסביבת הייצור.
  2. מפעילים את מצב פיתוח.
  3. עורכים את הנציג instructions או את ההגדרות בקובץ LookML ושומרים את השינויים.
  4. פותחים את מרכז השליטה של LookML בממשק המשתמש של Looker.
  5. לוחצים על spark צ'אט עם מרכז הבקרה הזה כדי לפתוח את חלונית הצ'אט.
  6. שואלים שאלות כדי לבדוק איך הסוכן מפרש את ההנחיות ומגיב להן.

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

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

העתקת LookML של סוכן מרכז הבקרה מלוחות בקרה בהגדרת המשתמש

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

כדי להעתיק LookML מלוח בקרה בהגדרת המשתמש:

  1. פותחים את לוח הבקרה בהגדרת המשתמש.
  2. לוחצים על תפריט האפשרויות הנוספות (3 נקודות) more_vert
  3. בתיבת הדו-שיח Get LookML, מעתיקים את קוד ה-LookML שנוצר למרכז הבקרה ואת קוד ההגדרה של סוכן מרכז הבקרה.
  4. מדביקים את קוד ה-LookML של לוח הבקרה בקובץ .dashboard.lookml ומדביקים את הבלוק agent בקובץ המודל או בקובץ ה-LookML של הסוכן.

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

הצגת פרטי הסוכן בממשק המשתמש של Looker

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

  1. לוחצים על סמל הניצוץ צ'אט עם מרכז הבקרה הזה.
  2. לוחצים על tune ניהול הסוכן.

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

כדי לערוך את ההגדרה, מפתחים עם הרשאה develop במודלים הבסיסיים יכולים ללחוץ על עריכה ב-LookML כדי לעבור ישירות לקובץ LookML הרלוונטי ב-IDE.

שליחת שאילתה למרכז שליטה של LookML באמצעות סוכן של מרכז שליטה

כדי להתחיל שיחה עם סוכן מרכז שליטה של LookML:

  1. פותחים את מרכז השליטה של LookML.
  2. לוחצים על spark צ'אט עם מרכז הבקרה הזה.
  3. בשדה Ask a question (שליחת שאלה), מזינים את השאילתה בשפה טבעית.
  4. אם סוכן לוח הבקרה show_thinking מורשה, אפשר לבחור מצב שאלה:
    • מהירות: מתרגם במהירות את השאילתה לחיפושים ישירים של מדדי LookML.
    • העמקה: מעריך שאלות אנליטיות מורכבות ומציג חשיבה רציונלית שלב אחר שלב.
  5. לוחצים על סמל השליחה .

כדי לבטל שאילתה שנמצאת בתהליך, לוחצים על הפסקת התשובה.

ניהול השיחות

  • שיחות מהזמן האחרון: כדי לפתוח שיחות קודמות, לוחצים על more_vert > תפריט > שיחות מהזמן האחרון.
  • לשנות את שם השיחה: לוחצים על סמל האפשרויות הנוספות more_vert ליד השיחה ובוחרים באפשרות edit שינוי שם.
  • מחיקת שיחה: לוחצים על סמל האפשרויות הנוספות more_vert לצד השיחה ובוחרים באפשרות מחיקה מחיקה.

המגבלות של סוכני מרכזי שליטה של LookML

לסוכני מרכז השליטה של LookML יש את המגבלות הבאות:

  • מוגדרים ב-LookML בלבד: צריך להצהיר על סוכני מרכז השליטה של LookML ב-LookML. אי אפשר ליצור, להגדיר או לערוך אותם בממשק המשתמש של Looker.
  • אין תמיכה בשאילתות מאומתות: סוכני נתונים למרכזי שליטה של LookML לא תומכים בשאילתות מאומתות.
  • דרישה לאותו פרויקט: צריך להגדיר את הסוכן באותו פרויקט של LookML שבו נמצא לוח הבקרה שמפנה אליו.
  • סוכן אחד לכל מרכז שליטה: אפשר לשייך רק סוכן אחד למרכז שליטה של LookML.
  • סוכנים של מרכזי בקרה בלבד: ב-LookML אין תמיכה ביצירת סוכנים לחקירת נתונים. כל ההצהרות של agent ב-LookML חייבות לכלול את is_dashboard_agent: yes.
  • ניתוח מתקדם ב-Looker 26.14: סוכני מרכז שליטה של LookML ב-Looker 26.14 לא תומכים בפרמטר advanced_analytics.
  • מצב פיתוח וסוכנים שלא נפרסו: ממשק השיחה מתעלם מכל שינוי שבוצע במצב פיתוח בהגדרות של סוכני מרכז השליטה של LookML שעדיין לא נפרסו בסביבת הייצור.