Vérification du compartiment S3 Exemples d'emplacements de sortie Problème connu Exemples de scores Définitions des métadonnées du formulaire d’évaluation Exemple d’évaluation exportée

Sortie du formulaire d’évaluation des agents dans Amazon Connect

Cette section indique le chemin de sortie d’exportation des évaluations et fournit un exemple de scores et de métadonnées pour les formulaires d’évaluation.

Table des matières

Vérification du compartiment S3
Exemples d'emplacements de sortie
Problème connu
Exemples de scores
Définitions des métadonnées du formulaire d’évaluation
Exemple d’évaluation exportée

Vérification du compartiment S3

Lorsque vous activez Évaluations des contacts dans la console Amazon Connect , il vous est demandé de créer ou de choisir un compartiment S3 pour stocker les évaluations. Pour vérifier le nom du compartiment, accédez à l’alias de l’instance, choisissez Stockage de données, Évaluations des contacts, puis Modifier.

Exemples d'emplacements de sortie

Le chemin du fichier de sortie pour les formulaires d'évaluation est le suivant :

contact_evaluations_S3_bucketYYYY/MM/DD/hh:mm:ss.sTZD/Évaluations/ - .json evaluation_id

Par exemple :

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

Problème connu : deux fichiers de sortie pour la même évaluation

Contact Lens génère deux fichiers de sortie pour le même formulaire d’évaluation.

Un fichier est écrit dans le nouveau chemin S3 par défaut. Vous pouvez configurer le chemin dans la AWS console.
Un autre fichier, qui sera obsolète, est écrit sur un ancien chemin S3 différent. Vous pouvez ignorer ce fichier.

Le chemin S3 précédent ressemble à ce qui suit :
- s3_bucket/Evaluations/contact_ /évaluation_ /yyyy-mm-:mm:ss.stzd.json contactId evaluationId DDThh

Exemples de scores

L’exemple suivant montre un score typique.


 {
"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 }
    }
  ]
}

Définitions des métadonnées du formulaire d’évaluation

La liste suivante décrit les champs du formulaire d’évaluation.

evaluationId

Identifiant unique pour l’évaluation du contact

Type : String

Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 500 caractères

metadata

contactId

Identifiant du contact dans cette instance d’Amazon Connect.

Type : String

Contraintes de longueur : longueur minimale de 1 caractère, longueur maximale de 256 caractères

accountId

Identifiant du AWS compte exécutant l'instance d'Amazon Connect.

Type : String

Contraintes de longueur — Contraintes : 12 chiffres

Motif — ^\d{12}$

instanceId

L'identifiant de l'instance Amazon Connect. Vous pouvez trouver l’ID d’instance dans l’Amazon Resource Name (ARN) de l’instance.

Contraintes de longueur : longueur minimale de 1 caractère, longueur maximale de 100 caractères

agentId

Identifiant de l’agent qui a effectué le contact.

Type : String

Contraintes de longueur : longueur minimale de 1 caractère, longueur maximale de 500 caractères

evaluationDefinitionTitle

Titre du formulaire d’évaluation.

Type : String

Contraintes de longueur : longueur minimale de 1 caractère, longueur maximale de 128 caractères

evaluator

Nom de l’utilisateur qui a mis à jour l’évaluation pour la dernière fois.

Type : String

evaluationDefinitionId

Identifiant unique du formulaire d’évaluation.

Type : String

Contraintes de longueur : longueur minimale de 1 caractère, longueur maximale de 500 caractères

evaluationDefinitionVersion

Version du formulaire d’évaluation.

Type : Integer

Plage valide : valeur minimum de 1.

evaluationStartTimestamp

Date et heure de création de l’évaluation.

Type : Timestamp

score

Score de l’évaluation.

creator

Entité qui a créé l’évaluation la toute première fois (par opposition à « evaluator » qui représente l’entité qui a soumis l’évaluation pour la dernière fois). Lorsque l'appel est effectué depuis le site Web Amazon Connect d'administration, il contient le nom d'utilisateur. Lorsque l’appel provient de l’API, il contient l’ARN de l’appelant.

Type : String

autoEvaluated

Indique si l’évaluation a été soumise à l’aide d’évaluations entièrement automatisées.

Type : Boolean

renvoyé

Indique si l’évaluation a été soumise à nouveau (modifiée avant d’être soumise à nouveau).

Type : Boolean

evaluationSource

Type de source de réponse à l’évaluation.

Type : String

Valeurs valides :

ASSISTED_BY_AUTOMATION : indique que l’automatisation des questions a été utilisée pour répondre à certaines questions.
MANUAL : indique que l’évaluation a été réalisée manuellement.
AUTOMATED : indique que l’évaluation a été soumise à l’aide d’évaluations entièrement automatisées (voir le champ « autoEvaluated »).

acknowledgerComment

Commentaire laissé par l’utilisateur qui a accusé réception de l’évaluation.

Type : String

Contraintes de longueur : longueur minimale de 0 caractère, longueur maximale de 3 072 caractères

evaluationAcknowledgedByUserId

Identifiant de la personne qui a accusé réception de l’évaluation.

Type : String

Contraintes de longueur : longueur minimale de 1 caractère, longueur maximale de 500 caractères

evaluationAcknowledgedByUserName

Nom de la personne qui a accusé réception de l’évaluation.

Type : String

evaluationAcknowledgedTimestamp

Date et heure de l’accusé de réception de l’évaluation.

Type : Timestamp

sections

Tableau des sections de l’évaluation.

sectionRefId

Identifiant de la section. Un identifiant doit être unique dans le formulaire d’évaluation.

Type : String

Contraintes de longueur : longueur minimale de 1 caractère, longueur maximale de 40 caractères

parentSectionRefId

Identifiant de la section parent.

Type : String

Contraintes de longueur : longueur minimale de 1 caractère, longueur maximale de 40 caractères

sectionTitle

Titre de la section.

Type : String

Contraintes de longueur — Contraintes : longueur minimale de 0 caractère, longueur maximale de 128 caractères.

notes

Notes laissées pour cette section.

Type : String

Contraintes de longueur : longueur minimale de 0 caractère, longueur maximale de 3 072 caractères

Note

Les notes ont les limites suivantes :

Les notes individuelles sont limitées à 3 072 caractères.
Les notes combinées d’une évaluation sont limitées à N x 1 024 caractères, où N correspond au nombre de questions de l’évaluation.

score

Score de la section.

percentage

Pourcentage de score attribué à un élément lors de l’évaluation d’un contact.

Type : Double

Plage valide : valeur minimum de 0, valeur maximum de 100.

automaticFail

Indicateur qui marque l’élément comme échec automatique. Si l’élément ou un élément enfant reçoit une réponse d’échec automatique, cet indicateur est défini sur « true ».

Type : Boolean

notApplicable

Indicateur qui marque l’élément comme échec automatique. Si l’élément ou un élément enfant reçoit une réponse d’échec automatique, cet indicateur est défini sur « true ».

Type : Boolean

questions

Tableau des questions de l’évaluation.

questionRefId

Identifiant de la question. Un identifiant doit être unique dans le formulaire d’évaluation.

Type : String

Contraintes de longueur : longueur minimale de 1 caractère, longueur maximale de 40 caractères.

sectionRefId

Identifiant de la section parent.

Type : String

Contraintes de longueur : longueur minimale de 1 caractère, longueur maximale de 40 caractères

questionType

Type de question.

Type : les notes StrThe combinées dans une évaluation ont une limite de N x 1024 caractères, où N est le nombre de questions de l'évaluation.ing

Valeurs valides – TEXT | SINGLESELECT | NUMERIC

questionText

Titre de la question.

Type : String

Contraintes de longueur : longueur minimale de 0 caractère, longueur maximale de 350 caractères

answer

Réponse à la question.

value

string/numeric Valeur d'une réponse lors de l'évaluation d'un contact.

Type : String/Double

Contraintes de longueur (chaîne) : longueur minimale de 0 caractère, longueur maximale de 128 caractères.

notes

Notes laissées pour cette section.

Type : String

Contraintes de longueur : longueur minimale de 0 caractère. Longueur maximale de 3 072 caractères

Note

Les notes sont limitées à deux caractères. Les notes individuelles sont limitées à 3 072 caractères. Les notes combinées d’une évaluation sont limitées à N x 1 024 caractères, où N correspond au nombre de questions de l’évaluation.

metadata

notApplicable

Indicateur signalant que la question n’est pas applicable.

Type : Boolean

assistedSuggestion

Réponse suggérée par l’IA générative.

Type : String

Automatisation

status

Statut de la réponse d’automatisation.

Type : String

Valeurs valides – UNAVAILABLE | SYSTEM_ANSWER | OVERRIDDEN_ANSWER

systemSuggestedValue

Chaîne ou valeur numérique d’une réponse d’automatisation lors de l’évaluation d’un contact.

Type : String ou Double

Contraintes de longueur (chaîne) : longueur minimale de 0 caractère, longueur maximale de 128 caractères

score

score de la question.

automaticFail : indicateur qui signale que l’élément en question est essentiel pour le formulaire et que le formulaire complet échouera (et sera marqué d’un score nul) en cas d’échec de cet élément. Si cet élément ou un élément enfant reçoit une réponse d’échec automatique, cet indicateur sera défini sur « true » et le formulaire complet échouera également.

Type : Boolean
notApplicable : indicateur signalant que l’élément en question n’est pas applicable pour la notation et qu’il sera exclu du calcul du score.

Type : Boolean

Exemple d’évaluation exportée

L’exemple suivant montre une évaluation exportée type.


{
"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 }
    }
  ]
}

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Métriques d’évaluation

Sessions d’étalonnage pour les évaluations des performances