As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Saída do formulário de avaliação do atendente no Amazon Connect
Esta seção mostra o caminho de saída de exportação para avaliações e fornece um exemplo de pontuações do formulário de avaliação e descreve os respectivos metadados.
**Topics**
+ [Verificar o bucket do S3](#verify-evaluation-s3bucket)
+ [Exemplos de locais de saída](#example-evaluationform-output-locations)
+ [Problema conhecido](#release-note-evaluation-output)
+ [Exemplos de pontuação](#example-evaluation-output-file)
+ [Definições de metadados do formulário de avaliação](#evaluation-form-metadata)
+ [Exemplo de avaliação exportada](#exported-evaluation)
## Verificar o bucket do S3
Ao habilitar **Avaliações de contato** no console do Amazon Connect , você receberá a solicitação de criar ou escolher um bucket do S3 para armazenar as avaliações. Para verificar o nome do bucket, acesse o alias da instância, escolha **Armazenamento físico de dados**, **Avaliações de contato** e **Editar**.
## Exemplos de locais de saída
A seguir encontra-se o caminho do arquivo de saída para formulários de avaliação:
+ *contact\$1evaluations\$1S3\$1bucket**YYYY/MM/DD/hh:mm:ss.sTZD*/Avaliações/ - .json *evaluation\$1id*
Por exemplo:
`amazon-connect-s3/Evaluations/2022/04/14/05:04:20.869Z-11111111-2222-3333-4444-555555555555.json`
## Problema conhecido: dois arquivos de saída para a mesma avaliação
O Contact Lens gera dois arquivos de saída para o mesmo formulário de avaliação.
+ Um arquivo é gravado no novo caminho padrão do S3. Você pode configurar o caminho no AWS console.
+ Outro arquivo, que será descontinuado, é gravado em um caminho anterior diferente do S3. Você pode ignorar esse arquivo.
O caminho anterior do S3 tem a seguinte aparência:
+ *s3\$1bucket*/Evaluations/contact\$1 *contactId* /evaluation\$1 /aaaa-mm-:mm:ss.stzd.json *evaluationId* DDThh
## Exemplos de pontuação
O exemplo a seguir mostra uma pontuação típica.
```
{
"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
}
}
]
}
```
## Definições de metadados do formulário de avaliação
A lista a seguir descreve os campos no formulário de avaliação.
**evaluationId**
Um identificador exclusivo para a avaliação de contato
*Tipo*: String
*Restrições de tamanho*: tamanho mínimo de 1. Tamanho máximo de 500
**metadata**
**contactId**
O identificador do contato nesta instância do Amazon Connect.
*Tipo*: String
*Restrições de tamanho*: tamanho mínimo de 1 e máximo de 256
**accountId**
O identificador da AWS conta que executa a instância do Amazon Connect.
*Tipo*: String
*Restrições de tamanho:* restrições: 12 dígitos
*Padrão*: `^\d{12}$`
**instanceId**
O identificador da instância do Amazon Connect. Você pode [encontrar o ID da instância](find-instance-arn.md) no nome do recurso da Amazon (ARN) da instância.
*Restrições de tamanho*: tamanho mínimo de 1 e máximo de 100
**agentId**
O identificador do atendente que realizou o contato.
*Tipo*: String
*Restrições de tamanho*: tamanho mínimo de 1 e máximo de 500
**evaluationDefinitionTitle**
O título do formulário de avaliação.
*Tipo*: String
*Restrições de tamanho*: tamanho mínimo de 1 e máximo de 128
**evaluator**
Nome do usuário que atualizou a avaliação por último.
*Tipo*: String
**evaluationDefinitionId**
O identificador exclusivo do formulário de avaliação.
*Tipo*: String
*Restrições de tamanho*: tamanho mínimo de 1 e máximo de 500.
**evaluationDefinitionVersion**
A versão do formulário de avaliação.
*Tipo*: Inteiro
*Intervalo válido*: valor mínimo de 1
**evaluationStartTimestamp**
A data e hora de criação da avaliação.
*Tipo*: data e hora
*Exemplo* — 2025-11-14T 17:57:08.649 Z
**evaluationSubmitTimestamp**
A data e hora de envio da avaliação.
*Tipo*: data e hora
*Exemplo* — 2025-11-14T 17:59:29.052 Z
**score**
A pontuação da avaliação.
**creator**
A entidade que criou a avaliação pela primeira vez (em vez de “avaliador”, que representa a entidade que enviou a avaliação por último). Quando a chamada é feita a partir do site Amazon Connect administrativo, ela contém o nome de usuário. Quando a chamada vem da API, ela contém o ARN do chamador.
*Tipo*: String
**autoEvaluated **
Indica se a avaliação foi enviada usando avaliações totalmente automatizadas.
*Tipo*: booliano
**resubmitted **
Indica se a avaliação foi reenviada (editada e enviada novamente).
*Tipo*: booliano
**evaluationSource **
O tipo de fonte de resposta da avaliação.
*Tipo*: String
Valores válidos:
+ `ASSISTED_BY_AUTOMATION`: indica que a [automação de perguntas](create-evaluation-forms.md#step-automate) foi usada para responder a algumas das perguntas.
+ `MANUAL`: indica que a avaliação foi realizada manualmente.
+ `AUTOMATED`: indica que a avaliação foi enviada usando avaliações totalmente automatizadas (consulte o campo “autoEvaluated”).
**Tipo de avaliação**
O tipo de avaliação.
*Tipo*: String
Valores válidos:
+ `CONTACT_EVALUATION`- avaliação de um contato.
**calibrationSessionId**
O identificador da sessão de calibração associada a essa avaliação.
*Tipo*: String
*Restrições de tamanho*: tamanho mínimo de 1 e máximo de 500
**evaluatedParticipantId**
O identificador do participante que está sendo avaliado.
*Tipo*: String
*Restrições de tamanho*: tamanho mínimo de 1 e máximo de 256
**evaluatedParticipantRole**
O papel do participante que está sendo avaliado.
*Tipo*: String
Valores válidos:
+ `AGENT`- o agente participante.
+ `CUSTOMER`- o cliente participante.
+ `SYSTEM`- o participante do sistema.
**acknowledgerComment**
Comentário deixado pelo usuário que confirmou a avaliação.
*Tipo*: String
*Restrições de tamanho*: tamanho mínimo de 0 e máximo de 3072
**evaluationAcknowledgedByUserId**
O identificador da pessoa que confirmou a avaliação.
*Tipo*: String
*Restrições de tamanho*: tamanho mínimo de 1 e máximo de 500
**evaluationAcknowledgedByUserName**
O nome da pessoa que confirmou a avaliação.
*Tipo*: String
**evaluationAcknowledgedTimestamp**
O carimbo de data/hora de confirmação da avaliação.
*Tipo*: data e hora
*Exemplo* — 2025-12-24T 15:45:56.662 Z
**sections**
Matriz das seções da avaliação.
**sectionRefId**
O identificador da seção. Um identificador deve ser exclusivo no formulário de avaliação.
*Tipo*: String
*Restrições de tamanho*: tamanho mínimo de 1 e máximo de 40
**parentSectionRefIdentificação**
O identificador da seção pai.
*Tipo*: String
*Restrições de tamanho*: tamanho mínimo de 1 e máximo de 40
**sectionTitle**
O título da seção.
*Tipo*: String
*Restrições de tamanho*: restrições: tamanho mínimo de 0 e máximo de 128
**observações**
As observações deixadas para a seção.
*Tipo*: String
*Restrições de tamanho*: tamanho mínimo de 0 e máximo de 3072
As observações têm os seguintes limites:
+ As observações individuais têm um limite de 3.072 caracteres.
+ As observações combinadas em uma avaliação têm um limite de *N* x 1.024 caracteres, em que *N* é o número de perguntas na avaliação.
**score**
A pontuação da seção.
**percentage**
A porcentagem de pontuação de um item em uma avaliação de contato.
*Tipo*: duplo
*Intervalo válido*: valor mínimo de 0 e máximo de 100
**automaticFail**
O sinalizador que marca o item como falha automática. Se o item ou um item secundário obtiver uma resposta de falha automática, esse sinalizador será verdadeiro.
*Tipo*: booliano
**notApplicable**
O sinalizador que marca o item como falha automática. Se o item ou um item secundário obtiver uma resposta de falha automática, esse sinalizador será verdadeiro.
*Tipo*: booliano
**perguntas**
Matriz das perguntas da avaliação.
**questionRefId**
O identificador da pergunta. Um identificador deve ser exclusivo no formulário de avaliação.
*Tipo*: String
*Restrições de tamanho*: tamanho mínimo de 1 e máximo de 40.
**sectionRefId**
O identificador da seção pai.
*Tipo*: String
*Restrições de tamanho*: tamanho mínimo de 1 e máximo de 40
**questionType**
O tipo da pergunta.
*Tipo* — as notas StrThe combinadas em uma avaliação têm um limite de *N* x 1024 caracteres, onde *N* é o número de perguntas na avaliação.ing
*Valores válidos*: `TEXT | SINGLESELECT | NUMERIC`
**questionText**
O título da pergunta.
*Tipo*: String
*Restrições de tamanho*: tamanho mínimo de 0 e máximo de 350
**answer**
A resposta para a pergunta.
**valor**
O string/numeric valor de uma resposta em uma avaliação de contato.
*Tipo*: string/duplo
*Restrições de tamanho*: string: tamanho mínimo de 0 e máximo de 128
**observações**
As observações deixadas para a seção.
*Tipo*: String
*Restrições de tamanho*: tamanho mínimo de 0. Tamanho máximo de 3.072
As observações têm limites de dois caracteres. As observações individuais têm um limite de 3.072 caracteres. As observações combinadas em uma avaliação têm um limite de N x 1.024 caracteres, em que N é o número de perguntas na avaliação.
**metadata**
**notApplicable **
Sinalizador que marca a pergunta como não aplicável.
*Tipo*: booliano
**assistedSuggestion**
Resposta sugerida pela [IA generativa](generative-ai-performance-evaluations.md).
*Tipo*: String
**automação**
**status**
O status da resposta de automação.
*Tipo*: String
*Valores válidos*: `UNAVAILABLE | SYSTEM_ANSWER | OVERRIDDEN_ANSWER`
**systemSuggestedValue**
A string ou valor numérico de uma resposta de automação em uma avaliação de contato.
*Tipo*: string ou duplo
*Restrições de tamanho*: string: tamanho mínimo de 0 e máximo de 128
**score**
A [score](#score) da pergunta.
+ automaticFail: o sinalizador que marca o item como crítico para o formulário e o formulário completo falhará (marcado com pontuação zero) quando o item falhar. Se o item ou um item secundário obtiver uma resposta de falha automática, esse sinalizador será verdadeiro e o formulário completo também falhará.
*Tipo*: booliano
+ Não aplicável: o sinalizador que marca o item como não aplicável para pontuação será excluído dos cálculos de pontuação.
*Tipo*: booliano
## Exemplo de avaliação exportada
O exemplo a seguir mostra uma avaliação 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
}
}
]
}
```