Mengirim masukan ke Agent Assist

Panduan ini menjelaskan cara mengirim masukan ke Agent Assist tentang kualitas jawaban yang disarankan tertentu. Informasi ini digunakan untuk meningkatkan kualitas jawaban yang disarankan di masa mendatang.

Jenis masukan

Masukan dapat dikelompokkan ke dalam salah satu dari dua kategori. Informasi tentang kedua jenis masukan disampaikan oleh kolom dalam objek answerFeedback:

  1. Masukan implisit: Apakah agen mengklik jawaban yang disarankan atau tidak. Informasi ini terdapat dalam kolom clicked boolean.
  2. Masukan eksplisit: Tingkat kebenaran jawaban atau informasi mendetail lainnya tentang jawaban, yang diberikan oleh agen. Tingkat kebenaran disampaikan oleh kolom correctnessLevel. Secara opsional, detail tambahan dapat ditambahkan ke kolom agentAssistDetailFeedback sebagai objek AgentAssistantFeedback.

Mengirim masukan ke Agent Assist

Ada kolom Answers di setiap respons Agent Assist (misalnya, faqAnswers, articleAnswers, dan smartReplyAnswers). Untuk memberikan masukan tentang jawaban, temukan nama resource data jawaban. Nama resource memiliki format "projects/project-id/answerRecords/answer-record-id". Gunakan data jawaban untuk memanggil metode UpdateAnswerRecord guna mengirim AnswerFeedback tentang jawaban.

Bantuan pengetahuan generatif

Bantuan pengetahuan generatif dapat menjawab pertanyaan agen atau secara proaktif menyarankan pasangan pertanyaan dan jawaban. Kedua fitur ini memerlukan permintaan JSON yang berbeda untuk mengirim masukan.

Gunakan data jawaban untuk memanggil metode UpdateAnswerRecord untuk mengirim AnswerFeedback guna menunjukkan kemungkinan peristiwa masukan:

  • displayed: Apakah saran ditampilkan kepada agen manusia.
  • clicked: Apakah saran diklik oleh agen manusia.
  • correctness_level: Apakah saran tersebut benar atau tidak. Kasus penggunaan yang umum adalah menyediakan tombol suka dan tidak suka bagi agen manusia untuk memberikan masukan.
  • answer_copied: Apakah jawaban disalin oleh agen manusia.
  • clicked_uris: URI yang diklik oleh agen manusia.

Balasan pintar

Gunakan data jawaban untuk memanggil metode UpdateAnswerRecord untuk mengirim AnswerFeedback guna menunjukkan dua peristiwa masukan:

  1. ditampilkan: saran (diidentifikasi oleh answer-record-id yang ditampilkan dalam saran Smart Reply) ditampilkan di UI agen.
  2. clicked: saran (diidentifikasi oleh answer-record-id yang ditampilkan dalam saran Smart Reply) diklik oleh agen.

Saran ditampilkan kepada agen. 

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

Saran diklik oleh agen. 

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

Saran artikel dan bantuan FAQ

Contoh berikut menunjukkan cara mengirim masukan langsung dari agen sebagai respons atas pertanyaan agen tentang kebenaran saran. Kolom correctnessLevel dapat berupa salah satu dari 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

Contoh berikut menunjukkan cara mengirim masukan tidak langsung khusus klik:

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

Perangkuman

Ringkasan menggunakan masukan untuk menghitung durasi yang dihabiskan untuk meninjau atau mengedit ringkasan dan kecepatan edit.

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

Masukan ringkasan juga mendukung pembaruan ringkasan dalam setiap bagian. Catatan: Hanya satu kolom yang boleh diperbarui dalam satu waktu, baik summarizationFeedback.summaryText maupun 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