Output del modulo di valutazione degli agenti in Amazon Connect - Amazon Connect
Verifica del bucket S3Esempi di posizioni di outputProblema notoPunteggi di esempioDefinizioni dei metadati del modulo di valutazioneEsempio di valutazione esportata

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Output del modulo di valutazione degli agenti in Amazon Connect

Questa sezione mostra il percorso dell’output di esportazione per le valutazioni, fornisce un esempio di punteggi dei moduli di valutazione e descrive i metadati dei moduli di valutazione.

Verifica del bucket S3

Quando abiliti la Valutazione dei contatti nella console Amazon Connect , ti viene richiesto di creare o scegliere un bucket S3 per archiviare le valutazioni. Per verificare il nome del bucket, vai all’alias dell’istanza, scegli Archiviazione dei dati, Valutazione dei contatti, quindi Modifica.

Esempi di posizioni di output

Di seguito è riportato il percorso del file di output per i moduli di valutazione:

  • contact_evaluations_S3_bucketYYYY/MM/DD/hh:mm:ss.sTZD/Valutazioni/ - .json evaluation_id

Esempio:

amazon-connect-s3/Evaluations/2022/04/14/05:04:20.869Z-11111111-2222-3333-4444-555555555555.json

Problema noto: due file di output per la stessa valutazione

Contact Lens genera due file di output per lo stesso modulo di valutazione.

  • Un file viene scritto nel nuovo percorso S3 predefinito. È possibile configurare il percorso nella console. AWS

  • Un altro file, che sarà obsoleto, viene scritto in un percorso S3 precedente diverso. Puoi ignorare questo file.

    Il percorso S3 precedente è simile al seguente:

    • s3_bucket/evaluations/contact_ contactId /evaluation_ /yyyy-mm-:mm:ss.stzd.json evaluationId DDThh

Punteggi di esempio

L’esempio seguente mostra un punteggio tipico.

 {
"schemaVersion": "3.1",
"evaluationId": "fb90de35-4507-479a-8b57-970290fd5c2c",
 "metadata": {
    "contactId": "badd4896-75f7-43b3-bee6-c617ed3d04cb",
    "accountId": "874551140838",
    "instanceId": "8f753c94-9cd2-4f16-85eb-945f7f0d559a",
    "agentId": "286bcec0-e722-4166-865f-84db80252218",
    "evaluationDefinitionTitle": "Compliance Evaluation Form",
    "evaluator": "jane",
    "evaluationDefinitionId": "15d8fbf1-b4b2-4ace-869b-82714e2f6e3e",
    "evaluationDefinitionVersion": 2,
    "evaluationStartTimestamp": "2022-11-14T17:57:08.649Z",
    "evaluationSubmitTimestamp": "2022-11-14T17:59:29.052Z",
    "score": { "percentage": 100 },
    "creator": "jane.doe@acme.com",
    "autoEvaluated": false, 
    "resubmitted": false, 
    "evaluationSource": "ASSISTED_BY_AUTOMATION",   
    "acknowledgerComment": "The Acknowledgment comment",
         "acknowledgedTimestamp": "2022-12-22T05:20:39.297Z",
         "acknowledgedByUserName": "john",
         "acknowledgedByUserId": "286bcec0-e722-4166-865f-84db80252218"
  },
"sections": [
    {
      "sectionRefId": "s1a1b58d6",
      "sectionTitle": "The title of the section",
      "notes": "Section note",
      "score": { "percentage": 100 }
    },
    {
      "sectionRefId": "s46661c49",
      "sectionTitle": "The title of the subsection",
      "parentSectionRefId": "s1a1b58d6",
      "score": { "percentage": 100 }
    }
  ],
"questions": [
    {
      "questionRefId": "q570b206a",
      "sectionRefId": "s46661c49",
      "questionType": "NUMERIC",
      "questionText": "How do you rate the contact between 1 and 10?",
      "answer": {
        "value": "",
        "notes": "Add more information here",
        "metadata": { "notApplicable": true }
      },
      "score": { "notApplicable": true }
    },
    {
      "questionRefId": "q73bc5b9d",
      "sectionRefId": "s46661c49",
      "questionType": "SINGLESELECT",
      "questionText": "Did the agent introduce themselves?",
      "answer": {
        "values": [
          { "valueText": "Yes", "valueRefId": "o6999aa94", "selected": true },
          { "valueText": "No", "valueRefId": "o284e4d9e", "selected": false },
          { "valueText": "Maybe", "valueRefId": "o1b2f0a14", "selected": false }
        ],
        "notes": "Add more information here",
        "automation": {
            "status": "SYSTEM_ANSWER",
            "systemSuggestedValue": "Yes"
        },
        "metadata": { "notApplicable": false }
      },
      "score": { "percentage": 100 }
    },
    {
      "questionRefId": "h89bc7a9t",
      "sectionRefId": "s46661c49",
      "questionType": "SINGLESELECT",
      "questionText": "Did the agent offer a promotion?",
      "answer": {
        "values": [
          { "valueText": "Yes", "valueRefId": "o6999aa94", "selected": false },
          { "valueText": "No", "valueRefId": "o284e4d9e", "selected": true },
          { "valueText": "Maybe", "valueRefId": "o1b2f0a14", "selected": false }
        ],
        "notes": "Add more information here",
        "assistedSuggestion": {
            value: "No. A promotion was not offered by the agent."
        },
        "metadata": { "notApplicable": false }
      },
      "score": { "percentage": 100 }
    },
    {
      "questionRefId": "qc2effc9d",
      "sectionRefId": "s46661c49",
      "questionType": "TEXT",
      "questionText": "Describe the outcome.",
      "answer": {
        "value": "Example answer text",
        "notes": "Add more information here",
        "metadata": { "notApplicable": false }
      },
      "score": { "notApplicable": true }
    }
  ]
}

Definizioni dei metadati del modulo di valutazione

Nella seguente lista sono descritti i campi del modulo di valutazione

evaluationId

Un identificatore univoco per la valutazione del contatto

Tipo: stringa

Vincoli per la lunghezza: lunghezza minima pari a 1. Lunghezza massima di 500

metadati
contactId

L’identificatore del contatto in questa istanza di Amazon Connect.

Tipo: stringa

Vincoli per la lunghezza: lunghezza minima pari a 1, lunghezza massima pari a 256

accountId

L'identificatore dell' AWS account che esegue l'istanza di Amazon Connect.

Tipo: stringa

Vincoli per la lunghezza: limiti: 12 cifre

Schema: ^\d{12}$

instanceId

L'identificativo dell'istanza Amazon Connect. Puoi trovare l’ID istanza nel nome della risorsa Amazon (ARN) dell’istanza.

Vincoli per la lunghezza: lunghezza minima pari a 1, lunghezza massima pari a 100

agentId

L’identificatore dell’agente che ha gestito il contatto.

Tipo: stringa

Vincoli per la lunghezza: lunghezza minima pari a 1, lunghezza massima pari a 500

evaluationDefinitionTitle

Il titolo del modulo di valutazione.

Tipo: stringa

Vincoli per la lunghezza: lunghezza minima pari a 1, lunghezza massima pari a 128

evaluator

Nome dell’utente che ha aggiornato per ultimo la valutazione.

Tipo: stringa

evaluationDefinitionId

L’identificatore univoco per il modulo di valutazione.

Tipo: stringa

Vincoli per la lunghezza: lunghezza minima pari a 1, lunghezza massima pari a 500

evaluationDefinitionVersion

La versione del modulo di valutazione.

Tipo: numero intero

Intervallo valido: valore minimo di 1

evaluationStartTimestamp

Il timestamp di creazione della valutazione.

Tipo: timestamp

score

Il punteggio della valutazione.

creatore

L’entità che ha creato la valutazione per la prima volta (al contrario di “evaluator” che rappresenta l’entità che ha inviato per ultima la valutazione). Quando la chiamata viene effettuata dal sito Web di Amazon Connect amministrazione, contiene il nome utente. Quando la chiamata proviene dall’API, contiene l’ARN del chiamante.

Tipo: stringa

autoEvaluated

Indica se la valutazione è stata inviata utilizzando valutazioni completamente automatizzate.

Tipo: booleano

resubmitted

Indica se la valutazione è stata inviata nuovamente (modificata e inviata di nuovo).

Tipo: booleano

evaluationSource

Il tipo di origine della risposta della valutazione.

Tipo: stringa

Valori validi:

  • ASSISTED_BY_AUTOMATION: indica che è stata utilizzata l’automazione delle domande per rispondere ad alcune domande.

  • MANUAL: indica che la valutazione è stata eseguita manualmente.

  • AUTOMATED: indica che la valutazione è stata inviata utilizzando valutazioni completamente automatizzate (consulta il campo “autoEvaluated”).

acknowledgerComment

Commento lasciato dall’utente che ha confermato la valutazione.

Tipo: stringa

Vincoli per la lunghezza: lunghezza minima pari a 0, lunghezza massima pari a 3.072

evaluationAcknowledgedByUserId

L’identificatore della persona che ha confermato la valutazione.

Tipo: stringa

Vincoli per la lunghezza: lunghezza minima pari a 1, lunghezza massima pari a 500

evaluationAcknowledgedByUserName

Il nome della persona che ha confermato la valutazione.

Tipo: stringa

evaluationAcknowledgedTimestamp

Il timestamp di conferma della valutazione.

Tipo: timestamp

sections

Array delle sezioni della valutazione.

sectionRefId

L’identificatore della sezione. Un identificatore deve essere univoco all’interno del modulo di valutazione.

Tipo: stringa

Vincoli per la lunghezza: lunghezza minima pari a 1, lunghezza massima pari a 40

parentSectionRefId

L’identificatore della sezione principale.

Tipo: stringa

Vincoli per la lunghezza: lunghezza minima pari a 1, lunghezza massima pari a 40

sectionTitle

Il titolo della sezione.

Tipo: stringa

Vincoli per la lunghezza: limiti: lunghezza minima pari a 0, lunghezza massima pari a 128

notes

Le note lasciate per la sezione.

Tipo: stringa

Vincoli per la lunghezza: lunghezza minima pari a 0, lunghezza massima pari a 3.072

Nota

Le note sono sottoposte alle seguenti limitazioni:

  • Le singole note hanno un limite di 3.072 caratteri.

  • Le note combinate di una valutazione hanno un limite di N x 1.024 caratteri, dove N è il numero di domande della valutazione.

score

Il punteggio della sezione.

percentage

La percentuale di punteggio di un elemento nella valutazione di un contatto.

Tipo: double

Intervallo valido: valore minimo pari a 0, valore massimo pari a 100

automaticFail

Il flag che contrassegna l’elemento come errore automatico. Se l’elemento o un elemento secondario riceve una risposta automatica di errore, questo flag sarà true.

Tipo: booleano

notApplicable

Il flag che contrassegna l’elemento come errore automatico. Se l’elemento o un elemento secondario riceve una risposta automatica di errore, questo flag sarà true.

Tipo: booleano

domande

Array di domande della valutazione.

questionRefId

L’identificatore della domanda. Un identificatore deve essere univoco all’interno del modulo di valutazione.

Tipo: stringa

Vincoli per la lunghezza: lunghezza minima pari a 1, lunghezza massima pari a 40

sectionRefId

L’identificatore della sezione principale.

Tipo: stringa

Vincoli per la lunghezza: lunghezza minima pari a 1, lunghezza massima pari a 40

questionType

Il tipo di domanda.

Tipo: le note StrThe combinate di una valutazione hanno un limite di N x 1024 caratteri, dove N è il numero di domande nella valutazione.ing

Valori validi: TEXT | SINGLESELECT | NUMERIC

questionText

Il titolo della domanda.

Tipo: stringa

Vincoli per la lunghezza: lunghezza minima pari a 0, lunghezza massima pari a 350

answer

La risposta alla domanda.

value

Il string/numeric valore di una risposta in una valutazione di un contatto.

Tipo: stringa/double

Vincoli per la lunghezza - Stringa: lunghezza minima pari a 0, lunghezza massima pari a 128

notes

Le note lasciate per la sezione.

Tipo: stringa

Vincoli per la lunghezza: lunghezza minima pari a 0. Lunghezza massima di 3072

Nota

Le note hanno un limite di due caratteri. Le singole note hanno un limite di 3.072 caratteri. Le note combinate di una valutazione hanno un limite di N x 1.024 caratteri, dove N è il numero di domande della valutazione.

metadati

notApplicable

Flag che contrassegna la domanda come non applicabile.

Tipo: booleano

assistedSuggestion

Risposta suggerita dall’IA generativa.

Tipo: stringa

automazione
status

Lo stato della risposta dell’automazione.

Tipo: stringa

Valori validi: UNAVAILABLE | SYSTEM_ANSWER | OVERRIDDEN_ANSWER

systemSuggestedValue

La stringa o il valore numerico per una risposta dell’automazione nella valutazione di un contatto.

Tipo: stringa o double

Vincoli per la lunghezza - Stringa: lunghezza minima pari a 0, lunghezza massima pari a 128

score

score della domanda.

  • automaticFail: il flag che contrassegna l’elemento come fondamentale per il modulo e il modulo completo avranno esito negativo (contrassegnati con punteggio pari a zero) quando l’elemento presenta un errore. Se l’elemento o un elemento secondario riceve una risposta automatica di errore, questo flag sarà true e anche il modulo completo avrà esito negativo.

    Tipo: booleano

  • notApplicable: il flag che contrassegna l’elemento come non applicabile ai fini del punteggio verrà escluso dal calcolo del punteggio.

    Tipo: booleano

Esempio di valutazione esportata

Nell’esempio seguente viene mostrata una valutazione esportata tipica.

{
"schemaVersion": "3.1",
"evaluationId": "fb90de35-4507-479a-8b57-970290fd5c2c",
 "metadata": {
    "contactId": "badd4896-75f7-43b3-bee6-c617ed3d04cb",
    "accountId": "874551140838",
    "instanceId": "8f753c94-9cd2-4f16-85eb-945f7f0d559a",
    "agentId": "286bcec0-e722-4166-865f-84db80252218",
    "evaluationDefinitionTitle": "Compliance Evaluation Form",
    "evaluator": "jane",
    "evaluationDefinitionId": "15d8fbf1-b4b2-4ace-869b-82714e2f6e3e",
    "evaluationDefinitionVersion": 2,
    "evaluationStartTimestamp": "2022-11-14T17:57:08.649Z",
    "evaluationSubmitTimestamp": "2022-11-14T17:59:29.052Z",
    "score": { "percentage": 100 },
    "creator": "john",
    "autoEvaluated": false, 
    "resubmitted": false, 
    "evaluationSource": "ASSISTED_BY_AUTOMATION",    
     "acknowledgerComment": "Manager walked through the evaluation during coaching",
    "evaluationAcknowledgedByUserId": "286bcec0-e722-4166-865f-84db80252218",
     "evaluationAcknowledgedByUserName": "mike",
     "evaluationAcknowledgedTimestamp": "2022-12-24T15:45:56.662Z"       
  },
  },
"sections": [
    {
      "sectionRefId": "s1a1b58d6",
      "sectionTitle": "The title of the section",
      "notes": "Section note",
      "score": { "percentage": 100 }
    },
    {
      "sectionRefId": "s46661c49",
      "sectionTitle": "The title of the subsection",
      "parentSectionRefId": "s1a1b58d6",
      "score": { "percentage": 100 }
    }
  ],
"questions": [
    {
      "questionRefId": "q570b206a",
      "sectionRefId": "s46661c49",
      "questionType": "NUMERIC",
      "questionText": "How do you rate the contact between 1 and 10?",
      "answer": {
        "value": "",
        "notes": "Add more information here",
        "metadata": { "notApplicable": true }
      },
      "score": { "notApplicable": true }
    },
    {
      "questionRefId": "q73bc5b9d",
      "sectionRefId": "s46661c49",
      "questionType": "SINGLESELECT",
      "questionText": "Did the agent introduce themselves?",
      "answer": {
        "values": [
          { "valueText": "Yes", "valueRefId": "o6999aa94", "selected": true },
          { "valueText": "No", "valueRefId": "o284e4d9e", "selected": false },
          { "valueText": "Maybe", "valueRefId": "o1b2f0a14", "selected": false }
        ],
        "notes": "Add more information here",
        "automation": {
            "status": "SYSTEM_ANSWER",
            "systemSuggestedValue": "Yes"
        },
        "metadata": { "notApplicable": false }
      },
      "score": { "percentage": 100 }
    },
    {
      "questionRefId": "h89bc7a9t",
      "sectionRefId": "s46661c49",
      "questionType": "SINGLESELECT",
      "questionText": "Did the agent offer a promotion?",
      "answer": {
        "values": [
          { "valueText": "Yes", "valueRefId": "o6999aa94", "selected": false },
          { "valueText": "No", "valueRefId": "o284e4d9e", "selected": true },
          { "valueText": "Maybe", "valueRefId": "o1b2f0a14", "selected": false }
        ],
        "notes": "Add more information here",
        "assistedSuggestion": {
            value: "No. A promotion was not offered by the agent."
        },
        "metadata": { "notApplicable": false }
      },
      "score": { "percentage": 100 }
    },
    {
      "questionRefId": "qc2effc9d",
      "sectionRefId": "s46661c49",
      "questionType": "TEXT",
      "questionText": "Describe the outcome.",
      "answer": {
        "value": "Example answer text",
        "notes": "Add more information here",
        "metadata": { "notApplicable": false }
      },
      "score": { "notApplicable": true }
    }
  ]
}