Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Output formulir evaluasi agen di Amazon Connect
Bagian ini menunjukkan jalur keluaran ekspor untuk evaluasi, memberikan contoh skor formulir evaluasi, dan menjelaskan metadata formulir evaluasi.
**Topics**
+ [Verifikasi bucket S3 Anda](#verify-evaluation-s3bucket)
+ [Contoh lokasi keluaran](#example-evaluationform-output-locations)
+ [Masalah yang diketahui](#release-note-evaluation-output)
+ [Skor contoh](#example-evaluation-output-file)
+ [Bentuk evaluasi definisi metadata](#evaluation-form-metadata)
+ [Contoh evaluasi yang diekspor](#exported-evaluation)
## Verifikasi bucket S3 Anda
Saat mengaktifkan **evaluasi Kontak** di Amazon Connect konsol, Anda akan diminta untuk membuat atau memilih bucket S3 untuk menyimpan evaluasi. **Untuk memverifikasi nama bucket, buka alias instance Anda, pilih **Penyimpanan data**, **evaluasi kontak**, lalu Edit.**
## Contoh lokasi keluaran
Berikut ini adalah jalur file output untuk formulir evaluasi:
+ *contact\$1evaluations\$1S3\$1bucket*/Evaluasi/ - *YYYY/MM/DD/hh:mm:ss.sTZD* .json *evaluation\$1id*
Contoh:
`amazon-connect-s3/Evaluations/2022/04/14/05:04:20.869Z-11111111-2222-3333-4444-555555555555.json`
## Masalah yang diketahui: Dua file keluaran untuk evaluasi yang sama
Contact Lensmenghasilkan dua file output untuk formulir evaluasi yang sama.
+ Satu file ditulis ke jalur S3 default baru. Anda dapat mengkonfigurasi jalur di AWS konsol.
+ File lain, yang akan usang, ditulis ke jalur S3 sebelumnya yang berbeda. Anda dapat mengabaikan file ini.
Jalur S3 sebelumnya terlihat seperti berikut:
+ *s3\$1bucket*/evaluasi/kontak\$1 /evaluasi\$1 /yyyy-mm-:mm: *contactId* ss.stzd.json *evaluationId* DDThh
## Skor contoh
Contoh berikut menunjukkan skor tipikal.
```
{
"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
}
}
]
}
```
## Bentuk evaluasi definisi metadata
Daftar berikut menjelaskan bidang dalam formulir evaluasi.
**EvaluationID**
Pengidentifikasi unik untuk evaluasi kontak
*Jenis* - String
*Kendala panjang* - Panjang minimum 1. Panjang maksimum 500
**Metadata**
**contactId**
Pengenal kontak dalam contoh Amazon Connect ini.
*Jenis* - String
*Kendala panjang* - Panjang minimum 1, panjang maksimum 256
**accountId**
Pengidentifikasi AWS akun yang menjalankan instance Amazon Connect.
*Jenis* - String
*Kendala panjang - Kendala*: 12 digit
*Pola* — `^\d{12}$`
**instanceId**
Pengenal instans Amazon Connect. Anda dapat [menemukan ID instans](find-instance-arn.md) di Amazon Resource Name (ARN) instance.
*Kendala panjang* - Panjang minimum 1, panjang maksimum 100
**agentId**
Pengidentifikasi agen yang melakukan kontak.
*Jenis* - String
*Kendala panjang* - Panjang minimum 1, panjang maksimum 500
**evaluationDefinitionTitle**
Judul formulir evaluasi.
*Jenis* - String
*Kendala panjang* - Panjang minimum 1, panjang maksimum 128
**evaluator**
Nama pengguna yang terakhir memperbarui evaluasi.
*Jenis* - String
**evaluationDefinitionId**
Pengidentifikasi unik untuk formulir evaluasi.
*Jenis* - String
*Panjang & nbsp*; Panjang minimum 1, panjang maksimum 500
**evaluationDefinitionVersion**
Versi formulir evaluasi.
*Jenis* - Integer
*Rentang yang valid* - Nilai minimum 1
**evaluationStartTimestamp**
Stempel waktu pembuatan evaluasi.
*Jenis* - Timestamp
*Contoh* — 2025-11-14T 17:57:08.649 Z
**evaluationSubmitTimestamp**
Stempel waktu pengajuan evaluasi.
*Jenis* - Timestamp
*Contoh* — 2025-11-14T 17:59:29.052 Z
**skor**
Skor evaluasi.
**pencipta**
Entitas yang membuat evaluasi pertama kali (sebagai lawan dari “evaluator” yang mewakili entitas yang terakhir mengajukan evaluasi). Ketika panggilan dilakukan dari situs web Amazon Connect admin itu berisi nama pengguna. Wen panggilan berasal dari API yang berisi ARN penelepon.
*Jenis* - String
**Dievaluasi secara otomatis **
Menunjukkan apakah evaluasi diajukan menggunakan evaluasi yang sepenuhnya otomatis.
*Jenis* - Boolean
**dikirimkan kembali **
Menunjukkan apakah evaluasi telah dikirimkan kembali (diedit dan diserahkan lagi).
*Jenis* - Boolean
**EvaluasiSumber **
Jenis sumber jawaban evaluasi.
*Jenis* - String
Nilai valid:
+ `ASSISTED_BY_AUTOMATION`- menunjukkan bahwa [otomatisasi pertanyaan](create-evaluation-forms.md#step-automate) digunakan untuk menjawab beberapa pertanyaan.
+ `MANUAL`- menunjukkan bahwa evaluasi dilakukan secara manual.
+ `AUTOMATED`- menunjukkan bahwa evaluasi diajukan menggunakan evaluasi yang sepenuhnya otomatis (lihat bidang “AutoEvaluated”).
**EvaluationType**
Jenis evaluasi.
*Jenis* - String
Nilai valid:
+ `CONTACT_EVALUATION`- evaluasi kontak.
**calibrationSessionId**
Pengidentifikasi sesi kalibrasi yang terkait dengan evaluasi ini.
*Jenis* - String
*Kendala panjang* - Panjang minimum 1, panjang maksimum 500
**evaluatedParticipantId**
Pengidentifikasi peserta yang sedang dievaluasi.
*Jenis* - String
*Kendala panjang* - Panjang minimum 1, panjang maksimum 256
**evaluatedParticipantRole**
Peran peserta yang sedang dievaluasi.
*Jenis* - String
Nilai valid:
+ `AGENT`- peserta agen.
+ `CUSTOMER`- peserta pelanggan.
+ `SYSTEM`- peserta sistem.
**ActivedgerKomentar**
Komentar ditinggalkan oleh pengguna yang mengakui evaluasi.
*Jenis* - String
*Kendala panjang* - Panjang minimum 0, panjang maksimum 3072
**evaluationAcknowledgedByUserId**
Pengidentifikasi orang yang mengakui evaluasi.
*Jenis* - String
*Kendala panjang* - Panjang minimum 1, panjang maksimum 500
**evaluationAcknowledgedByUserName**
Nama orang yang mengakui evaluasi.
*Jenis* - String
**evaluationAcknowledgedTimestamp**
Stempel waktu pengakuan evaluasi.
*Jenis* - Timestamp
*Contoh* — 2025-12-24T 15:45:56.662 Z
**bagian**
Array bagian evaluasi.
**sectionRefId**
Pengidentifikasi bagian. Pengidentifikasi harus unik dalam formulir evaluasi.
*Jenis* - String
*Kendala panjang* - Panjang minimum 1, panjang maksimum 40
**parentSectionRefId**
Pengidentifikasi bagian induk.
*Jenis* - String
*Kendala panjang* - Panjang minimum 1, panjang maksimum 40
**BagianJudul**
Judul bagian.
*Jenis* - String
*Kendala panjang - Kendala*: Panjang minimum 0, panjang maksimum 128
**catatan**
Catatan tersisa untuk bagian tersebut.
*Jenis* - String
*Kendala panjang* - Panjang minimum 0, panjang maksimum 3072
Catatan memiliki batasan berikut:
+ Catatan individu memiliki batas 3072 karakter.
+ Catatan gabungan dalam evaluasi memiliki batas *N* x 1024 karakter, di mana *N* adalah jumlah pertanyaan dalam evaluasi.
**skor**
Skor untuk bagian tersebut.
**persentase**
Persentase skor untuk item dalam evaluasi kontak.
*Tipe* - Ganda
*Rentang valid* - Nilai minimum 0, nilai maksimum 100
**AutomaticFail**
Bendera yang menandai item sebagai otomatis gagal. Jika item atau item anak mendapat jawaban gagal otomatis, tanda ini akan benar.
*Jenis* - Boolean
**TidakBerlaku**
Bendera yang menandai item sebagai otomatis gagal. Jika item atau item anak mendapat jawaban gagal otomatis, tanda ini akan benar.
*Jenis* - Boolean
**pertanyaan**
Array pertanyaan evaluasi.
**questionRefId**
Pengidentifikasi pertanyaan. Pengidentifikasi harus unik dalam formulir evaluasi.
*Jenis* - String
*Kendala panjang* - Panjang minimum 1, panjang maksimum 40.
**sectionRefId**
Pengidentifikasi bagian induk.
*Jenis* - String
*Kendala panjang* - Panjang minimum 1, panjang maksimum 40
**QuestionType**
Jenis pertanyaannya.
*Jenis* — catatan StrThe gabungan dalam evaluasi memiliki batas *N* x 1024 karakter, di mana *N* adalah jumlah pertanyaan dalam evaluasi.
*Nilai yang valid* - `TEXT | SINGLESELECT | NUMERIC`
**QuestionTeks**
Judul pertanyaan.
*Jenis* - String
*Kendala panjang* - Panjang minimum 0, panjang maksimum 350
**membalas**
Jawaban untuk pertanyaan itu.
**nilai**
string/numeric Nilai jawaban dalam evaluasi kontak.
*Jenis* - Senar/Ganda
*Kendala panjang* - String: Panjang minimum 0, panjang maksimum 128
**catatan**
Catatan tersisa untuk bagian tersebut.
*Jenis* - String
*Kendala panjang* - Panjang minimum 0. Panjang maksimal 3072
Catatan memiliki dua batas karakter. Catatan individu memiliki batas 3072 karakter. Catatan gabungan dalam evaluasi memiliki batas N x 1024 karakter, di mana N adalah jumlah pertanyaan dalam evaluasi.
**Metadata**
**TidakBerlaku**
Bendera yang menandai pertanyaan sebagai tidak berlaku.
*Jenis* - Boolean
**Saran yang dibantu**
Jawaban yang disarankan oleh [AI generatif](generative-ai-performance-evaluations.md).
*Jenis* - String
**otomatisasi**
**status**
Status jawaban otomatisasi.
*Jenis* - String
*Nilai yang valid* - `UNAVAILABLE | SYSTEM_ANSWER | OVERRIDDEN_ANSWER`
**systemSuggestedValue**
String atau nilai numerik untuk jawaban otomatisasi dalam evaluasi kontak.
*Jenis* - String atau Ganda
*Kendala panjang* - String: Panjang minimum 0, panjang maksimum 128
**skor**
[score](#score)Untuk pertanyaan.
+ AutomaticFail - Bendera yang menandai item sebagai penting untuk formulir dan formulir lengkap akan gagal (ditandai dengan skor nol) ketika item gagal. Jika item atau item anak mendapat jawaban gagal otomatis, tanda ini akan benar dan formulir lengkap juga akan gagal.
*Jenis* - Boolean
+ NotApplicable - Bendera yang menandai item sebagai tidak berlaku untuk penilaian, itu akan dikecualikan dari perhitungan penilaian.
*Jenis* - Boolean
## Contoh evaluasi yang diekspor
Contoh berikut menunjukkan evaluasi yang diekspor khas.
```
{
"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
}
}
]
}
```