שליחת משוב על Agent Assist

במדריך הזה מוסבר איך לשלוח משוב ל-Agent Assist על האיכות של תשובה מוצעת ספציפית. המידע הזה עוזר לנו לשפר את איכות ההצעות לתשובות בעתיד.

סוגי משוב

המשוב מתחלק לשתי קטגוריות. המידע על שני סוגי המשוב מועבר באמצעות שדות באובייקט answerFeedback:

  1. משוב מרומז: האם הנציג לחץ על הצעה לתשובה. המידע הזה מופיע בשדה הבוליאני clicked.
  2. משוב מפורש: רמת הדיוק של התשובה או מידע מפורט אחר על התשובה, שסופק על ידי הסוכן. רמת הדיוק מועברת דרך השדה correctnessLevel. אפשר גם להוסיף פרטים נוספים לשדה agentAssistDetailFeedback כאובייקט AgentAssistantFeedback.

שליחת משוב על Agent Assist

בכל תגובה של Agent Assist יש שדה Answers (לדוגמה, faqAnswers, articleAnswers ו- smartReplyAnswers). כדי לשלוח משוב על תשובה, צריך למצוא את שם המשאב של רשומת התשובה. שם המשאב הוא בפורמט projects/project-id/answerRecords/answer-record-id. משתמשים ברשומה של התשובה כדי להתקשר לשיטה UpdateAnswerRecord ולשלוח AnswerFeedback לגבי התשובה.

עזרה גנרטיבית ביצירת תוכן

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

משתמשים ברשומה של התשובה כדי להתקשר לשיטה UpdateAnswerRecord כדי לשלוח AnswerFeedback ולציין אירועי משוב אפשריים:

  • ‫displayed: האם ההצעה מוצגת לנציג האנושי.
  • ‫clicked: האם הנציג האנושי לחץ על ההצעה.
  • ‫correctness_level: האם ההצעה נכונה או לא. מקרה שימוש אופייני הוא לספק לסוכן האנושי כפתורי לייק ודיסלייק כדי לשלוח משוב.
  • ‫answer_copied: האם התשובה הועתקה על ידי הנציג האנושי.
  • ‫clicked_uris: מזהי ה-URI שהסוכן האנושי לחץ עליהם.

תשובה מהירה

משתמשים ברשומה של התשובה כדי להתקשר לשיטה UpdateAnswerRecord כדי לשלוח את AnswerFeedback כדי לציין שני אירועי משוב:

  1. מוצגת: הצעה (שמזוהה על ידי answer-record-id שהוחזרה בהצעות לתשובה מהירה) הוצגה בממשק המשתמש של הסוכן.
  2. clicked: הסוכן לחץ על הצעה (מזוהה על ידי answer-record-id שמוחזר ב- Smart Reply suggestions).

ההצעה הוצגה לסוכן. 

curl -X PATCH 

     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" 

     -H "x-goog-user-project: quota-project-id" 

     -H "Content-Type: application/json" -d 

'{
  "name": "projects/project-id/answerRecords/answer-record-id",
  "answerFeedback": {
    "displayed": true
  }
}' https://dialogflow.googleapis.com/v2/projects/project-id/answerRecords/answer-record-id?updateMask=answer_feedback

הסוכן לחץ על ההצעה. 

curl -X PATCH 

     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" 

     -H "x-goog-user-project: quota-project-id" 

     -H "Content-Type: application/json" -d 

'{
  "name": "projects/project-id/answerRecords/answer-record-id",
  "answerFeedback": {
    "clicked": true
  }
}' https://dialogflow.googleapis.com/v2/projects/project-id/answerRecords/answer-record-id?updateMask=answer_feedback

הצעות למאמרים ועזרה בשאלות נפוצות

בדוגמה הבאה אפשר לראות איך סוכן שולח משוב ישירות בתגובה לשאלה לגבי נכונות ההצעה. השדה correctnessLevel יכול להיות אחד מהערכים הבאים: FULLY_CORRECT, ‏ PARTIALLY_CORRECT,‏ NOT_CORRECT, ‏ CORRECTNESS_LEVEL_UNSPECIFIED.

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "x-goog-user-project: quota-project-id" \
     -H "Content-Type: application/json" -d \
'{
  "name": "projects/project-id/answerRecords/answer-record-id",
  "answerFeedback": {
    "correctnessLevel": "FULLY_CORRECT",
    "agentAssistantDetailFeedback": {},
    "clicked": true
  }
}' https://dialogflow.googleapis.com/v2/projects/project-id/answerRecords/answer-record-id?updateMask=answer_feedback

בדוגמה הבאה אפשר לראות איך שולחים משוב עקיף שכולל רק קליקים:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "x-goog-user-project: quota-project-id" \
     -H "Content-Type: application/json" -d \
'{
  "name": "projects/project-id/answerRecords/answer-record-id",
  "answerFeedback": {
    "clicked": true
  }
}' https://dialogflow.googleapis.com/v2/projects/project-id/answerRecords/answer-record-id?updateMask=answer_feedback

סיכום

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

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "x-goog-user-project: quota-project-id" \
     -H "Content-Type: application/json" -d \
'{
  "name": "projects/project-id/answerRecords/answer-record-id",
  "answerFeedback": {
    "agentAssistantDetailFeedback": {
      "summarizationFeedback": {
        "startTimestamp": "2022-10-15T02:10:11.414Z",
        "submitTimestamp": "2022-10-15T02:12:41.000012345Z",
        "summaryText": "submitted summary"
      }
    }
  }
}' \
https://dialogflow.googleapis.com/v2beta1/projects/project-id/answerRecords/answer-record-id?updateMask=answer_feedback.agent_assistant_detail_feedback.summarization_feedback

בנוסף, אפשר להשתמש במשוב על סיכומים כדי לעדכן את הסיכומים בכל קטע. הערה: צריך לעדכן רק שדה אחד בכל פעם, או summarizationFeedback.summaryText או summarizationFeedback.textSections.

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "x-goog-user-project: quota-project-id" \
     -H "Content-Type: application/json" -d \
'{
  "name": "projects/project-id/answerRecords/answer-record-id",
  "answerFeedback": {
    "agentAssistantDetailFeedback": {
      "summarizationFeedback": {
        "startTimestamp": "2022-10-15T02:10:11.414Z",
        "submitTimestamp": "2022-10-15T02:12:41.000012345Z",
        "textSections": {
          "section a": "section a summary",
          "section b": "section b summary"
        }
      }
    }
  }
}' \
https://dialogflow.googleapis.com/v2beta1/projects/project-id/answerRecords/answer-record-id?updateMask=answer_feedback.agent_assistant_detail_feedback.summarization_feedback