Agent Assist에 의견 보내기

이 가이드에서는 특정 추천 답변의 품질에 관해 Agent Assist에 의견을 보내는 방법을 설명합니다. 이 정보는 향후 추천 답변의 품질을 개선하는 데 사용됩니다.

의견 유형

의견은 다음 두 가지 카테고리 중 하나에 속합니다. 두 가지 유형의 의견에 관한 정보는 answerFeedback 객체의 필드를 통해 전달됩니다.

  1. 간접적인 피드백: 상담사가 추천 답변을 클릭했는지 여부입니다. 이 정보는 불리언 clicked 필드에 포함되어 있습니다.
  2. 명시적 피드백: 상담사가 제공한 답변의 정확성 수준 또는 답변에 관한 기타 세부정보입니다. 정확성 수준은 correctnessLevel 필드로 전달됩니다. 원하는 경우 agentAssistDetailFeedback 필드에 AgentAssistantFeedback 객체로 추가 세부정보를 추가할 수 있습니다.

Agent Assist에 의견 보내기

모든 Agent Assist 응답 (예: faqAnswers, articleAnswers, smartReplyAnswers)에는 Answers 필드가 있습니다. 대답에 대한 의견을 제공하려면 대답 레코드의 리소스 이름을 찾으세요. 리소스 이름의 형식은 'projects/project-id/answerRecords/answer-record-id'입니다. 답변 레코드를 사용하여 UpdateAnswerRecord 메서드를 호출하여 답변에 관한 AnswerFeedback을 보냅니다.

생성형 지식 지원

생성형 지식 어시스트는 상담사의 질문에 답변하거나 질문과 답변 쌍을 선제적으로 제안할 수 있습니다. 이 두 기능은 의견을 전송하기 위해 서로 다른 JSON 요청이 필요합니다.

답변 레코드를 사용하여 UpdateAnswerRecord 메서드를 호출하여 AnswerFeedback를 전송하여 가능한 피드백 이벤트를 나타냅니다.

  • displayed: 제안이 상담사에게 표시되는지 여부입니다.
  • clicked: 제안을 상담사가 클릭했는지 여부입니다.
  • correctness_level: 추천이 올바른지 여부입니다. 일반적인 사용 사례는 상담사가 의견을 제공할 수 있도록 좋아요 및 싫어요 버튼을 제공하는 것입니다.
  • answer_copied: 인간 상담사가 답변을 복사했는지 여부입니다.
  • clicked_uris: 사람이 클릭한 URI입니다.

스마트 답장

답변 레코드를 사용하여 UpdateAnswerRecord 메서드를 호출하여 AnswerFeedback를 전송하여 다음 두 가지 피드백 이벤트를 나타냅니다.

  1. 표시됨: 스마트 답장 추천에서 반환된 answer-record-id로 식별되는 추천이 상담사 UI에 표시되었습니다.
  2. clicked: 상담사가 제안 (스마트 답장 제안에 반환된 answer-record-id로 식별됨)을 클릭했습니다.

추천이 상담사에게 표시되었습니다. 

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

자료 추천 및 FAQ 지원

다음 샘플은 제안의 정확성에 대해 질문을 받은 상담사가 이에 대한 응답으로 직접 의견을 보내는 방법을 보여줍니다. 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