Inviare feedback ad Agent Assist

Questa guida descrive come inviare un feedback ad Agent Assist sulla qualità di una risposta suggerita specifica. Queste informazioni vengono utilizzate per migliorare la qualità delle risposte suggerite in futuro.

Tipi di feedback

Il feedback rientra in una delle due categorie. Le informazioni su entrambi i tipi di feedback vengono trasmesse dai campi di un oggetto answerFeedback:

  1. Feedback implicito:indica se un agente ha fatto clic su una risposta suggerita. Queste informazioni sono contenute nel campo booleano clicked.
  2. Feedback esplicito: il livello di correttezza della risposta o altre informazioni dettagliate sulla risposta, fornite dall'agente. Il livello di correttezza è indicato dal campo correctnessLevel. Se vuoi, puoi aggiungere ulteriori dettagli al campo agentAssistDetailFeedback come oggetto AgentAssistantFeedback.

Inviare feedback ad Agent Assist

In ogni risposta di Assistente agente è presente un campo Answers (ad esempio faqAnswers, articleAnswers e smartReplyAnswers). Per fornire un feedback su una risposta, trova il nome della risorsa del record della risposta. Il nome della risorsa ha il formato "projects/project-id/answerRecords/answer-record-id". Utilizza il record di risposta per chiamare il metodo UpdateAnswerRecord per inviare AnswerFeedback in merito alla risposta.

Assistenza con le conoscenze generativa

Generative Knowledge Assist può rispondere alle domande degli agenti o suggerire in modo proattivo coppie di domande e risposte. Queste due funzionalità richiedono richieste JSON diverse per l'invio di feedback.

Utilizza il record di risposta per chiamare il metodo UpdateAnswerRecord per inviare AnswerFeedback per indicare possibili eventi di feedback:

  • displayed: Indica se il suggerimento viene mostrato all'operatore umano.
  • clicked: indica se l'agente umano fa clic sul suggerimento.
  • correctness_level: indica se il suggerimento è corretto o meno. Un caso d'uso tipico è fornire i pulsanti Mi piace e Non mi piace all'agente umano per fornire un feedback.
  • answer_copied: indica se la risposta è stata copiata dall'agente umano.
  • clicked_uris: Gli URI su cui ha fatto clic l'operatore umano.

Risposta rapida

Utilizza il record di risposta per chiamare il metodo UpdateAnswerRecord per inviare AnswerFeedback per indicare due eventi di feedback:

  1. visualizzato: un suggerimento (identificato da answer-record-id restituito nei suggerimenti di Risposta rapida) è stato visualizzato nell'interfaccia utente dell'agente.
  2. clicked: l'agente ha fatto clic su un suggerimento (identificato da answer-record-id restituito nei suggerimenti di Risposta rapida).

Il suggerimento è stato mostrato all'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

L'agente ha fatto clic sul suggerimento. 

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

Suggerimento di articoli e assistenza per le domande frequenti

Il seguente esempio mostra come inviare un feedback diretto da un agente in risposta alla domanda dell'agente sull'accuratezza del suggerimento. Il campo correctnessLevel può essere uno dei seguenti: 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

Il seguente esempio mostra come inviare un feedback indiretto solo con clic:

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

Riassunto

Il riepilogo utilizza il feedback per calcolare la durata della revisione o della modifica di un riepilogo e il tasso di modifica.

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

Il feedback sul riepilogo supporta anche l'aggiornamento dei riepiloghi all'interno di ogni sezione. Nota: deve essere aggiornato un solo campo alla volta, 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