Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Salida del formulario de evaluación del agente en Amazon Connect
<a name="evaluationforms-example-output-file"></a>

Esta sección muestra la ruta de salida de exportación para las evaluaciones, proporciona un ejemplo de puntuaciones del formulario de evaluación y describe los metadatos del formulario de evaluación.

**Topics**
+ [Verificación del bucket de S3](#verify-evaluation-s3bucket)
+ [Ejemplos de ubicaciones de salida](#example-evaluationform-output-locations)
+ [Problema conocido](#release-note-evaluation-output)
+ [Puntuaciones de ejemplo](#example-evaluation-output-file)
+ [Definiciones de metadatos del formulario de evaluación](#evaluation-form-metadata)
+ [Ejemplo de evaluación exportada](#exported-evaluation)

## Verificación del bucket de S3
<a name="verify-evaluation-s3bucket"></a>

Cuando habilite **Evaluaciones de contacto** en la consola de Amazon Connect , se le pedirá que cree o elija un bucket de S3 para almacenar las evaluaciones. Para verificar el nombre del bucket, vaya al alias de su instancia, elija **Almacenamiento de datos**, **Evaluaciones de contacto**, **Editar**.

## Ejemplos de ubicaciones de salida
<a name="example-evaluationform-output-locations"></a>

A continuación, se indica la ruta del archivo de salida de los formularios de evaluación:
+ *contact\$1evaluations\$1S3\$1bucket**YYYY/MM/DD/hh:mm:ss.sTZD*/Evaluaciones/ - .json *evaluation\$1id*

Por ejemplo:

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

## Problema conocido: dos archivos de salida para la misma evaluación
<a name="release-note-evaluation-output"></a>

Contact Lens genera dos archivos de salida para el mismo formulario de evaluación.
+ Un archivo se escribe en la nueva ruta predeterminada de S3. Puede configurar la ruta en la consola. AWS 
+ Otro archivo, que quedará obsoleto, se escribe en una ruta de S3 diferente, anterior. Puede ignorar este archivo.

  La ruta de S3 anterior se parece a la siguiente:
  + *s3\$1bucket*/Evaluations/contact\$1 *contactId* /evaluation\$1 /yyyy-MM-:mm:ss.stzd.json *evaluationId* DDThh

## Puntuaciones de ejemplo
<a name="example-evaluation-output-file"></a>

A continuación se muestra un ejemplo de puntuación.

```
{
  "schemaVersion": "3.5",
  "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": "2025-11-14T17:57:08.649Z",
    "evaluationSubmitTimestamp": "2025-11-14T17:59:29.052Z",
    "score": {
      "percentage": 100
    },
    "creator": "jane.doe@acme.com",
    "autoEvaluated": false,
    "resubmitted": false,
    "evaluationSource": "ASSISTED_BY_AUTOMATION",
    "evaluationType": "CONTACT_EVALUATION",
    "evaluationAcknowledgerComment": "The Acknowledgment comment",
    "evaluationAcknowledgedTimestamp": "2025-12-22T05:20:39.297Z",
    "evaluationAcknowledgedByUserName": "john",
    "evaluationAcknowledgedByUserId": "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": "p7888bb85",
            "selected": false
          },
          {
            "valueText": "No",
            "valueRefId": "p395f5e8f",
            "selected": true
          },
          {
            "valueText": "Maybe",
            "valueRefId": "p2c3g1b25",
            "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": {
        "percentage": 50
      }
    }
  ]
}
```

## Definiciones de metadatos del formulario de evaluación
<a name="evaluation-form-metadata"></a>

En la siguiente lista se describen los campos del formulario de evaluación.

**evaluationId**  
Un identificador único para la evaluación del contacto  
*Tipo*: cadena  
*Limitaciones de longitud:* longitud mínima de 1. La longitud máxima es de 500

**metadatos**    
**contactId**  
El identificador del contacto en esta instancia de Amazon Connect.  
*Tipo*: cadena  
*Limitaciones de longitud*: longitud mínima de 1, longitud máxima de 256  
**accountId**  
El identificador de la AWS cuenta que ejecuta la instancia de Amazon Connect.  
*Tipo*: cadena  
*Restricciones de longitud*: restricciones: 12 dígitos  
*Patrón*: `^\d{12}$`  
**instanceId**  
El identificador de la instancia de Amazon Connect. Puede [encontrar el ID de instancia](find-instance-arn.md) en el nombre de recurso de Amazon (ARN) de la instancia.  
*Limitaciones de longitud*: longitud mínima de 1, longitud máxima de 100  
**agentId**  
El identificador del agente que realizó el contacto.  
*Tipo*: cadena  
*Limitaciones de longitud*: longitud mínima de 1, longitud máxima de 500  
**evaluationDefinitionTitle**  
El título del formulario de evaluación.  
*Tipo*: cadena  
*Limitaciones de longitud*: longitud mínima de 1, longitud máxima de 128  
**evaluator**  
El nombre del usuario que ha actualizado la evaluación por última vez.  
*Tipo*: cadena  
**evaluationDefinitionId**  
Un identificador único para el formulario de evaluación.  
*Tipo*: cadena  
*Limitaciones de longitud*: longitud mínima de 1, longitud máxima de 500  
**evaluationDefinitionVersion**  
La versión del formulario de evaluación.  
*Tipo*: entero  
*Rango válido*: valor mínimo de 1.  
**evaluationStartTimestamp**  
La marca de tiempo de creación de la evaluación.  
*Tipo*: marca temporal  
*Ejemplo*: 2025-11-14T 17:57:08.649 Z  
**evaluationSubmitTimestamp**  
Fecha y hora de presentación de la evaluación.  
*Tipo*: marca temporal  
*Ejemplo*: 2025-11-14T 17:59:29 .052 Z  
**puntuación**  
La puntuación de la evaluación.  
**creator**  
 La entidad que ha creado la evaluación la primera vez (a diferencia de evaluador, que representa a la entidad que envió la evaluación por última vez). Cuando la llamada se realiza desde el sitio web de administración, contiene el nombre de usuario. Amazon Connect Cuando la llamada proviene de la API, contiene el ARN de la persona que llama.   
*Tipo*: cadena  
**autoEvaluated **  
 Indica si la evaluación se ha enviado mediante evaluaciones totalmente automatizadas.  
*Tipo*: booleano  
**resubmitted **  
 Indica si la evaluación se ha vuelto a enviar (se ha editado y se ha vuelto a enviar).  
*Tipo*: booleano  
**evaluationSource **  
El origen del tipo de respuesta de evaluación.  
*Tipo*: cadena  
Valores válidos:  
+ `ASSISTED_BY_AUTOMATION`: indica que se ha utilizado la [automatización de preguntas](create-evaluation-forms.md#step-automate) para responder a algunas de las preguntas.
+ `MANUAL`: indica que la evaluación se ha realizado manualmente.
+ `AUTOMATED`: indica que la evaluación se ha enviado mediante evaluaciones totalmente automatizadas (consulte el campo autoEvaluated).  
**Tipo de evaluación**  
El tipo de evaluación.  
*Tipo*: cadena  
Valores válidos:  
+ `CONTACT_EVALUATION`- evaluación de un contacto.  
**calibrationSessionId**  
El identificador de la sesión de calibración asociada a esta evaluación.  
*Tipo*: cadena  
*Limitaciones de longitud*: longitud mínima de 1, longitud máxima de 500  
**evaluatedParticipantId**  
El identificador del participante que se está evaluando.  
*Tipo*: cadena  
*Limitaciones de longitud*: longitud mínima de 1, longitud máxima de 256  
**evaluatedParticipantRole**  
El papel del participante que se está evaluando.  
*Tipo*: cadena  
Valores válidos:  
+ `AGENT`- el agente participante.
+ `CUSTOMER`- el cliente participante.
+ `SYSTEM`- el participante del sistema.  
**acknowledgerComment**  
Comentario dejado por el usuario que reconoció la evaluación.  
*Tipo*: cadena  
*Limitaciones de longitud*: longitud mínima de 0, longitud máxima de 3072  
**evaluationAcknowledgedByUserId**  
El identificador de la persona que reconoció la evaluación.  
*Tipo*: cadena  
*Limitaciones de longitud*: longitud mínima de 1, longitud máxima de 500  
**evaluationAcknowledgedByUserName**  
El nombre de la persona que reconoció la evaluación.  
*Tipo*: cadena  
**evaluationAcknowledgedTimestamp**  
La marca de tiempo de reconocimiento de la evaluación.   
*Tipo*: marca temporal  
*Ejemplo*: 2025-12-24T 15:45:56 .662 Z

**sections**  
Matriz de las secciones de la evaluación.    
**sectionRefId**  
El identificador de la sección. Un identificador debe ser único dentro del formulario de evaluación.   
*Tipo*: cadena  
*Limitaciones de longitud*: longitud mínima de 1, longitud máxima de 40  
**parentSectionRefID**  
El identificador de la sección principal.  
*Tipo*: cadena  
*Limitaciones de longitud*: longitud mínima de 1, longitud máxima de 40  
**sectionTitle**  
El título de la sección.  
*Tipo*: cadena  
*Limitaciones de longitud*: longitud mínima de 0, longitud máxima de 128  
**notas**  
Las notas que quedan para la sección.  
*Tipo*: cadena  
*Limitaciones de longitud*: longitud mínima de 0, longitud máxima de 3072  
Las notas tienen los siguientes límites:  
+ Las notas individuales tienen un límite de 3072 caracteres. 
+ Las notas combinadas de una evaluación tienen un límite de *N* x 1024 caracteres, donde *N* es el número de preguntas de la evaluación.  
**puntuación**  
La puntuación de la sección.    
**percentage**  
El porcentaje de puntuación de un elemento en la evaluación de un contacto.  
*Tipo*: Doble  
*Rango válido*: valor mínimo de 0, valor máximo de 100  
**automaticFail**  
El indicador que marca el elemento como error automático. Si el elemento o un elemento secundario recibe una respuesta de error automática, esta marca será verdadera.  
*Tipo*: booleano  
**notApplicable**  
El indicador que marca el elemento como error automático. Si el elemento o un elemento secundario recibe una respuesta de error automática, esta marca será verdadera.  
*Tipo*: booleano

**preguntas**  
Conjunto de las preguntas de la evaluación.    
**questionRefId**  
El identificador de la pregunta. Un identificador debe ser único dentro del formulario de evaluación.  
*Tipo*: cadena  
*Limitaciones de longitud*: longitud mínima de 1, longitud máxima de 40  
**sectionRefId**  
El identificador de la sección principal.   
*Tipo*: cadena  
*Limitaciones de longitud*: longitud mínima de 1, longitud máxima de 40  
**questionType**  
El tipo de pregunta.  
*Tipo*: las notas StrThe combinadas de una evaluación tienen un límite de *N* x 1024 caracteres, donde *N* es el número de preguntas de la evaluación.ing  
*Valores válidos*: `TEXT | SINGLESELECT | NUMERIC`  
**questionText**  
El título de la pregunta.  
*Tipo*: cadena  
*Limitaciones de longitud*: longitud mínima de 0, longitud máxima de 350  
**answer**  
La respuesta a la pregunta.    
**valor**  
El string/numeric valor de una respuesta en una evaluación por contacto.  
*Tipo*: cadena/doble  
*Limitaciones de longitud*: cadena: longitud mínima de 0, longitud máxima de 128  
**notas**  
Las notas que quedan para la sección.  
*Tipo*: cadena  
*Limitaciones de longitud:* longitud mínima de 0. La longitud máxima es de 3072  
Las notas tienen límites de dos caracteres. Las notas individuales tienen un límite de 3072 caracteres. Las notas combinadas de una evaluación tienen un límite de N x 1024 caracteres, donde N es el número de preguntas de la evaluación.  
**metadatos**  
**notApplicable **  
Marca que señala la pregunta como no aplicable  
*Tipo*: booleano  
**assistedSuggestion**  
Respuesta sugerida por la [IA generativa](generative-ai-performance-evaluations.md).  
*Tipo*: cadena  
** Automation**    
**status**  
El estado de la respuesta de automatización.  
*Tipo*: cadena  
*Valores válidos*: `UNAVAILABLE | SYSTEM_ANSWER | OVERRIDDEN_ANSWER`  
**systemSuggestedValue**  
La cadena o el valor numérico de una respuesta de automatización en la evaluación de un contacto.  
*Tipo*: cadena o doble  
*Limitaciones de longitud*: cadena: longitud mínima de 0, longitud máxima de 128  
**puntuación**  
La [score](#score) de la pregunta.  
+ automaticFail: el indicador que marca el elemento como crítico para el formulario y el formulario completo fallará (marcado con una puntuación de cero) si el elemento falla. Si el elemento o un elemento secundario recibe una respuesta de error automático, esta marca será verdadera y el formulario completo también dará error.

  *Tipo*: booleano
+ notApplicable: el indicador que marca el elemento como no aplicable a la puntuación, se excluirá de los cálculos de puntuación.

  *Tipo*: booleano

## Ejemplo de evaluación exportada
<a name="exported-evaluation"></a>

En el siguiente ejemplo se muestra una evaluación exportada típica.

```
{
  "schemaVersion": "3.5",
  "evaluationId": "fb90de35-4507-479a-8b57-970290fd5c2c",
  "metadata": {
    "accountId": "874551140838",
    "instanceId": "8f753c94-9cd2-4f16-85eb-945f7f0d559a",
    "contactId": "badd4896-75f7-43b3-bee6-c617ed3d04cb",
    "agentId": "286bcec0-e722-4166-865f-84db80252218",
    "evaluationDefinitionTitle": "Legal 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": 85
    },
    "autoEvaluated": false,
    "creator": "john",
    "resubmitted": false,
    "evaluationSource": "ASSISTED_BY_AUTOMATION",
    "evaluationType": "CONTACT_EVALUATION",
    "calibrationSessionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "evaluationAcknowledgedByUserId": "286bcec0-e722-4166-865f-84db80252218",
    "evaluationAcknowledgedByUserName": "mike",
    "evaluationAcknowledgedTimestamp": "2022-12-24T15:45:56.662Z",
    "evaluationAcknowledgerComment": "Manager walked through the evaluation during coaching",
    "evaluatedParticipantId": "participant-123",
    "evaluatedParticipantRole": "AGENT"
  },
  "sections": [
    {
      "sectionRefId": "s1a1b58d6",
      "sectionTitle": "Communication Skills",
      "notes": "Overall communication was professional",
      "score": {
        "percentage": 90
      }
    },
    {
      "sectionRefId": "s46661c49",
      "sectionTitle": "Greeting and Introduction",
      "parentSectionRefId": "s1a1b58d6",
      "notes": "Agent followed proper greeting protocol",
      "score": {
        "percentage": 100
      }
    }
  ],
  "questions": [
    {
      "questionRefId": "q570b206a",
      "sectionRefId": "s46661c49",
      "questionType": "NUMERIC",
      "questionText": "How many times did agent interrupt the customer",
      "answer": {
        "value": "2",
        "notes": "Interruptions were minimal and appropriate",
        "metadata": {
          "notApplicable": false,
          "automation": {
            "status": "OVERRIDDEN_ANSWER",
            "systemSuggestedValue": "3"
          }
        }
      },
      "score": {
        "percentage": 80
      }
    },
    {
      "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": "N/A",
            "valueRefId": "system_default_null_value",
            "selected": false
          }
        ],
        "notes": "Agent provided clear introduction with name and department",
        "metadata": {
          "notApplicable": false,
          "assistedSuggestion": {
            "value": "The agent introduced themselves at the beginning of the call."
          }
        }
      },
      "score": {
        "percentage": 100
      }
    },
    {
      "questionRefId": "h89bc7a9t",
      "sectionRefId": "s46661c49",
      "questionType": "SINGLESELECT",
      "questionText": "Did the agent ask for consent to perform a credit check",
      "answer": {
        "values": [
          {
            "valueText": "Yes",
            "valueRefId": "o6999aa94",
            "selected": false
          },
          {
            "valueText": "No",
            "valueRefId": "o284e4d9e",
            "selected": true
          },
          {
            "valueText": "N/A",
            "valueRefId": "system_default_null_value",
            "selected": false
          }
        ],
        "notes": "Agent failed to obtain consent before credit check",
        "metadata": {
          "notApplicable": false
        }
      },
      "score": {
        "percentage": 0,
        "automaticFail": true
      }
    },
    {
      "questionRefId": "qc2effc9d",
      "sectionRefId": "s46661c49",
      "questionType": "MULTISELECT",
      "questionText": "What topics were discussed during the call",
      "answer": {
        "values": [
          {
            "valueText": "Account balance",
            "valueRefId": "topic_balance",
            "selected": true
          },
          {
            "valueText": "Payment options",
            "valueRefId": "topic_payment",
            "selected": true
          },
          {
            "valueText": "Account closure",
            "valueRefId": "topic_closure",
            "selected": false
          }
        ],
        "notes": "Customer inquired about balance and payment plans",
        "metadata": {
          "notApplicable": false
        }
      },
      "score": {
        "notApplicable": true
      }
    },
    {
      "questionRefId": "q8a9b0c1d",
      "sectionRefId": "s46661c49",
      "questionType": "TEXT",
      "questionText": "What was your general impression about the customer's satisfaction",
      "answer": {
        "value": "The customer seemed satisfied with the resolution and thanked the agent",
        "notes": "Positive customer sentiment throughout the call",
        "metadata": {
          "notApplicable": false
        }
      },
      "score": {
        "notApplicable": true
      }
    },
    {
      "questionRefId": "q2b3c4d5e",
      "sectionRefId": "s46661c49",
      "questionType": "DATETIME",
      "questionText": "What time was the follow-up scheduled",
      "answer": {
        "value": "2024-04-16T14:30:00+01:00",
        "notes": "Follow-up appointment confirmed with customer",
        "metadata": {
          "notApplicable": false
        }
      },
      "score": {
        "notApplicable": true
      }
    }
  ]
}
```