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을 전송합니다.

생성형 지식 지원

생성형 지식 어시스턴트는 상담사의 질문에 답변하거나 사전에 질문과 답변 쌍을 제안할 수 있습니다. 이 두 가지 기능은 의견을 보내는 데 서로 다른 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