기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Connect의 에이전트 평가 양식 출력
이 섹션에서는 평가의 내보내기 출력 경로를 보여 주고, 평가 양식 점수의 예를 제공하며, 평가 양식 메타데이터를 설명합니다.
**Topics**
+ [S3 버킷 확인](#verify-evaluation-s3bucket)
+ [예제 출력 위치](#example-evaluationform-output-locations)
+ [알려진 문제](#release-note-evaluation-output)
+ [샘플 점수](#example-evaluation-output-file)
+ [평가 양식 메타데이터 정의](#evaluation-form-metadata)
+ [샘플 내보낸 평가](#exported-evaluation)
## S3 버킷 확인
Connect Customer 콘솔에서 **고객 응대 평가**를 활성화하면 평가를 저장할 S3 버킷을 만들거나 선택하라는 메시지가 표시됩니다. 버킷의 이름을 확인하려면 인스턴스 별칭으로 이동하여 **데이터 스토리지**, **고객 응대 평가**, **편집**을 선택합니다.
## 예제 출력 위치
다음은 평가 양식의 출력 파일 경로입니다.
+ {{contact\_evaluations\_S3\_bucket}}/Evaluations/{{YYYY/MM/DD/hh:mm:ss.sTZD}}-{{evaluation\_id}}.json
예제:
`amazon-connect-s3/Evaluations/2022/04/14/05:04:20.869Z-11111111-2222-3333-4444-555555555555.json`
## 알려진 문제: 동일한 평가에 대한 두 개의 출력 파일
Contact Lens는 동일한 평가 양식에 대해 두 개의 출력 파일을 생성합니다.
+ 하나의 파일이 새 기본 S3 경로에 기록됩니다. AWS 콘솔에서 경로를 구성할 수 있습니다.
+ 더 이상 사용되지 않을 다른 파일은 이전의 다른 S3 경로에 기록됩니다. 이 파일은 무시해도 됩니다.
이전 S3 경로는 다음과 같습니다.
+ {{s3\_bucket}}/Evaluations/contact\_{{contactId}}/evaluation\_{{evaluationId}}/YYYY-MM-DDThh:mm:ss.sTZD.json
## 샘플 점수
다음 예제는 일반적인 점수를 보여 줍니다.
```
{
"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
}
}
]
}
```
## 평가 양식 메타데이터 정의
다음 표에서는 평가 양식의 필드에 대해 설명합니다.
**evaluationId**
고객 응대 평가의 고유 식별자
*유형* - 문자열
*길이 제한* - 최소 길이 1. 최대 길이는 500입니다.
**metadata**
**contactId**
Amazon Connect의 이 인스턴스에서 연락처의 식별자입니다.
*유형* - 문자열
*길이 제한* - 최소 길이 1, 최대 길이 256
**accountId**
Amazon Connect의 인스턴스를 실행하는 AWS 계정의 식별자입니다.
*유형* - 문자열
*길이 제한* - 제한: 12자리
*패턴* - `^\d{12}$`
**instanceId**
Amazon Connect 인스턴스의 식별자입니다. 인스턴스의 Amazon 리소스 이름(ARN)에서 [인스턴스 ID를 찾을](find-instance-arn.md) 수 있습니다.
*길이 제한* - 최소 길이 1, 최대 길이 100
**agentId**
고객 문의를 수행한 에이전트의 식별자입니다.
*유형* - 문자열
*길이 제한* - 최소 길이 1, 최대 길이 500
**evaluationDefinitionTitle**
평가 양식의 제목입니다.
*유형* - 문자열
*길이 제한* - 최소 길이 1, 최대 길이 128
**평가자**
평가를 마지막으로 업데이트한 사용자의 이름입니다.
*유형* - 문자열
**evaluationDefinitionId**
평가 양식의 고유 식별자입니다.
*유형* - 문자열
*길이 제한* - 최소 길이 1, 최대 길이 500
**evaluationDefinitionVersion**
평가 양식의 버전입니다.
*유형* - 정수
*유효 범위* - 최솟값 1
**evaluationStartTimestamp**
평가의 생성 타임스탬프입니다.
*유형* - Timestamp
*예* - 2025-11-14T17:57:08.649Z
**evaluationSubmitTimestamp**
평가의 제출 타임스탬프입니다.
*유형* - Timestamp
*예* - 2025-11-14T17:59:29.052Z
**점수**
평가 점수입니다.
**creator**
평가를 처음 생성한 엔터티(평가를 마지막으로 제출한 엔터티를 나타내는 '평가자'와는 다름)입니다. Connect Customer 관리자 웹 사이트에서 전화를 걸면 사용자 이름이 포함됩니다. 통화가 API를 통해 이루어진 경우 발신자의 ARN이 포함됩니다.
*유형* - 문자열
**autoEvaluated **
완전 자동화된 평가를 사용하여 평가를 제출했는지 여부를 나타냅니다.
*유형* - Boolean
**resubmitted **
평가가 다시 제출되었는지(편집되고 다시 제출되었는지) 여부를 나타냅니다.
*유형* - Boolean
**evaluationSource **
평가 응답 소스의 유형입니다.
*유형* - 문자열
유효한 값:
+ `ASSISTED_BY_AUTOMATION` - [질문 자동화](create-evaluation-forms.md#step-automate)를 사용하여 일부 질문에 답변했음을 나타냅니다.
+ `MANUAL` - 평가가 수동으로 수행되었음을 나타냅니다.
+ `AUTOMATED` - 평가가 완전 자동화된 평가를 사용하여 제출되었음을 나타냅니다(‘autoEvaluated’ 필드 참조).
**evaluationType**
평가 유형입니다.
*유형* - 문자열
유효한 값:
+ `CONTACT_EVALUATION` - 고객 응대 평가.
**calibrationSessionId**
이 평가와 연결된 보정 세션의 식별자입니다.
*유형* - 문자열
*길이 제한* - 최소 길이 1, 최대 길이 500
**evaluatedParticipantId**
평가 중인 참가자의 식별자입니다.
*유형* - 문자열
*길이 제한* - 최소 길이 1, 최대 길이 256
**evaluatedParticipantRole**
평가 중인 참가자의 역할입니다.
*유형* - 문자열
유효한 값:
+ `AGENT` - 에이전트 참가자.
+ `CUSTOMER` - 고객 참가자.
+ `SYSTEM` - 시스템 참가자.
**acknowledgerComment**
평가를 승인한 사용자가 남긴 설명입니다.
*유형* - 문자열
*길이 제한* - 최소 길이 0, 최대 길이 3,072
**evaluationAcknowledgedByUserId**
평가를 승인한 사람의 식별자입니다.
*유형* - 문자열
*길이 제한* - 최소 길이 1, 최대 길이 500
**evaluationAcknowledgedByUserName**
평가를 승인한 사람의 이름입니다.
*유형* - 문자열
**evaluationAcknowledgedTimestamp**
평가의 승인 타임스탬프입니다.
*유형* - Timestamp
*예* - 2025-12-24T15:45:56.662Z
**sections**
평가 섹션의 배열입니다.
**sectionRefId**
섹션의 식별자입니다. 식별자는 평가 양식 내에서 고유해야 합니다.
*유형* - 문자열
*길이 제한* - 최소 길이 1, 최대 길이 40
**parentSectionRefId**
상위 섹션의 식별자입니다.
*유형* - 문자열
*길이 제한* - 최소 길이 1, 최대 길이 40
**sectionTitle**
섹션의 제목입니다.
*유형* - 문자열
*길이 제한* - 제한: 최소 길이 0, 최대 길이 128
**notes**
섹션에 남아 있는 메모입니다.
*유형* - 문자열
*길이 제한* - 최소 길이 0, 최대 길이 3,072
메모에는 다음과 같은 제한이 있습니다.
+ 개별 메모의 제한은 3,072자입니다.
+ 평가의 결합된 노트는 *N* x 1,024자 제한이며, 여기서 *N*은 평가의 질문 수입니다.
**점수**
섹션의 점수입니다.
**percentage**
고객 응대 평가의 항목에 대한 점수 백분율입니다.
*유형*: Double
*유효한 범위* - 최솟값 0, 최댓값 100
**automaticFail**
항목을 자동 실패로 표시하는 플래그입니다. 항목 또는 하위 항목이 자동 실패 응답을 받으면 이 플래그는 true가 됩니다.
*유형* - Boolean
**notApplicable**
항목을 자동 실패로 표시하는 플래그입니다. 항목 또는 하위 항목이 자동 실패 응답을 받으면 이 플래그는 true가 됩니다.
*유형* - Boolean
**질문**
평가 질문의 배열입니다.
**questionRefId**
질문의 식별자입니다. 식별자는 평가 양식 내에서 고유해야 합니다.
*유형* - 문자열
*길이 제한* - 최소 길이 1, 최대 길이 40
**sectionRefId**
상위 섹션의 식별자입니다.
*유형* - 문자열
*길이 제한* - 최소 길이 1, 최대 길이 40
**questionType**
질문의 유형입니다.
*유형* - str. 평가의 결합된 메모에는 *N* x 1,024자의 제한이 있습니다. 여기서 *N*은 평가의 질문 수입니다.
*유효한 값* – `TEXT | SINGLESELECT | NUMERIC`
**questionText**
질문의 제목입니다.
*유형* - 문자열
*길이 제한* - 최소 길이 0, 최대 길이 350
**answer**
질문에 대한 답변입니다.
**값**
고객 응대 평가의 응답에 대한 문자열/숫자 값입니다.
*유형* - String/Double
*길이 제한* - 문자열: 최소 길이 0, 최대 길이 128
**notes**
섹션에 남아 있는 메모입니다.
*유형* - 문자열
*길이 제한* - 최소 길이 0. 최대 길이는 3,072입니다.
메모에는 두 개의 문자 제한이 있습니다. 개별 메모의 제한은 3,072자입니다. 평가의 결합된 노트는 N x 1,024자 제한이며, 여기서 N은 평가의 질문 수입니다.
**metadata**
**notApplicable **
질문을 해당사항 없음으로 표시하는 플래그입니다.
*유형* - Boolean
**assistedSuggestion**
[생성형 AI](generative-ai-performance-evaluations.md)에서 제안한 답변입니다.
*유형* - 문자열
**자동화**
**status**
자동화 답변의 상태입니다.
*유형* - 문자열
*유효한 값* – `UNAVAILABLE | SYSTEM_ANSWER | OVERRIDDEN_ANSWER`
**systemSuggestedValue**
고객 응대 평가에서 자동화 답변의 문자열 또는 숫자 값입니다.
*유형* - String 또는 Double
*길이 제한* - 문자열: 최소 길이 0, 최대 길이 128
**점수**
질문의 [score](#score)입니다.
+ automaticFail - 항목이 실패할 때 양식 및 전체 양식에 대해 항목을 중요로 표시하는 플래그가 실패합니다(0점으로 표시됨). 항목 또는 하위 항목이 자동 실패 응답을 받으면 이 플래그는 true가 되고 전체 양식도 실패합니다.
*유형* - Boolean
+ notApplicable - 항목을 점수 산정에 적용할 수 없음으로 표시하는 플래그로, 점수 계산에서 제외됩니다.
*유형* - Boolean
## 샘플 내보낸 평가
다음 예시는 일반적인 내보낸 평가를 보여 줍니다.
```
{
"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
}
}
]
}
```