サンプル発話

フォーカスモード

サンプル発話 - Amazon Lex

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

飛行機を予約したい
飛行機の予約を取って
飛行機のチケットをお願い!
{DepartureCity} から {DestinationCity} の飛行機

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

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

サンプル発話は、インテントエディター、ビジュアル会話ビルダー、または CreateIntent または UpdateIntent API オペレーションを使用して追加できます。Amazon Bedrock の生成 AI 機能を活用して、サンプル発話を自動的に生成することもできます。詳細については、「発話生成を使用したインテント認識用のサンプル発話の生成」を参照してください。

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

インテントエディターで、[サンプル発話] セクションに移動します。ビジュアル会話ビルダーの開始ブロックにある [サンプル発話] セクションを探してください。
透明なテキスト I want to book a flight が表示されたボックスに、サンプル発話を入力します。[発話を追加] を選択して発話を追加します。
追加したサンプル発話を [プレビュー] または [プレーンテキスト] モードで表示します。プレーンテキストでは、各行が個別の発話です。プレビューモードでは、発話にカーソルを合わせると以下のオプションが表示されます。
- テキストボックスを選択して発話を編集します。
- テキストボックスの右側にある [x] ボタンを選択して、発話を削除します。
- テキストボックスの左側にあるボタンをドラッグして、サンプル発話の順序を変更します。
上部の検索バーを使用してサンプル発話を検索し、その横にあるドロップダウンメニューを使用して発話を追加した順序またはアルファベット順に並べ替えます。

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

CreateIntent オペレーションで新しいインテントを作成するか、UpdateIntent オペレーションで既存のインテントを更新します。
API リクエストには、SampleUtterance オブジェクトの配列にマップされる sampleUtterances フィールドが含まれています。
追加するサンプル発話ごとに、配列に SampleUtterance オブジェクトを追加します。サンプル発話を utterance フィールドの値として追加します。
サンプル発話を編集、削除するには、UpdateIntent リクエストを送信します。sampleUtterances フィールドに入力した発話のリストが、既存の発話と置き換わります。

重要
UpdateIntent リクエストでフィールドを空白のままにすると、インテント内の既存の設定が削除されます。DescribeIntent オペレーションを使用してボットの設定を返し、削除したくない設定を UpdateIntent リクエストにコピーします。