Verifikasi bucket S3 Anda Contoh lokasi keluaran Masalah yang diketahui Contoh skor Definisi metadata formulir evaluasi Evaluasi sampel yang diekspor

Output formulir evaluasi agen di Connect Customer

Bagian ini menunjukkan jalur keluaran ekspor untuk evaluasi, memberikan contoh skor formulir evaluasi, dan menjelaskan metadata formulir evaluasi.

Verifikasi bucket S3 Anda

Saat Anda mengaktifkan evaluasi Kontak di Connect Customer konsol, Anda akan diminta untuk membuat atau memilih bucket S3 untuk menyimpan evaluasi. Untuk memverifikasi nama bucket, buka alias instans Anda, pilih Penyimpanan data, Evaluasi kontak, lalu Edit.

Contoh lokasi keluaran

Berikut ini adalah jalur file output untuk formulir evaluasi:

contact_evaluations_S3_bucket/Evaluasi/ - .json YYYY/MM/DD/hh:mm:ss.sTZD evaluation_id

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

Analisis percakapan menghasilkan dua file output untuk formulir evaluasi yang sama.

Satu file ditulis ke jalur S3 default baru. Anda dapat mengonfigurasi jalur di AWS konsol.
File lain, yang akan tidak digunakan lagi, ditulis ke jalur S3 sebelumnya yang berbeda. Anda dapat mengabaikan file ini.

Jalur S3 sebelumnya terlihat seperti berikut:
- s3_bucket/Evaluations/contact_ contactId /evaluasi evaluationId _/YYYY-MM-DDThh:mm:ss.sTZD.json

Contoh skor

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

Definisi metadata formulir evaluasi

Daftar berikut menjelaskan bidang dalam formulir evaluasi.

ID Evaluasi

Pengidentifikasi unik untuk evaluasi kontak

Jenis - String

Batasan panjang — Panjang minimum 1. Panjang maksimum 500

Metadata

ID Kontak

Pengidentifikasi kontak dalam contoh Amazon Connect ini.

Jenis - String

Batasan panjang — Panjang minimum 1, panjang maksimum 256

accountId

Pengidentifikasi AWS akun yang menjalankan instance Connect Customer.

Jenis - String

Batasan panjang — Kendala: 12 digit

Pola - ^\d{12}$

instanceId

Pengidentifikasi instans Amazon Connect. Anda dapat menemukan ID instance di Amazon Resource Name (ARN) instans.

Batasan panjang - Panjang minimum 1, panjang maksimum 100

agentId

Pengidentifikasi agen yang melakukan kontak.

Jenis - String

Batasan panjang - Panjang minimum 1, panjang maksimum 500

evaluasi DefinitionTitle

Judul formulir evaluasi.

Jenis - String

Batasan panjang - Panjang minimum 1, panjang maksimum 128

evaluator

Nama pengguna yang terakhir memperbarui evaluasi.

Jenis - String

evaluasi DefinitionId

Pengidentifikasi unik untuk formulir evaluasi.

Jenis - String

Kontraksi panjang - Panjang minimum 1, panjang maksimum 500

evaluasi DefinitionVersion

Versi formulir evaluasi.

Jenis - Integer

Rentang yang valid - Nilai minimum 1

evaluasi StartTimestamp

Stempel waktu pembuatan evaluasi.

Jenis - Stempel Waktu

Contoh — 2025-11-14 T17:57:08.649Z

evaluasi SubmitTimestamp

Stempel waktu pengiriman evaluasi.

Jenis - Stempel Waktu

Contoh — 2025-11-14 T17:59:29.052Z

skor

Skor evaluasi.

pencipta

Entitas yang membuat evaluasi pertama kali (berlawanan dengan “evaluator” yang mewakili entitas yang terakhir mengajukan evaluasi). Ketika panggilan dilakukan dari situs web Connect Customer admin itu berisi nama pengguna. Jika panggilan berasal dari API itu berisi ARN pemanggil.

Jenis - String

Dievaluasi Otomatis

Menunjukkan apakah evaluasi diajukan menggunakan evaluasi sepenuhnya otomatis.

Jenis - Boolean

dikirimkan kembali

Menunjukkan apakah evaluasi telah dikirimkan kembali (diedit dan diserahkan lagi).

Jenis - Boolean

Sumber Evaluasi

Jenis sumber jawaban evaluasi.

Jenis - String

Nilai valid:

ASSISTED_BY_AUTOMATION- menunjukkan bahwa otomatisasi pertanyaan digunakan untuk menjawab beberapa pertanyaan.
MANUAL- menunjukkan bahwa evaluasi dilakukan secara manual.
AUTOMATED- menunjukkan bahwa evaluasi diajukan menggunakan evaluasi otomatis penuh (lihat bidang “AutoEvaluasi”).

Jenis Evaluasi

Jenis evaluasi.

Jenis - String

Nilai valid:

CONTACT_EVALUATION- evaluasi kontak.

kalibrasi SessionId

Pengidentifikasi sesi kalibrasi yang terkait dengan evaluasi ini.

Jenis - String

Batasan panjang - Panjang minimum 1, panjang maksimum 500

dievaluasi ParticipantId

Pengidentifikasi peserta yang dievaluasi.

Jenis - String

Batasan panjang — Panjang minimum 1, panjang maksimum 256

dievaluasi ParticipantRole

Peran peserta yang dievaluasi.

Jenis - String

Nilai valid:

AGENT- peserta agen.
CUSTOMER- peserta pelanggan.
SYSTEM- peserta sistem.

MengakuiKomentar

Komentar ditinggalkan oleh pengguna yang mengakui evaluasi.

Jenis - String

Batasan panjang - Panjang minimum 0, panjang maksimum 3072

evaluasi AcknowledgedByUserId

Pengidentifikasi orang yang mengakui evaluasi.

Jenis - String

Batasan panjang - Panjang minimum 1, panjang maksimum 500

evaluasi AcknowledgedByUserName

Nama orang yang mengakui evaluasi.

Jenis - String

evaluasi AcknowledgedTimestamp

Stempel waktu pengakuan evaluasi.

Jenis - Stempel Waktu

Contoh — 2025-12-24 T15:45:56.662Z

bagian

Array bagian evaluasi.

bagian RefId

Pengidentifikasi bagian. Pengidentifikasi harus unik dalam formulir evaluasi.

Jenis - String

Batasan panjang - Panjang minimum 1, panjang maksimum 40

orang tua SectionRefId

Pengidentifikasi bagian induk.

Jenis - String

Batasan panjang - Panjang minimum 1, panjang maksimum 40

Bagian Judul

Judul bagian.

Jenis - String

Batasan panjang — Kendala: Panjang minimum 0, panjang maksimum 128

catatan

Catatan tersisa untuk bagian tersebut.

Jenis - String

Batasan panjang - Panjang minimum 0, panjang maksimum 3072

catatan

Catatan memiliki batasan sebagai 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.

Ti pe — Double

Rentang yang valid - Nilai minimum 0, nilai maksimum 100

OtomatisFail

Bendera yang menandai item sebagai otomatis gagal. Jika item atau item anak mendapatkan jawaban gagal otomatis, tanda ini akan benar.

Jenis - Boolean

Tidak Berlaku

Bendera yang menandai item sebagai otomatis gagal. Jika item atau item anak mendapatkan jawaban gagal otomatis, tanda ini akan benar.

Jenis - Boolean

pertanyaan

Array pertanyaan evaluasi.

pertanyaan RefId

Pengidentifikasi pertanyaan. Pengidentifikasi harus unik dalam formulir evaluasi.

Jenis - String

Batasan panjang — Panjang minimum 1, panjang maksimum 40.

bagian RefId

Pengidentifikasi bagian induk.

Jenis - String

Batasan panjang - Panjang minimum 1, panjang maksimum 40

Jenis pertanyaan

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

Teks pertanyaan

Judul pertanyaan.

Jenis - String

Batasan panjang — Panjang minimum 0, panjang maksimum 350

membalas

Jawaban untuk pertanyaan itu.

nilai

string/numeric Nilai untuk jawaban dalam evaluasi kontak.

Tipe — String/Double

Batasan panjang — String: Panjang minimum 0, panjang maksimum 128

catatan

Catatan tersisa untuk bagian tersebut.

Jenis - String

Batasan panjang — Panjang minimum 0. Panjang maksimal 3072

catatan

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

Tidak Berlaku

Bendera yang menandai pertanyaan sebagai tidak berlaku.

Jenis - Boolean

BantuanSaran

Jawaban yang disarankan oleh AI Mengevaluasi kinerja agen di Connect Customer menggunakan AI generatif generatif.

Jenis - String

otomatisasi

status

Status jawaban otomatisasi.

Jenis - String

Nilai yang valid — UNAVAILABLE | SYSTEM_ANSWER | OVERRIDDEN_ANSWER

sistem SuggestedValue

String atau nilai numerik untuk jawaban otomatisasi dalam evaluasi kontak.

Jenis - String atau Ganda

Batasan panjang — String: Panjang minimum 0, panjang maksimum 128

skor

Untuk score pertanyaan itu.

AutomaticFail - Bendera yang menandai item sebagai kritis untuk formulir dan formulir lengkap akan gagal (ditandai dengan skor nol) ketika item gagal. Jika item atau item anak mendapatkan 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

Evaluasi sampel yang diekspor

Contoh berikut menunjukkan evaluasi tipikal yang diekspor.


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

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Metrik evaluasi

Pantau kejadian kegagalan evaluasi