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 las 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 objeto answerFeedback:

  1. Comentarios implícitos: Indican si un agente hizo clic en una respuesta sugerida. Esta información se encuentra en el campo booleano clicked.
  2. Comentarios explícitos: 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 forma opcional, se pueden agregar detalles adicionales al campo agentAssistDetailFeedback como un objeto AgentAssistantFeedback.

Envía comentarios a Agent Assist

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

Knowledge Assist generativo

La asistencia de conocimiento 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 respuesta para llamar al método UpdateAnswerRecord y enviar AnswerFeedback para indicar posibles eventos de comentarios:

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

Respuesta inteligente

Usa el registro de respuesta para llamar al método UpdateAnswerRecord 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).

Se mostró la sugerencia 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

Sugerencias de artículos y asistencia con preguntas frecuentes

En el siguiente ejemplo, se muestra cómo enviar comentarios directos de un agente en respuesta a una pregunta sobre la exactitud de las sugerencias. 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 de 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

El resumen usa los comentarios para calcular la duración dedicada 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 sobre el resumen también permiten actualizar 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