Inviare feedback ad Agent Assist

Questa guida descrive come inviare 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 seguenti. Le informazioni su entrambi i tipi di feedback vengono trasmesse dai campi di un answerFeedback oggetto:

  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:indica il livello di correttezza della risposta o altre informazioni dettagliate sulla risposta, fornite dall'agente. Il livello di correttezza è indicato dal campo correctnessLevel. Facoltativamente, è possibile 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 esempio faqAnswers, articleAnswers e smartReplyAnswers). Per fornire feedback su una risposta, trova il nome risorsa del record della risposta. Il nome risorsa ha il formato "projects/project-id/answerRecords/answer-record-id". Utilizza il record della risposta per chiamare il UpdateAnswerRecord metodo per inviare AnswerFeedback sulla risposta.

Assistenza knowledge base generativa

L'assistenza knowledge base generativa 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 della risposta per chiamare il UpdateAnswerRecord metodo per inviare AnswerFeedback per indicare i possibili eventi di feedback:

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

Risposta rapida

Utilizza il record della risposta per chiamare il UpdateAnswerRecord metodo 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. selezionato: un suggerimento (identificato da answer-record-id restituito nei suggerimenti di Risposta rapida) è stato selezionato dall'agente.

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 domanda sulla correttezza del suggerimento. Il campo correctnessLevel può essere uno dei seguenti valori: 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 feedback indiretti solo sui 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 riassunto utilizza i feedback per calcolare la durata della revisione o della modifica di 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

I feedback sui riepiloghi supportano anche l'aggiornamento dei riepiloghi all'interno di ogni sezione. Nota: è necessario aggiornare 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