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

I feedback rientrano in una delle due categorie. Le informazioni su entrambi i tipi di feedback vengono trasmesse tramite i campi di un oggetto answerFeedback:

  1. Feedback implicito:indica se un agente ha fatto clic o meno 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 viene 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 Agent Assist è presente un campo Answers (ad es. faqAnswers, articleAnswers e smartReplyAnswers). Per fornire un feedback su una risposta, individua il nome della risorsa del record di 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 sulla risposta.

Assistenza generativa della conoscenza

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'agente 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 per consentire all'agente umano di fornire un feedback.
  • answer_copied: indica se la risposta viene copiata dall'agente umano.
  • clicked_uris: gli URI su cui ha fatto clic l'agente umano.

Risposta rapida

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

  1. displayed: 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

L'esempio seguente mostra come inviare un feedback diretto da un agente in risposta alla richiesta di conferma della correttezza 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

L'esempio seguente mostra come inviare un feedback indiretto solo per i 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

La funzionalità di sintesi utilizza i feedback per calcolare la durata impiegata per rivedere o modificare un riepilogo e la frequenza 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 per i riepiloghi 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