Enviar feedback para o Agent Assist

Este guia descreve como enviar feedback para o Assistente do agente sobre a qualidade de uma resposta sugerida específica. Essas informações são usadas para melhorar a qualidade das respostas sugeridas no futuro.

Tipos de feedback

O feedback se enquadra em uma de duas categorias. As informações sobre os dois tipos de feedback são transmitidas por campos em um objeto answerFeedback:

  1. Feedback implícito:se um agente clicou ou não em uma resposta sugerida. Essas informações estão contidas no campo booleano clicked.
  2. Feedback explícito:o nível de correção da resposta ou outras informações detalhadas sobre ela, fornecidas pelo agente. O nível de correção é transmitido pelo campo correctnessLevel. Opcionalmente, é possível adicionar mais detalhes ao campo agentAssistDetailFeedback como um objeto AgentAssistantFeedback.

Enviar feedback para o Agent Assist

Há um campo Answers em todas as respostas do Agent Assist (por exemplo, faqAnswers, articleAnswers e smartReplyAnswers). Para dar feedback sobre uma resposta, encontre o nome do recurso do registro de resposta. O nome do recurso tem o formato "projects/project-id/answerRecords/answer-record-id". Use o registro de resposta para chamar o método UpdateAnswerRecord e enviar AnswerFeedback sobre a resposta.

Assistência de conhecimento generativa

A assistência de conhecimento generativo pode responder a perguntas do agente ou sugerir proativamente pares de perguntas e respostas. Esses dois recursos exigem solicitações JSON diferentes para enviar feedback.

Use o registro de resposta para chamar o método UpdateAnswerRecord e enviar AnswerFeedback para indicar possíveis eventos de feedback:

  • displayed: se a sugestão é mostrada ao atendente humano.
  • clicked: se a sugestão foi clicada pelo atendente humano.
  • correctness_level: indica se a sugestão está correta ou não. Um caso de uso típico é oferecer botões de "Gostei" e "Não gostei" para que o atendente humano possa dar feedback.
  • answer_copied: se a resposta foi copiada pelo agente humano.
  • clicked_uris: os URIs clicados pelo agente humano.

Resposta inteligente

Use o registro de resposta para chamar o método UpdateAnswerRecord e enviar AnswerFeedback para indicar dois eventos de feedback:

  1. Exibida: uma sugestão (identificada por answer-record-id retornada nas sugestões da Resposta inteligente) foi mostrada na UI do agente.
  2. clicked: uma sugestão (identificada por answer-record-id retornada nas sugestões de Resposta inteligente) foi clicada pelo agente.

A sugestão foi mostrada ao 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

A sugestão foi clicada pelo 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": {
    "clicked": true
  }
}' https://dialogflow.googleapis.com/v2/projects/project-id/answerRecords/answer-record-id?updateMask=answer_feedback

Sugestão de artigos e assistência de perguntas frequentes

O exemplo a seguir demonstra como enviar feedback direto de um agente em resposta a uma pergunta sobre a correção de uma sugestão. O campo correctnessLevel pode ser um dos seguintes: 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

O exemplo a seguir demonstra como enviar feedback indireto somente de cliques:

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

Resumo

A sumarização usa o feedback para calcular a duração gasta na revisão ou edição de um resumo e a taxa de edição.

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

O feedback de resumo também permite atualizar os resumos em cada seção. Observação: apenas um campo deve ser atualizado por vez, summarizationFeedback.summaryText ou 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