Envía comentarios a Agent Assist

Esta función está sujeta a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

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 una de las siguientes dos categorías. La información sobre ambos tipos de comentarios se transmite a través de campos en un objeto answerFeedback:

1. Comentarios implícitos: Indica si un agente hizo clic o no en una respuesta sugerida. Esta información se encuentra en el campo booleano clicked.
2. Comentarios explícitos: El nivel de exactitud de la respuesta o cualquier otra información detallada sobre la respuesta que proporciona el agente. El campo correctnessLevel transmite el nivel de exactitud. 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.

Asistencia de conocimiento generativo

La asistencia de conocimiento generativo puede responder 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 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 copia 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 muestra 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 muestra en las sugerencias de Respuesta inteligente).

Se le 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

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 una sugerencia. El campo correctnessLevel puede ser 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 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 de resumen también admiten la actualización de 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