סקירה כללית על שירות המשוב

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

כדי להתחיל לאסוף משוב מהמשתמשים שלכם על הסוכן, אתם יכולים לבצע שילוב ישירות עם Feedback service API או להשתמש ב-SDK. ה-API וה-SDK מאפשרים לכם לנהל רשומות של משוב באמצעות פעולות CRUDL (יצירה, אחזור, עדכון, מחיקה ורשימה) סטנדרטיות, ולצרף פרטים נוספים על השיחה לרשומות של משוב באמצעות משאב FeedbackContext.

מידע נוסף זמין במאמרים בנושא ניהול משוב באמצעות Python SDK או API בארכיטקטורת REST והצגת משוב במסוף.

מושגי ליבה

  • רשומה של משוב: מעקב אחרי נתונים איכותיים נפרדים שסופקו על ידי משתמש קצה. כל רשומה כוללת סנטימנט בינארי, תוויות משוב ספציפיות וטקסט חופשי אופציונלי.
  • סוג המשוב: הסנטימנט הבינארי ממשתמש הקצה, שמיוצג על ידי thumbs_up ו- thumbs_down.
  • מזהה הסשן (session_id) ומזהה האירוע (event_id): שדות חובה שמשמשים לקישור המשוב לסיבוב שיחה או לאירוע ספציפיים.
  • הקשר של המשוב: משאב אופציונלי שמצורף לרשומה של משוב, שבו נשמרים תמלילים או יומני שיחות, כך שההקשר נשמר גם אם המפגש המקורי נמחק. במשאב הזה אפשר לאחסן את השיחה כולה או את ההודעות שהמשתמש בחר, בהתאם למה שתבחרו לכלול.
  • תווית משוב: סיווג שמציין את אופי הבעיה התפעולית או את התוצאה המוצלחת.
    • תוויות של משוב חיובי (בדרך כלל בשימוש עם thumbs_up) כוללות:
      • accurate
      • complete
      • helpful
      • on_topic
      • fast
      • safe
      • factual
      • tool_success
    • תוויות של משוב שלילי (בדרך כלל בשימוש עם thumbs_down) כוללות:
      • inaccurate
      • incomplete
      • unhelpful
      • off_topic
      • too_slow
      • unsafe
      • hallucination
      • tool_error

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

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

קבלת התפקידים הנדרשים

כדי לקבל את ההרשאות שדרושות לשימוש בשירות המשוב, צריך לבקש מהאדמין להקצות לכם בפרויקט את תפקידי ה-IAM הבאים:

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

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

אם אתם שולחים בקשות לשירות המשוב מ- Google Cloud, ודאו שלחשבון השירות שלכם יש את ההרשאות הנדרשות. לחשבונות שירות בניהול המשתמשים צריכה להיות ההרשאה משתמש בפלטפורמת הסוכן (aiplatform.user) כדי ליצור אינטראקציה עם שירות המשוב.

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

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