Envie feedback para o Agent Assist

Este guia descreve como enviar feedback ao Agent Assist sobre a qualidade de uma resposta sugerida específica. Estas informações são utilizadas para melhorar a qualidade das suas respostas sugeridas no futuro.

Tipos de feedback

O feedback divide-se em duas categorias. As informações sobre ambos os tipos de feedback são transmitidas por campos num objeto answerFeedback:

  1. Feedback implícito: se um agente clicou ou não numa resposta sugerida. Estas 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 a resposta, fornecidas pelo agente. O nível de correção é transmitido pelo campo correctnessLevel. Opcionalmente, podem ser adicionados detalhes adicionais ao campo agentAssistDetailFeedback como um objeto AgentAssistantFeedback.

Envie feedback para o Agent Assist

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

Assistência de conhecimentos generativa

A assistência de conhecimentos generativa pode responder a perguntas dos agentes ou sugerir proativamente pares de perguntas e respostas. Estas duas funcionalidades requerem pedidos JSON diferentes para o envio de feedback.

Use o registo de respostas para chamar o método UpdateAnswerRecord para enviar AnswerFeedback para indicar possíveis eventos de feedback:

  • displayed: se a sugestão é apresentada ao agente humano.
  • clicked: se a sugestão é clicada pelo agente humano.
  • correctness_level: se a sugestão está correta ou não. Um exemplo de utilização típico é disponibilizar botões de gosto e não gosto para o agente humano dar feedback.
  • answer_copied: se a resposta é copiada pelo agente humano.
  • clicked_uris: os URIs clicados pelo agente humano.

Resposta inteligente

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

  1. apresentada: foi apresentada uma sugestão (identificada por answer-record-id devolvida nas sugestões de Resposta inteligente) na IU do agente.
  2. clicked: o agente clicou numa sugestão (identificada por answer-record-id devolvida nas sugestões de Resposta inteligente).

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

O agente clicou na sugestã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": {
    "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 seguinte 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 seguinte demonstra como enviar feedback indireto apenas 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 geração de resumos usa o feedback para calcular a duração despendida 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 sobre a geração de resumos também suporta a atualização de resumos em cada secção. Nota: só deve atualizar um campo de cada 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