צפייה במשוב במסוף Google Cloud

בדף הזה מוסבר איך לצפות במשוב שהתקבל ממשתמשי קצה במסוףGoogle Cloud .

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

כדי לראות את רשומות המשוב במסוף Google Cloud , צריך לוודא את הדברים הבאים:

  • במופע של Agent Runtime מופעלת עקיבה.
  • הסוכן מוגדר להשתמש ב-OpenTelemetry‏ (OTel) כדי ליצור טווחים של מעקב ולטפל בהפצה של הקשר של המעקב. ממשק המשתמש של המסוף ממפה רשומות של משוב ליומני מעקב באמצעות מאפיין היחידה הלוגית למעקב שנוצר על ידי OpenTelemetry‏: gcp.vertex.agent.event_id.

צפייה במשוב

שירות המשוב משולב בכרטיסייה Traces במסוףGoogle Cloud . בכרטיסייה Traces אפשר לראות ולסנן עקבות עם משוב מצורף, בכרטיסיות Sessions view ו-Traces view.

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

  1. במסוף Google Cloud , עוברים לדף Agent Platform > Agents.
  2. בתפריט הניווט הימני, לוחצים על פריסות.

  3. בוחרים את הסוכן.

    מעבר לדף Deployments

    מופעים של Agent Engine ששייכים לפרויקט שנבחר יופיעו ברשימה. אפשר להשתמש בשדה Filter כדי לסנן את הרשימה לפי העמודה שציינתם.

  4. לוחצים על השם של מופע Agent Engine.

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

    • תצוגת סשנים:
      1. מסננים את רשימת הסשנים לפי העמודה משוב.
      2. לוחצים על הסשן שרוצים לראות כדי להציג את רשימת העקבות שלו.
      3. בוחרים מזהה מעקב שמוצג בו תג של סמל משוב.
    • התצוגה 'עקבות':
      1. לוחצים על הכרטיסייה Traces view.
      2. מסננים את רשימת העקבות לפי העמודה משוב.
      3. בוחרים מזהה מעקב שמוצג בו תג של סמל משוב.

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

מגבלות בממשק המשתמש

  • דרישות לגבי מזהה האירוע: ממשק המשתמש תומך רק במעקב ובמיפוי של רשומות משוב שמשתמשות ב-UUID שנוצר על ידי OpenTelemetry ‏(gcp.vertex.agent.event_id) שנשלף מטווחים של מעקב.
  • שליחות כפולות: אם נשלחו כמה רשומות משוב עם אותה קומבינציה של session_id ו-event_id, בממשק המשתמש של המסוף תוצג רק רשומת המשוב האחרונה שהתקבלה.

שילוב עם Cloud Trace

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

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

כל עקבות טלמטריה של משוב מכיל טווח בשם gcp.vertex.agent.feedback עם מאפייני המשאב והטווח הבאים:

מאפיין סוג מאפיין תיאור
gcp.project_id משאב מזהה הפרויקט של פרויקט במסוף Google Cloud .
cloud.resource.id משאב המזהה של מופע מנוע הנימוקים.
gcp.vertex.agent.feedback.type Span סוג המשוב (THUMBS_UP,‏ THUMBS_DOWN או FEEDBACK_TYPE_UNSPECIFIED).
gen_ai.conversation_id Span מזהה הסשן שמשויך לאינטראקציה.
gcp.vertex.agent.event_id Span מזהה האירוע שמשויך לתור הספציפי בשיחה.
gcp.vertex.agent.feedback.entry.name Span נתיב המשאב של רשומת המשוב שנוצרה.
gcp.vertex.agent.feedback.labels Span זה שינוי אופציונלי. רשימה של תוויות משוב.

המאמרים הבאים