Amazon Connect でのエージェント評価フォームの出力 - Amazon Connect
S3 バケットを確認する出力場所の例既知の問題スコアとメタデータの例エクスポートされた評価の例

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon Connect でのエージェント評価フォームの出力

このセクションでは、評価のエクスポート出力パスと、評価フォームのスコアとメタデータの例を説明します。

S3 バケットを確認する

Amazon Connect コンソールで問い合わせ評価を有効にすると、評価を保存する S3 バケットを作成または選択するように求められます。バケットの名前を確認するには、インスタンスエイリアスに移動し、データストレージ 、問い合わせ評価 、編集 を選択します。

出力場所の例

評価フォームの出力ファイルパスは次のとおりです。

  • contact_evaluations_S3_bucket/評価/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

既知の問題: 同じ評価に 2 つの出力ファイルが存在する

Contact Lens は、同じ評価フォームに対して 2 つの出力ファイルを生成します。

  • 1 つのファイルが新しいデフォルト S3 パスに書き込まれます。 AWS コンソールでパスを設定できます。

  • 廃止予定の別のファイルが、以前の別の S3 パスに書き込まれます。このファイルは無視できます。

    前述の S3 パスは次のようになります。

    • s3_bucket/評価/問い合わせ_contactId/evaluation_evaluationId/YYYY-MM-DDThh:mm:ss.s TZD.json

スコアとメタデータの例

次の例は、一般的なスコアとそのメタデータを示しています。例の下のテキストは、各フィールドについて説明しています。

 {
"schemaVersion": "3.1",
"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": "2022-11-14T17:57:08.649Z",
    "evaluationSubmitTimestamp": "2022-11-14T17:59:29.052Z",
    "score": { "percentage": 100 },
    "creator": "jane.doe@acme.com",
    "autoEvaluated": false, 
    "resubmitted": false, 
    "evaluationSource": "ASSISTED_BY_AUTOMATION"          
  },
"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": "o6999aa94", "selected": false },
          { "valueText": "No", "valueRefId": "o284e4d9e", "selected": true },
          { "valueText": "Maybe", "valueRefId": "o1b2f0a14", "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": { "notApplicable": true }
    }
  ]
}

次のリストでは、評価フォームのフィールドについて説明します。

evaluationId

問い合わせ評価の一意の識別子

タイプ – 文字列

長さの制約 – 最小長は 1 です。最大長は 500 です

metadata
contactId

Amazon Connect のこのインスタンスの連絡先の識別子。

タイプ – 文字列

長さの制約 — 最小長は 1、最大長は 256

accountId

Amazon Connect のインスタンスを実行している AWS アカウントの識別子。

タイプ – 文字列

長さの制約 – 制約: 12 桁

パターン – ^\d{12}$

instanceId

Amazon Connect インスタンスの識別子。インスタンス ID は、インスタンスの Amazon リソースネーム (ARN) にあります。

長さの制約 — 最小長は 1、最大長は 100

agentId

問い合わせを実行したエージェントの識別子。

タイプ – 文字列

長さの制約 — 最小長は 1、最大長は 500

evaluationDefinitionTitle

評価フォームのタイトル。

タイプ – 文字列

長さの制約 — 最小長は 1、最大長は 128

評価者

評価を最後に更新したユーザーの名前。

タイプ – 文字列

evaluationDefinitionId

評価フォームの一意の識別子。

タイプ –

長さの制約 – 文字列

パターン – 最小長は 1、最大長は 500

evaluationDefinitionVersion

評価フォームのバージョン。

タイプ – 整数

有効範囲 — 最小値 1

evaluationStartTimestamp

評価の作成タイムスタンプ。

タイプ – タイムスタンプ

スコア

評価のスコア。

作成者

評価を初めて作成したエンティティ (最後に評価を送信したエンティティを表す「評価者」とは対照的）。

タイプ – 文字列

autoEvaluated

評価が完全自動評価を使用して送信されたかどうかを示します

タイプ – ブール値

再送信済み

評価が再送信されたかどうかを示します (編集および再送信）。

タイプ – ブール値

evaluationSource

評価回答ソースのタイプ。

タイプ – 文字列

有効な値:

  • ASSISTED_BY_AUTOMATION - は、質問の自動化が一部の質問に回答するために使用されたことを示します。

  • MANUAL - 評価が手動で実行されたことを示します。

  • AUTOMATED - は、評価が完全自動評価を使用して送信されたことを示します (autoEvaluated「」フィールドを参照）。

セクション

評価のセクションの配列。

sectionRefId

セクションの識別子。識別子は、評価フォーム内で一意である必要があります。

タイプ – 文字列

長さの制約 — 最小長は 1、最大長は 40

parentSectionRefID

親セクションの識別子。

タイプ – 文字列

長さの制約 — 最小長は 1、最大長は 40

sectionTitle

セクションのタイトル。

タイプ – 文字列

長さ制約 – 制約: 最小長 0、最大長 128

注意事項

セクションに残されたメモ。

タイプ – 文字列

長さの制約 — 最小長は 0、最大長は 3072

注記

メモには以下の制限があります。

  • 個々のメモには 3072 文字の制限があります。

  • 評価の複合ノートには N x 1024 文字の制限があります。N は評価の質問数です。

スコア

セクションのスコア。

割合(%)

問い合わせ評価の項目のスコアパーセンテージ。

タイプ – ダブル

有効範囲 – 最小値 0、最大値 100

automaticFail

項目を自動失敗としてマークするフラグ。項目または子項目が自動フェイルレスポンスを取得した場合、このフラグは true になります。

タイプ – ブール値

notApplicable

項目を自動失敗としてマークするフラグ。項目または子項目が自動フェイルレスポンスを取得した場合、このフラグは true になります。

タイプ – ブール値

質問

評価の質問の配列。

questionRefId

質問の識別子。識別子は、評価フォーム内で一意である必要があります。

タイプ – 文字列

長さの制約 — 最小長は 1、最大長は 40 です。

sectionRefId

親セクションの識別子。

タイプ – 文字列

長さの制約 — 最小長は 1、最大長は 40

questionType

質問のタイプ。

タイプ – 評価の StrThe 複合ノートには N x 1024 文字の制限があります。N は評価の質問数です。

有効な値 – TEXT | SINGLESELECT | NUMERIC

questionText

質問のタイトル。

タイプ – 文字列

長さの制約 — 最小長は 0、最大長は 350

回答

質問の回答。

value

問い合わせ評価の回答の文字列/数値。

タイプ – 文字列/ダブル

長さの制約 – 文字列: 最小長 0、最大長 128

注意事項

セクションに残されたメモ。

タイプ – 文字列

長さの制約 – 最小長は 0 です。最大長 3072

注記

メモには 2 つの文字制限があります。個々のメモには 3072 文字の制限があります。評価の複合ノートには N x 1024 文字の制限があります。N は評価の質問数です。

metadata

notApplicable

質問が該当しないことを示すフラグ。

タイプ – ブール値

assistedSuggestion

生成 AI によって提案された回答。

タイプ – 文字列

Automation
status

オートメーション回答のステータス。

タイプ – 文字列

有効な値 – UNAVAILABLE | SYSTEM_ANSWER | OVERRIDDEN_ANSWER

systemSuggestedValue

問い合わせ評価のオートメーション回答の文字列または数値。

タイプ – 文字列または二重

長さの制約 – 文字列: 最小長 0、最大長 128

スコア

質問scoreの 。

  • automaticFail - 項目が失敗すると、フォームと完全なフォームに項目を重要としてマークするフラグは失敗します (スコアがゼロでマークされます）。項目または子項目が自動失敗応答を取得すると、このフラグは true になり、完全なフォームも失敗します。

    タイプ – ブール値

  • notApplicable - 項目をスコアリングに適用できないとしてマークするフラグは、スコアリング計算から除外されます。

    タイプ – ブール値

エクスポートされた評価の例

次の例は、エクスポートされた一般的な評価を示しています。

{
  "schemaVersion": "3.1",
  "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": "2022-11-14T17:57:08.649Z",
    "evaluationSubmitTimestamp": "2022-11-14T17:59:29.052Z",
    "score": { "percentage": 100 }
  },
  "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",
        "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": { "notApplicable": true }
    }
  ]
}