Agent Assist にフィードバックを送信する

このガイドでは、特定の候補回答の品質について Agent Assist にフィードバックを送信する方法について説明します。この情報は、今後、提案される回答の品質を向上させるために使用されます。

フィードバックの種類

フィードバックは、次の 2 つのカテゴリのいずれかに分類されます。両方のフィードバック タイプに関する情報は、answerFeedback オブジェクトのフィールドによって伝達されます。

  1. 暗黙的なフィードバック: エージェントが回答候補をクリックしたかどうか。この情報は、ブール値の clicked フィールドに含まれています。
  2. 明示的なフィードバック: エージェントが提供する回答の正しさのレベル、または回答に関するその他の詳細情報。正しさのレベルは correctnessLevel フィールドで示されます。必要に応じて、agentAssistDetailFeedback フィールドに AgentAssistantFeedback オブジェクトとして詳細を追加できます。

Agent Assist にフィードバックを送信する

すべての Agent Assist のレスポンス（faqAnswers、articleAnswers、smartReplyAnswers など）に Answers フィールドがあります。回答に関するフィードバックを送信するには、回答レコードのリソース名を見つけます。リソース名の形式は「projects/project-id/answerRecords/answer-record-id」です。回答レコードを使用して UpdateAnswerRecord メソッドを呼び出し、回答に関する AnswerFeedback を送信します。

生成ナレッジ アシスト

生成ナレッジ アシストは、エージェントの質問に回答するか、質問と回答のペアをプロアクティブに提案します。これら 2 つの機能では、フィードバックを送信するために異なる JSON リクエストが必要です。

回答レコードを使用して UpdateAnswerRecord メソッドを呼び出し、フィードバック イベントの可能性を示す AnswerFeedback を送信します。

  • displayed: 提案が人間のエージェントに表示されるかどうか。
  • clicked: 人間のエージェントが候補をクリックしたかどうか。
  • correctness_level: 候補が正しいかどうか。一般的なユースケースは、人間のエージェントがフィードバックを提供するための高評価ボタンと低評価ボタンを提供することです。
  • answer_copied: 回答が人間のエージェントによってコピーされたかどうか。
  • clicked_uris: 人間のエージェントがクリックした URI。

スマート リプライ

回答レコードを使用して UpdateAnswerRecord メソッドを呼び出し、2 つのフィードバック イベントを示す AnswerFeedback を送信します。

  1. displayed: 候補（スマート リプライの候補で返された 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

記事の候補とよくある質問アシスト

次のサンプルは、提案の正確性についてエージェントに質問されたときに、エージェントから直接フィードバックを送信する方法を示しています。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

要約のフィードバックでは、各セクション内の要約を更新することもできます。注: 一度に更新できるフィールドは 1 つのみです（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