Output formulir evaluasi agen di Amazon Connect - Amazon Connect
Verifikasi bucket S3 AndaContoh lokasi keluaranMasalah yang diketahuiSkor contohBentuk evaluasi definisi metadataContoh evaluasi yang diekspor

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.

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_evaluations_S3_bucket/Evaluasi/ - YYYY/MM/DD/hh:mm:ss.sTZD .json 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

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_bucket/evaluasi/kontak_ /evaluasi_ /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 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 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

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

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.

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

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