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

# 記述的ボットビルダーを使用した、Lex V2 での説明文によるボットの構築
<a name="nld-bots"></a>

**注記**  
生成 AI 機能を活用するには、最初に以下の前提条件を満たす必要があります。  
Amazon Bedrock の使用料金については、「[Amazon Bedrock の料金](https://aws.amazon.com/bedrock/pricing/)」を参照してください。
ボットロケールで生成 AI 機能を有効にします。これを行うには、「[生成 AI を使用した Lex V2 ボットの作成とパフォーマンスの最適化](generative-features.md)」の手順に従います。

記述型ボットビルダーでは、Amazon Bedrock の大規模言語モデルへのアクセスを活用して、ボット作成プロセスの効率を高めることができます。ボットの目的および実行すべきアクションを含むプロンプトを自然言語で入力します。Amazon Lex V2 は Amazon Bedrock の機能を利用して、ユーザーの説明に基づいてボットに関連するインテントとスロットタイプを生成します。保持したいインテントとスロットタイプを選択したら、ボットを反復処理して特定のユースケースに合わせて変更できます。記述的ボットビルダーを使用すると、ボットのインテントとスロットタイプを手動で作成する必要がなくなるため、時間を節約できます。

記述的ボットビルダーは英語ロケールで使用できます (「[Amazon Lex V2 でサポートされている言語とロケール](how-languages.md)」の表で `en_` で始まるロケールを参照してください)。

ボットを作成する前に、次のことを行います。

1. 「[Lex V2 で自然言語による説明でボットを作成するために必要な権限](nld-permissions.md)」の手順を参照して、ロールに正しい権限があることを確認します。

1. 使用する説明を決定します。ボットの説明のサンプルについては、「[記述型ボットビルダーのボットの説明例](nld-examples.md)」を参照してください。

自然言語を使用してボットができることを説明し、ボットを作成します。Amazon Lex V2 は Amazon Bedrock モデルを呼び出し、ボットのユースケースに合ったインテントとスロットタイプを生成します。ボットは、コンソールまたは API を使用して作成できます。

------
#### [ Console ]

**記述的ボットビルダーを使用してボットを作成する**

1. AWS マネジメントコンソールにサインインし、[https://console.aws.amazon.com/lexv2/home](https://console.aws.amazon.com/lexv2/home) で Amazon Lex V2 コンソールを開きます。

1. **[ボット]** ページで、**[ボットを作成]** を選択します。

1. **[作成方法]** で、**[記述的ボットビルダー - 生成 AI]** を選択します。

1. ボットの名前とオプションの説明を入力し、IAM 権限を設定して、ボットが COPPA の対象となるかどうかを選択します。**[次へ]** を選択します。

1. ボットを作成する言語、ボットの音声、インテント分類の信頼度しきい値を選択します (詳細については、「[Lex V2 でのインテント信頼スコアを使用したインテント選択の改善](using-intent-confidence-scores.md)」を参照してください)。

1. **[記述的ボットビルダー - 生成 AI]** で、作成するボットの説明を入力します。説明は、詳細かつ正確な内容とし、ボットのインテントを適切かつ十分に生成できるようにします。****インテント作成プロセスを改善するためのアクションのリストを含めます。

1. **[モデルを選択]** で、モデルプロバイダーとモデルを選択します。

1. 別のロケールでボットを作成するには、**[別の言語を追加]** を選択します。言語の追加が完了したら、**[完了]** を選択します。Amazon Lex V2 でボットを作成し、記述的ボットビルダーでボットのインテントとスロットを生成します。ロケールが生成されると、バナーは青から緑に変わります。**[レビュー]** を選択すると、生成されたインテントとスロットタイプが表示されます。
**注記**  
現在、記述的ボットビルダーは、英語ロケールでのみ利用可能です。ただし、ボットを作成した後で英語以外のロケールにコピーすることはできます。

**生成されたインテントとスロットタイプを確認してボットに追加する**

1. ボットのユースケースに適用できるインテントとスロットタイプが十分にある場合は、生成されたインテントを確認できます。

   1. **生成されたインテント**を確認します。

      1. インテントの横のチェックボックスをオフにすると、ボットに追加するインテントのリストからインテントが削除されます。

      1. インテント名を選択すると、そのインテント用に生成された**サンプル発話**と**スロット**が表示されます。

      1. デフォルトでは、すべての発話とスロットが選択されます。チェックボックスをオフにすると、その項目がインテントから削除されます。**[選択内容に追加]** を選択すると、チェックした項目がインテントに残ります。

   1. **生成されたスロットタイプ**を確認します。

      1. スロットタイプの横にあるチェックボックスをオフにすると、ボットに追加するインテントのリストからスロットタイプが削除されます。

      1. スロットタイプをボットに追加した後に、そのスロットタイプに値を追加できます。

1. インテントとスロットタイプを確認したら、ページ上部の **[インテントとスロットタイプを追加]** を選択して、インテントとスロットタイプをボットに追加します。

1. リソースの追加が完了すると、緑色の成功バナーが表示されます。生成されたインテントやスロットタイプを編集したり、値を追加したりするには、**[インテント]** と **[スロットタイプ]** に移動します。

1. **生成されたインテント**と**生成されたスロットタイプ**が、作成するボットにほとんど適用できない場合は、次の手順を実行します。

   1. **[記述的ボットビルダーの詳細]** セクションで、**[新しい生成]** を選択します。

   1. プロンプトを書き直して **[再生成]** を選択し、新しいインテントとスロットタイプを生成します。別のモデルを使用すると、結果は異なります。
**重要**  
同じインテントやスロットが生成される保証はありません。インテントやスロットタイプを再生成するたびに課金されます。

------
#### [ API ]

**自然言語の説明を使用してボットを作成する**

API を介して記述的ボットビルダーを使用すると、Amazon S3 バケットにボット定義が .zip ファイルとして作成されます。このファイルをダウンロードし、ボット定義を Amazon Lex V2 にインポートしてボットを作成します。

1. [CreateBot](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateBot.html) リクエストを送信して、新しいボットを作成します。次に、[CreateBotLocale](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateBotLocale.html) リクエストを送信して、ボットロケールを作成します。

1. ボットの ID、バージョン、ロケールを指定して、[StartBotResourceGeneration](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_StartBotResourceGeneration.html) リクエストを送信します。ボットバージョンとして `DRAFT` を使用できます。`generationInputPrompt` フィールドにプロンプトを入力します。説明は、詳細かつ正確な内容とし、ボットのインテントを適切かつ十分に生成できるようにします。****インテント作成プロセスを改善するためのアクションのリストを含めます。

1. レスポンス内の `generationId` を記録しておきます。

1. `StartBotResourceGeneration` レスポンスで受け取った `generationId` を使用して [DescribeBotResourceGeneration](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DescribeBotResourceGeneration.html) リクエストを送信します。ボット ID、バージョン、ロケールを含めます。

1. `DescribeBotResourceGeneration` レスポンス内の `generationStatus` が `Complete` である場合、`generatedBotLocaleUrl` フィールドも入力されます。この Amazon S3 URI を使用し、「[オブジェクトのダウンロード](https://docs.aws.amazon.com/AmazonS3/latest/userguide/download-objects.html)」の手順に従ってボット定義をダウンロードします。

**生成されたボット定義を確認してインポートする**

1. `DescribeBotResourceGeneration` レスポンス内の `generationStatus` から Amazon S3 URI を使用し、「[オブジェクトのダウンロード](https://docs.aws.amazon.com/AmazonS3/latest/userguide/download-objects.html)」の手順に従ってボット定義をダウンロードします。

1. ファイルを編集することで、生成されたコンテンツをボットの特定のユースケースに合わせて直接変更できます。別の `StartBotResourceGeneration` リクエストを送信してインテントとスロットを再生成することもできます。
**重要**  
同じインテントやスロットが生成される保証はありません。インテントやスロットタイプを再生成するたびに課金されます。

1. ボット定義をインポートするには、「[Lex V2 でのボットのインポート](import.md)」の手順に従います。

1. インポート後に、[UpdateIntent](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UpdateIntent.html)、[UpdateSlot](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UpdateSlot.html)、および [UpdateSlotType](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UpdateSlotType.html) の各オペレーションを使用して、生成されたインテントとスロットを変更できます。

ボットロケールで生成されたすべての項目に関するメタデータを一覧表示するには、[ListBotResourceGenerations](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_ListBotResourceGenerations.html) オペレーションを使用します。`DescribeBotResourcGeneration` リクエストで返された `generationId` 値のいずれかを使用して、生成されたボット定義の Amazon S3 URI を取得します。

------

**Topics**
+ [記述型ボットビルダーのボットの説明例](nld-examples.md)
+ [Lex V2 で自然言語による説明でボットを作成するために必要な権限](nld-permissions.md)