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

שירות המשוב של Gemini Enterprise 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 כבר אמורה להיות הרשאת גישה לשירות המשוב.

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