הצגת תשובות של סוכנים למקורות נתונים של Looker

במדריך הזה מתוארות גישות מומלצות להצגת פלט מ-Conversational Analytics API בממשק משתמש (UI) באמצעות מקורות נתונים של Looker.

כשמשתמש שולח שאילתה ל-API, התשובה יכולה לכלול שלבי ביניים של חשיבה רציונלית בנוסף לתשובה הסופית. במדריך הזה נסביר איך להציג תגובות מה-API עם רמות שונות של פירוט באמצעות הטמעה של תצוגת תשובה ראשית ותצוגת פרטים מלאים:

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

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

תצוגת התשובה הראשית

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

הנחיות לעיבוד הודעות מהמערכת

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

הודעה מהמערכת הנחיות לגבי רינדור
DataQuery הצגת התוצאה המשויכת. ההודעה הזו תוצג רק במקרים שבהם מוצגת ההודעה התואמת DataResult.

אל תציגו הודעות DataQuery במקרים הבאים:
  • השדה name של ההודעה DataQuery מסתיים ב-_sample_values (לדוגמה, products_brand_sample_values).
  • השדה name של ההודעה התואמת DataResult מסתיים ב-_sample_values.
  • השדה data בהודעה התואמת DataResult ריק.
מומלץ להציב את הטקסט של השאילתה בתוך מתג כדי להציג את שאילתת המקור לפי דרישה. לדוגמה, ב-Conversational Analytics in Looker יש אמצעי בקרה עם הכיתוב 'איך זה חושב?'.
DataResult הצגת כל ההודעות DataResult, למעט תוצאות ביניים ותוצאות ריקות.

אל תציגו הודעות DataResult במקרים הבאים:
  • השדה name יפסיק לפעול בתאריך _sample_values. אלה שלבים ביניים לאחזור ערכים לדוגמה בשדה ספציפי.
  • השדה data ריק. התוצאות האלה מסוכמות בתגובה הסופית של TextMessage.
ChartResult עיבוד כל התרשימים. הצגת כל ההודעות ChartResult בתשובת ה-API.
TextMessage הצגת תשובות סופיות בלבד. הצגת הודעות TextMessage רק כשהערך של TextType הוא FINAL_RESPONSE.

דוגמה: Render the main answer view

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

מתג עם התווית 'הצגת הנימוקים' במצב מכווץ.

בתמליל הבא מוצגת תצוגת התשובה הראשית. ב-DataQuery הודעות, מומלץ להסתיר את פרטי השאילתה מאחורי מתג מוטבע, שמסומן בתמליל באמצעות סמל מכווץ (), כדי לספק גישה אופציונלית ללוגיקה הבסיסית של השאילתה.

משתמש: השוואה בין סך המכירות של Cymbal Group בשנת 2022 לבין סך המכירות בשנת 2023. שרטוט התוצאה בתרשים.

Agent:

הנה תוצאת השאילתה של Total Sales Cymbal Group 2022 2023.

שנת היצירה סה"כ מכירות
2023 $96,627.00
2022 $93,095.50

Total Sales for Cymbal Group in 2022 and 2023

תרשים עמודות שמשווה בין נתוני המכירות לשנים 2022 ו-2023.

סך המכירות של Cymbal Group בשנת 2022 היה 93,095.50$ ובשנת 2023 הוא היה 96,627.00$.

בטבלה הבאה מפורטים הרכיבים מהאינטראקציה לדוגמה וההודעות המקבילות שלהם במערכת ה-API.

רכיב הודעת המקור
שאילתה שנוצרה (קובץ JSON מוסתר מאחורי המתג כברירת מחדל) DataQuery
טבלת נתונים DataResult
תרשים עמודות ChartResult
התשובה הסופית בטקסט TextMessage (FINAL_RESPONSE)

תצוגת פרטים מלאים

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

הנחיות לגבי עיבוד לצורך הסקת מסקנות ואחזור נתונים מפורטים

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

הודעה מהמערכת הנחיות לגבי רינדור
‫TextMessage עם ערך TextType של THOUGHT הצגת שלבי הנימוק. ההודעות האלה מוצגות כדי להראות את תהליך החשיבה הפנימי של הסוכן. ההודעות האלה כוללות שני חלקים:
  • ‫parts[0] הוא סיכום המחשבה, שבו יש סיכום קצר של טקסט המחשבה המלא
  • ‫parts[1] הוא הטקסט המלא של המחשבה
אם האפליקציה מציגה עדכוני סטטוס (כמו אינדיקטור טעינה או סרגל התקדמות), מומלץ להציג את סיכום המחשבות (parts[0]) כאינדיקטור סטטוס זמני.
‫TextMessage עם ערך TextType של PROGRESS הצגת הודעות PROGRESS. ההודעות האלה מוצגות כדי לספק תובנות לגבי הפעולות של הנציג. אלה הודעות מידע על ההתקדמות של הסוכן, כמו כלי שמופעל. ההודעה הזו שונה מתהליך החשיבה הפנימי של הסוכן (THOUGHT) ומהתשובה הסופית למשתמש (FINAL_RESPONSE). ההודעות האלה מכילות שני חלקים:
  • ‫parts[0] הוא הסיכום.
  • ‫parts[1] הוא הטקסט המלא של ההתקדמות.
‫DataQuery ו-DataResult עם שם שמסתיים ב-_sample_values הצגת הודעות ביניים DataQuery ו-DataResult. הודעות DataQuery ו-DataResult עם שדה name שמסתיים ב-_sample_values הן שלבים ביניים לאחזור נתונים גרנולריים, והן לא מוצגות בתצוגת התשובה הראשית. כדי להציג את השלבים שהסוכן מבצע, אפשר לכלול אותם בתצוגה המלאה של התשובה (מאחורי מתג).
DataResult עם שדה data ריק הצגת רק ההודעה המשויכת DataQuery. לא להציג הודעות DataResult עם שדה data ריק באף תצוגה. בתצוגה המפורטת, מוצגת ההודעה DataQuery שהובילה לתוצאה הריקה (מאחורי מתג). כך המשתמש יכול לראות את השאילתה שהופעלה גם אם היא לא הניבה תוצאות. סיכום התשובה הסופי (TextMessage עם הסוג FINAL_RESPONSE) כבר יכלול הודעה למשתמש שהשאילתה לא החזירה נתונים.

דוגמה: הצגת התצוגה המפורטת

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

מתג עם התווית 'הצגת הנימוקים' במצב מורחב.

בתמליל הבא מוצגת התצוגה המפורטת, כולל שלבי החשיבה הרציונלית. בDataQuery הודעות, פרטי השאילתה יכולים להופיע כברירת מחדל, או מאחורי מתג מוטבע שמסומן בסמל הרחבה (), כמו שמוצג בתמליל.

משתמש: השוואה בין סך המכירות של Cymbal Group בשנת 2022 לבין סך המכירות בשנת 2023. שרטוט התוצאה בתרשים.

Agent:

הסבר על הסכימה

כדי להשוות את סך המכירות של 'Cymbal Group' בשנת 2022 לעומת 2023, אני צריך להריץ שאילתה ב-Explore 'פריטי הזמנה'. אני אסנן לפי שם המוצר 'Cymbal Group' ולפי השנים 2022 ו-2023. אחר כך אאחזר את השדות Total Sales ו-Created Year.

הנה תוצאת השאילתה של Total Sales Cymbal Group 2022 2023. 

[
 {"model":"thelook","view":"order_items","fields":["order_items.total_sale_price","order_items.created_year"],
 "filters":{"order_items.created_year":"2022,2023","products.brand":"Cymbal Group"}}
]
שנת היצירה סה"כ מכירות
2023 $96,627.00
2022 $93,095.50

שרטוט של התפלגות המכירות

הבאתי את נתוני המכירות הכוללים של 'Cymbal Group' לשנים 2022 ו-2023. עכשיו אצור תרשים כדי להציג את ההשוואה הזו, ואז אציג את התשובה הסופית.

תצור תרשים עמודות להשוואה בין סך המכירות של 'קבוצת מצלתיים' בשנים 2022 ו-2023. ציר ה-X צריך לייצג את השנה וציר ה-Y צריך לייצג את סך המכירות.

תרשים עמודות שמשווה בין נתוני המכירות לשנים 2022 ו-2023.

סך המכירות של Cymbal Group בשנת 2022 היה 93,095.50$ ובשנת 2023 הוא היה 96,627.00$.

בטבלה הבאה מפורטים השלבים מתוך האינטראקציה לדוגמה והודעות המערכת המתאימות ב-API.

רכיב הודעת המקור
"הסבר על הסכימה" (סיכום המחשבות) ‫TextMessage (הקלדה של THOUGHT, parts[0])
‫"To compare total sales..." ‏(כדי להשוות את סך המכירות...) (הטקסט המלא של המחשבה) ‫TextMessage (הקלדה של THOUGHT, parts[1])
שאילתה שנוצרה (פורמט JSON מוצג כשמרחיבים את המתג ) DataQuery
טבלת נתונים DataResult
"יצירת תרשים של התפלגות המכירות" (סיכום מחשבות) ‫TextMessage (הקלדה של THOUGHT, parts[0])
"מצאתי את…" (הטקסט המלא של המחשבה) ‫TextMessage (הקלדה של THOUGHT, parts[1])
תרשים עמודות ChartResult
התשובה הסופית בטקסט TextMessage (FINAL_RESPONSE)