Enviar comentarios sobre Agent Assist

En esta guía se describe cómo enviar comentarios a Asistente sobre la calidad de una respuesta sugerida específica. Esta información se utiliza 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 mediante campos de un objeto answerFeedback:

  1. Comentarios implícitos: si un agente ha hecho clic en una respuesta sugerida o no. Esta información se incluye en el campo booleano clicked.
  2. Comentarios explícitos: el nivel de corrección de la respuesta u otra información detallada sobre la respuesta proporcionada por el agente. El nivel de corrección se indica en el campo correctnessLevel. De forma opcional, se pueden añadir detalles adicionales al campo agentAssistDetailFeedback como objeto AgentAssistantFeedback.

Enviar comentarios sobre Agent Assist

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

Asistencia de conocimientos generativa

La ayuda con conocimientos generativos puede responder a las preguntas de los agentes o sugerir de forma proactiva pares de preguntas y respuestas. Estas dos funciones requieren solicitudes JSON diferentes para enviar comentarios.

Usa el registro de respuestas para llamar al método UpdateAnswerRecord 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 ha hecho clic en la sugerencia.
  • correctness_level: si la sugerencia es correcta o no. Un caso de uso habitual es proporcionar botones Me gusta y No me gusta para que el agente humano pueda enviar comentarios.
  • answer_copied: indica si el agente humano ha copiado la respuesta.
  • clicked_uris: los URIs en los que ha hecho clic el agente humano.

Respuesta Inteligente

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

  1. Mostrada: se ha mostrado una sugerencia (identificada por answer-record-id devuelta en las sugerencias de Respuesta inteligente) en la interfaz de agente.
  2. clicked: el agente ha hecho clic en una sugerencia (identificada por answer-record-id devuelta en las sugerencias de Respuesta inteligente).

La sugerencia se ha mostrado 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 ha hecho 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 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

Creación de resúmenes

La función de resumen usa los comentarios para calcular el tiempo dedicado 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 los resúmenes también permiten actualizar los resúmenes 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