Envía comentarios a Agent Assist

En esta guía, se describe cómo enviar comentarios a Agent Assist sobre la calidad de una respuesta sugerida específica. Esta información se usa para mejorar la calidad de tus respuestas sugeridas en el futuro.

Tipos de comentarios

Los comentarios se dividen en dos categorías. La información sobre ambos tipos de comentarios se transmite a través de los campos de un answerFeedback objeto:

  1. Comentarios implícitos: Si un agente hizo clic en una respuesta sugerida. Esta información se incluye en el campo booleano clicked.
  2. Comentarios explícitos: El nivel de corrección de la respuesta o cualquier otra información detallada sobre la respuesta que proporciona el agente. El nivel de corrección se transmite a través del campo correctnessLevel. De manera opcional, se pueden agregar detalles adicionales al campo agentAssistDetailFeedback como un AgentAssistantFeedback objeto.

Envía comentarios a Agent Assist

Hay un campo Answers en cada respuesta de Agent Assist (por ejemplo, faqAnswers, articleAnswers y smartReplyAnswers). Para enviar comentarios sobre una respuesta, busca el nombre del recurso del registro de la respuesta. El nombre del recurso tiene el formato "projects/project-id/answerRecords/answer-record-id". Usa el registro de la respuesta para llamar al UpdateAnswerRecord método para enviar AnswerFeedback sobre la respuesta.

Knowledge Assist generativo

Knowledge Assist generativo puede responder las preguntas de los agentes o sugerir de forma proactiva pares de preguntas y respuestas. Estas dos funciones requieren diferentes solicitudes JSON para enviar comentarios.

Usa el registro de la respuesta para llamar al UpdateAnswerRecord método para enviar AnswerFeedback para indicar posibles eventos de comentarios:

  • displayed: Indica si la sugerencia se muestra al agente humano.
  • clicked: Indica si el agente humano hace clic en la sugerencia.
  • correctness_level: Indica si la sugerencia es correcta o no. Un caso de uso habitual es proporcionar botones de Me gusta y No me gusta para que el agente humano envíe comentarios.
  • answer_copied: Indica si el agente humano copia la respuesta.
  • clicked_uris: Son los URIs en los que hizo clic el agente humano.

Respuesta inteligente

Usa el registro de la respuesta para llamar al UpdateAnswerRecord método y enviar AnswerFeedback para indicar dos eventos de comentarios:

  1. displayed: Se mostró una sugerencia (identificada por answer-record-id que se devolvió en las sugerencias de Respuesta inteligente) en la IU del agente.
  2. clicked: El agente hizo clic en una sugerencia (identificada por answer-record-id que se devolvió en las sugerencias de Respuesta inteligente ).

La sugerencia se mostró al agente. 

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

El agente hizo clic en la sugerencia. 

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

Sugerencia de artículos y Knowledge Assist de preguntas frecuentes

En el siguiente ejemplo, se muestra cómo enviar comentarios directos de un agente en respuesta a una pregunta sobre la corrección de la sugerencia. El campo correctnessLevel puede ser uno de los siguientes: FULLY_CORRECT, PARTIALLY_CORRECT, NOT_CORRECT o 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

En el siguiente ejemplo, se muestra cómo enviar comentarios indirectos solo con clics:

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

Resúmenes

Los resúmenes usan comentarios para calcular la duración que se dedica a revisar o editar un resumen y la tasa de edición.

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

Los comentarios de los resúmenes también admiten la actualización de los resúmenes dentro de cada sección. Nota: Solo se debe actualizar un campo a la vez, ya sea summarizationFeedback.summaryText o 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