Mengirim masukan ke Agent Assist

Panduan ini menjelaskan cara mengirimkan masukan ke Agent Assist tentang kualitas jawaban yang disarankan tertentu. Informasi ini digunakan untuk meningkatkan kualitas saran jawaban Anda pada masa mendatang.

Jenis masukan

Masukan terbagi 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 di kolom boolean clicked.
  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 dari catatan jawaban. Nama resource memiliki format "projects/project-id/answerRecords/answer-record-id". Gunakan rekaman jawaban untuk memanggil metode UpdateAnswerRecord guna mengirimkan 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 mengirimkan masukan.

Gunakan rekaman 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.

Smart Reply

Gunakan rekaman 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. diklik: 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

Bantuan saran artikel dan FAQ

Contoh berikut menunjukkan cara mengirimkan masukan langsung dari agen sebagai respons atas pertanyaan 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

Ringkasan

Peringkasan menggunakan masukan untuk menghitung durasi yang dihabiskan untuk meninjau atau mengedit ringkasan dan rasio pengeditan.

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 harus diperbarui dalam satu waktu, baik summarizationFeedback.summaryText atau 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