翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# テストセットを管理する
テストセットウィンドウからテストセットをダウンロード、更新、削除できます。または、使用可能なテストセットのリストを使用して、テストセットファイルを編集したり、手動で注釈を付けたりすることもできます。エラーやその他の入力の問題が発生した場合は、もう一度アップロードして検証を再試行してください。
**テストセットレコードからテストセットファイルをダウンロードするには:**
1. テストセットのリストからテストセットの名前を選択します。
1. テストセットレコードウィンドウで、画面右側の **[テスト入力]** セクションにある **[ダウンロード]** ボタンを選択します。
1. ウィンドウ上部にテストセットに関する検証エラーの詳細が表示されている場合は、**[ダウンロード]** ボタンを選択します。ファイルは [ダウンロード] フォルダに保存されます。テストセット内の検証エラーは、テストセット CSV ファイルのエラーメッセージから修正できます。検証ステップで特定されたエラーを見つけ、行を修正または削除し、ファイルをアップロードして検証ステップを再試行します。
1. テストセットを正常にダウンロードすると、緑色のバナーメッセージが表示されます。
**テストセットのリストからテストセットをダウンロードするには:**
1. テストセットのリストで、ダウンロードするテストセット項目の横にあるラジオボタンを選択します。
1. 右上の [アクション] メニューから **[ダウンロード]** を選択します。
1. テストセットを正常にダウンロードすると、緑色のバナーメッセージが表示されます。ファイルは [ダウンロード] フォルダに保存されます。
# テストワークベンチでサポートされているテストセット列
以下に、テストワークベンチでサポートされているテストセット列の完全なリストと、Amazon Lex V2 でそれらを使用する方法の手順を示します。
| Column Name (列名) | テストセットタイプ | 値の型 | 複数列のサポート | 説明 |
| --- | --- | --- | --- | --- |
| [Line Number] (行番号) | テキストとオーディオ | Number | いいえ | これは Amazon Lex V2 によって無視されるユーザー列です。 V2 これは、テストセットの作成者がテストセット行をソートおよびフィルタリングするのを支援することを目的としています。「行 \$1」は代替列名として使用できます。 |
| 会話番号 | テキストとオーディオ | Number | いいえ | この列を使用すると、会話内に行をまとめて配置できます。「会話 \$1」は代替列名として使用できます。 |
| ソース | テキストとオーディオ | 列挙型 (「ユーザー」、「エージェント」) | いいえ | この列の値は、行がユーザー用かエージェント用かを示します。「会話参加者」は代替列名として使用できます。 |
| Input | テキスト | String | いいえ | この列は、テキストテストセットのトランスクリプトを追加するために使用されます。「ユーザー」行ではテキスト入力を使用する必要があります。エージェントプロンプトは、「エージェント」行で使用する必要があります。 |
| 想定される文字起こし | 音声 | String | いいえ | この列は、オーディオテストセットのトランスクリプトを追加するために使用されます。オーディオファイルの想定される文字起こしは、オーディオ入力がある「ユーザー」行で使用する必要があります。DTMF 入力は、DTMF 入力がある「ユーザー」行で使用できます。エージェントプロンプトは、「エージェント」行で使用する必要があります。 |
| S3 オーディオの場所 | 音声 | String | いいえ | この列はオーディオファイルの場所を追加するために使用され、オーディオテストセットにのみ適用可能です。S3 パスは、オーディオ入力がある「ユーザー」行で使用する必要があります。このフィールドは、DTMF 入力がある「ユーザー」行では空のままにする必要があります。「エージェント」行では、このフィールドは空のままにする必要があります。 |
| 入力コンテキストタグ | テキストとオーディオ | String | はい | この列は、テストセットの行の実行中に Lex への入力で使用される入力コンテキストの名前を指定するために使用されます。これは、「[Lex V2 ボットのインテントコンテキストの設定](https://docs.aws.amazon.com/lexv2/latest/dg/context-mgmt-active-context.html)」の入力コンテキストを指します。テストワークベンチはコンテキストの名前のみをサポートすることに注意してください。コンテキスト内のパラメータはサポートされません。「入力コンテキストタグ 1」、「入力コンテキストタグ 2」などの名前の複数の列を使用できます。 |
| リクエスト属性 | テキストとオーディオ | String | はい | この列は、テストセットの行の実行中に Lex への入力で使用されるリクエスト属性を指定するために使用されます。列の値は、「 = 」の形式で指定する必要があります。読みやすいように、「=」の周囲にスペースを追加できます。例: request-attribute-foo = これはダミーレスポンス request-attribute-foo = 'これは「ダミーレスポンス」' request-attribute-foo = "これは「ダミーレスポンス」です。「リクエスト属性 1」、「リクエスト属性 2」などの名前の複数の列を使用できます。 |
| セッション属性 | テキストとオーディオ | String | はい | この列は、テストセットの行の実行中に Lex への入力で使用されるセッション属性を指定するために使用されます。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/lexv2/latest/dg/file-input-test-sets.html) |
| ランタイムヒント | テキストとオーディオ | String | はい | この列は、テストセットの行の実行中に Lex への入力で使用されるインテント内のスロットのランタイムヒントを指定するために使用されます。以下に例を示します。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/lexv2/latest/dg/file-input-test-sets.html) |
| バージイン | 音声 | ブール値 | いいえ | この列は、テストセット内の行の Lex Runtime にオーディオファイルを送信するときにテストワークベンチがバージインするかどうかを指定するために使用されます。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/lexv2/latest/dg/file-input-test-sets.html) |
| 予想される出力インテント | テキストとオーディオ | String | いいえ | この列は、テストセット内の行の Lex からの出力で想定されるインテントの名前を指定するために使用されます。 |
| 予想される出力スロット | テキストとオーディオ | String | はい | この列は、テストセット内の行の実行中に Lex からの出力で想定されるスロット値を指定するために使用されます。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/lexv2/latest/dg/file-input-test-sets.html) |
| 想定される出力コンテキストタグ | テキストとオーディオ | String | はい | この列は、テストセットの行の Lex からの出力で想定される出力コンテキストの名前を指定するために使用されます。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/lexv2/latest/dg/file-input-test-sets.html) |
# Test Workbench でのテスト検証エラーの表示
検証エラーを報告するテストセットを修正できます。これらの検証エラーは、テストセットをテストする準備ができていない場合に生成されます。Test Workbench では、テストセット入力 CSV ファイルのどの必須列の値が期待どおりの形式になっていないかを確認できます。
**テスト検証エラーを表示するには:**
1. テストセットのリストから、確認する**検証エラー**のステータスを報告するテストセットの名前を選択します。テストセットの名前は、テストセットに関する詳細に移動するアクティブリンクです。
1. テストセットレコードは、画面上部に検証エラーの詳細を表示します。**[詳細を表示]** を選択すると、検証エラーに関するレポートが表示されます。
1. エラーレポートウィンドウで、[行番号] と [エラータイプ] を確認して、エラーが発生した場所を確認します。エラーのリストが長い場合は、エラーレポートを **[ダウンロード]** するよう選択できます。
1. テストセットの入力 CSV ファイルにリストされているエラーを元のテストファイルと比較して問題を修正し、テストセットをもう一度アップロードします。
次の表に、入力 CSV 検証エラーメッセージとシナリオを示します。
| シナリオ | エラーメッセージ | 注意事項 |
| --- | --- | --- |
| テストセットのファイルサイズ超過 | テストセットのファイルサイズが 200 MB を超えています。小さいファイルを提供して、リクエストを再試行してください。 | |
| テストセットが最大レコード数を超えています | 入力ファイルには、サポートされている最大数である 200,000 件を超えるレコードが含まれていました。 | |
| 空のテストセットをアップロードする | インポートされたテストセットが空です。空でないテストセットを指定して、リクエストを再試行してください。 | |
| 空の列ヘッダー名 | 列ヘッダー行: 列番号 5 に空の列名が見つかりました。 | |
| 認識されない列ヘッダー名 | 列ヘッダー行: 列番号 2 の列名 'ダミー' を認識できませんでした。 | |
| 重複数列ヘッダー名 | 列ヘッダー行: 同じまたは同等の 'S3 オーディオリンク' と 'S3 オーディオリンク' の列が複数見つかりました。これらの列の 1 つを削除するか、名前を変更します。 | |
| 複数値の列名が制限を超えました | 列ヘッダー行:'予想される出力スロット' の列数が、サポートされている最大数 6 を超えました。'予想される出力スロット' の列をいくつか削除して、やり直してください。 | 複数値列でサポートされる列の最大数は 6 です。 |
| テキストまたはオーディオ関連の列ヘッダーは存在しません。 | テキストまたは音声会話の列が見つかりませんでした。テキスト会話には \$1'テキスト入力'\$1 列を使用してください。音声会話には \$1'S3 オーディオリンク', '予想される文字起こし'\$1 列を使用してください。 | 音声必須列: \$1'S3 オーディオリンク', '予想される文字起こし'\$1テキスト必須列: \$1'テキスト入力'\$1 |
| テキスト関連と音声関連の両方のコラムヘッダーが存在します | テキスト会話と音声会話の両方の列が見つかりました。テキスト会話には \$1'テキスト入力'\$1 列を、音声会話には \$1'S3 オーディオリンク', '予想される文字起こし'\$1 列を使用できます。 | 音声必須列: \$1'S3 オーディオリンク', '予想される文字起こし'\$1テキスト必須列: \$1'テキスト入力'\$1 |
| 必須列がありません | 必須列 ["予想される出力インテント"] が見つかりませんでした。 | 必須列: \$1"行 \$1", "ソース", "予想される出力インテント"\$1 |
| ヘッダーのない列にデータが見つかりました | 行番号 6 の列番号 8 にデータが見つかりましたが、対応する列には列ヘッダーがありませんでした。 | |
| 必須列のデータが見つかりません | Row=12: 必須列の値が見つかりません: \$1"Source", "Expected Output Intent"\$1 | |
| 重複する会話 ID が見つかりました | 行番号 39 の前の会話に対して、会話番号 '19' が表示されました。2 つの会話に同じ会話番号が指定されていないことを確認してください。そのためには、会話番号のすべての行がグループ化されていることを確認してください。 | |
| 入力された会話 ID は無効です | '会話 \$1' 列に無効な値 'test\$1conversation' が見つかりました。ユーザー行の場合、この列の値は数値か N/A (該当なし) である必要があります。 | |
| 行番号に数値以外の値が入力されています | '行 \$1' 列に数値以外の値 'test\$1line' が見つかりました。値は数値である必要があります。 | |
| 会話 ID がエージェント行に見つかりません。 | '会話 \$1' 列に値が見つかりませんでした。エージェント行には値を入力する必要があります。 | |
| 数字以外の会話 ID がエージェント行に入力されています | [会話 \$1] 列に数値以外の値「test\$1conversation」が見つかりました。エージェント行の場合、その値は数値でなければなりません。 | |
| S3 の場所が無効 | 無効な値 'bucket/folder' が提供されました。有効な形式は S3:/// です。 | |
| S3 バケット名が無効 | 無効な S3 バケット名 'test\$1bucket' が入力されました。バケット名を確認してください。 | |
| S3 オーディオの場所はフォルダです | 指定されたオーディオの場所 ''S3://bucket/folder' が無効です。S3 フォルダを指しています。 | |
| 無効なインテント名 | インテント 'intent @name 'に無効な文字が含まれていました。インテント名を確認してください。 | 正規表現チェック: ^([0-9a-zA-Z][\$1-]?)\$1\$1 |
| 無効なスロット名 | スロット 'Slot @Name 'に無効な文字がありました。スロット名を確認してください。 | 正規表現: ^([0-9a-zA-Z][\$1-]?)\$1\$1It 先頭や末尾にドット (.) を付けてはいけません |
| 親スロットに指定されたスロット値 | サブスロット'Address.City' と親スロット 'Address' にスロット値が指定されました。値はサブスロットにのみ指定してください。 | CST の親スロットにはスロット値があってはなりません |
| コンテキスト名に無効な文字があります | コンテキスト名 'context @1 'に無効な文字が含まれていました。コンテキスト名を確認してください。 | 正規表現:^ ([A-zA-Z] \$1?) \$1\$1 |
| 無効なスロットのスペルスタイル | 無効な値 'test' が提供されました。すべて大文字であることを確認してください。有効な値は ["Default", "SpellByLetter", "SpellByWord"] です。 | サポートされている値 ["Default", "SpellByLetter", "SpellByWord"] |
| 参加者またはソースはエージェントまたはユーザーでなければなりません | 無効な値 'ボット' が提供されました。有効な値は ["エージェント", "ユーザー"] です。 | サポートされている列挙型: "エージェント", "ユーザー" |
| 行番号は 10 進数であってはなりません | 無効な値 '10.1' が提供されました。分数のない有効な数値でなければなりません。 | |
| 会話番号は 10 進数であってはなりません。 | 無効な値 '10.1' が提供されました。分数のない有効な数値でなければなりません。 | |
| 行番号は範囲内でなければなりません | 無効な値 '92233720368547758071' が提供されました。これは、1 以上で、9223372036854775807 以下である必要があります。 | |
| 割り込み列はブーリアン値のみを受け付けます | 無効な値 'test' が提供されました。'true' や 'false' などの有効なブール値でなければなりません。代わりに 'yes' と 'no' を使用することもできます。 | 使用できる値:"True"、 "true"、 "T"、 "Yes"、 "yEs"、 "Y"、 "1"、 "1.0"、"False"、 "false"、 "F"、 "No"、 "no"、 "N"、 "0"、 "0.0" |
| 想定されるスロット、セッション属性、リクエスト属性は (=) で区切る必要があります | 値 'slotName:slotValue' に '=' はありません。このような値は '=' の形式でキーと値のペアとして指定する必要があります。 | 例: slotName = slotType |
| 予想されるスロット、セッション属性、リクエスト属性にはキーと値のペアが必要です | '=slotValue' に '=' より前のキーがありません。このような値は '=' の形式でキーと値のペアとして指定する必要があります。 | 例: slotName = slotType |
| 無効な末尾の引用符 | 'Foo's item'“ に誤った引用が見つかりました。引用文字 `"` で始まりますが、同じ引用文字で終わるわけではありません。 | 例: `"Foo's item", KFC` |
| 真ん中の引用が無効です | `"Foo's" Burger, etc` に誤った引用が見つかりました。コンテンツ内に引用文字 `"` が含まれています。一重引用符を含む値は二重引用符で囲む必要があり、その逆も同様です。 | 正しい例: `"Foo's item", KFC` |
| 必須の引用文字 | `key = Foo's item` には一重引用符または二重引用符が含まれていますが、引用符で囲まれていません。一重引用符を含む値は二重引用符内に囲む必要があり、その逆も同様です。 | |
| 列内で重複キーが繰り返されています。 | キー `key1` が `セッション属性 3` と `セッション属性 1` の 2 つの列で繰り返されました。 | |
| ランタイムヒントの形式が無効です | ランタイムヒントに提供された `BookFlight.Car"` というキーが無効です。ランタイムヒントの場合、キーは形式 . である必要があります。 | キーの中央に '.' がある必要がある場合、そのキーからインテント名とスロット名を誘発することはできません。このような誤った形式の例としては、"BookFlight"、".BookFlight.Car"、"BookFlight.Car." があります。 |
| 無効なランタイムヒントキーのインテント名 | ランタイムヒントのインテント `intent @name `が無効です。インテント名を確認してください。 | 正規表現チェック: ^([0-9a-zA-Z][\$1-]?)\$1\$1 |
| 無効なランタイムヒントキーのスロット名 | ランタイムヒントの `Slot @Name `に無効なスロット名が見つかりました。スロット名を確認してください。 | 正規表現: ^([0-9a-zA-Z][\$1-]?)\$1\$1It 先頭や末尾にドット (.) を付けてはいけません |
# Test Workbench でのテストセットの削除
テストセットのリストからテストセットを簡単に削除できます。
**テストセットを削除するには:**
1. 左側のメニューから **[テストセット]** のリストに移動すると、テストセットのリストが表示されます。
1. テストセットのリストから、削除するテストセットを選択します。
1. 右上の **[アクション]** ドロップダウンメニューに移動し、**[削除]** を選択します。
1. テストセットが削除されたことを確認するメッセージが表示されます。
# テストセットの詳細を編集します。
テストセットのリストでテストセット名と詳細を編集できます。名前や詳細は後で追加または更新できます。ただし、ボットまたは文字起こしデータを使用してテストを実行する前に、テストセットを更新する必要があります。
**テストセットの詳細を編集するには:**
1. 左側のメニューからテストセットのリストに移動すると、テストセットのリストが表示されます。
1. テストセットのリストから、編集するテストセットのチェック ボックスを選択します。
1. 右上の **[アクション]** ドロップダウンメニューに移動し、**[詳細の編集]** を選択します。
1. テストセットが正常に編集されたことを確認するメッセージが表示されます。
# テストセットを更新する
テストセットから項目を更新、修正、変更、または削除して、ベースライン結果を最適化したり、テストセットで発生した可能性のあるその他のエラーを修正したりすることができます。
修正したテストセットをアップロードする前に、テストセットをダウンロードして検証エラーを修正できます。「[テスト検証エラーを表示する](https://docs.aws.amazon.com/lexv2/latest/dg/view-errors-test-sets.html)」を参照してください。
**テストセットを更新するには:**
1. テストセットレコードから、右上の **[テストセットの更新]** ボタンを選択します。
1. Amazon S3 アカウントからアップロードするファイルを選択するか、コンピュータから CSV テストファイルをアップロードします。注: テストセットを更新すると、既存のデータが上書きされます。
1. **[更新]** ボタンを選択します。
1. テストセットが正常に更新されたことを確認するメッセージが表示されます。注: テストセットの複雑さとサイズによっては、この操作に数分かかる場合があります。
1. テストセットが正常に更新されたことを確認するメッセージが表示され、**[ステータス]** に **[テスト準備完了]** と表示されます。