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

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

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

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

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

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

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

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

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

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

אל תציגו הודעות DataQuery במקרים הבאים:
  • השדה name של ההודעה DataQuery מסתיים ב-_sample_values (לדוגמה, products_brand_sample_values).
  • השדה name של ההודעה התואמת DataResult מסתיים ב-_sample_values.
  • השדה data בהודעה התואמת DataResult ריק.
מומלץ להציב את הטקסט של השאילתה בתוך מתג כדי להציג את שאילתת המקור לפי דרישה. לדוגמה, ב-Conversational Analytics ב-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 'Order Items'. אני אסנן לפי שם המוצר '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)