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

# サンプル発話
<a name="sample-utterances"></a>

ユーザーがインテントを開始するために使用するであろうフレーズのバリエーションであるサンプル発話を作成します。たとえば、**BookFlight** インテントには次のような発話を含めることができます。

1. 飛行機を予約したい

1. 飛行機の予約を取って

1. 飛行機のチケットをお願い\$1

1. \$1*DepartureCity*\$1 から \$1*DestinationCity*\$1 の飛行機

10 個以上のサンプル発話を提供する必要があります。ユーザーが発するであろう幅広い文の構造や単語を表すサンプルを提供してください。上記の例 3 と 4 のように、不完全な文も考慮してください。例 4 の \$1*DepartureCity*\$1 のように、スロット名を中括弧で囲むことで、サンプル発話でインテント用に定義したスロットを使用することもできます。サンプル発話にスロット名を含めると、Amazon Lex V2 はユーザーが発話で指定した値をインテントのスロットに入力します。

Amazon Lex V2 は、ユーザーがインテントを開始したいことを効果的に認識するために、さまざまなサンプル発話から Amazon Lex V2 が一般化します。

サンプル発話は、インテントエディター、ビジュアル会話ビルダー、または [CreateIntent](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateIntent.html) または [UpdateIntent API](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UpdateIntent.html) オペレーションを使用して追加できます。Amazon Bedrock の生成 AI 機能を活用して、サンプル発話を自動的に生成することもできます。詳細については、「[発話生成を使用したインテント認識用のサンプル発話の生成](utterance-generation.md)」を参照してください。

**インテントエディターまたはビジュアル会話ビルダーを使用します。**

1. インテントエディターで、**[サンプル発話]** セクションに移動します。ビジュアル会話ビルダーの**開始**ブロックにある **[サンプル発話]** セクションを探してください。

1. 透明なテキスト **I want to book a flight** が表示されたボックスに、サンプル発話を入力します。**[発話を追加]** を選択して発話を追加します。

1. 追加したサンプル発話を **[プレビュー]** または **[プレーンテキスト]** モードで表示します。**プレーンテキスト**では、各行が個別の発話です。**プレビューモード**では、発話にカーソルを合わせると以下のオプションが表示されます。
   + テキストボックスを選択して発話を編集します。
   + テキストボックスの右側にある [x] ボタンを選択して、発話を削除します。
   + テキストボックスの左側にあるボタンをドラッグして、サンプル発話の順序を変更します。

1. 上部の検索バーを使用してサンプル発話を検索し、その横にあるドロップダウンメニューを使用して発話を追加した順序またはアルファベット順に並べ替えます。

**API オペレーションを使用する**

1. [CreateIntent](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateIntent.html) オペレーションで新しいインテントを作成するか、[UpdateIntent](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UpdateIntent.html) オペレーションで既存のインテントを更新します。

1. API リクエストには、[SampleUtterance](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_SampleUtterance.html) オブジェクトの配列にマップされる `sampleUtterances` フィールドが含まれています。

1. 追加するサンプル発話ごとに、配列に `SampleUtterance` オブジェクトを追加します。サンプル発話を `utterance` フィールドの値として追加します。

1. サンプル発話を編集、削除するには、`UpdateIntent` リクエストを送信します。`sampleUtterances` フィールドに入力した発話のリストが、既存の発話と置き換わります。
**重要**  
`UpdateIntent` リクエストでフィールドを空白のままにすると、インテント内の既存の設定が削除されます。[DescribeIntent](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DescribeIntent.html) オペレーションを使用してボットの設定を返し、削除したくない設定を `UpdateIntent` リクエストにコピーします。