サポート終了通知: 2025 年 9 月 15 日、 AWS は Amazon Lex V1 のサポートを終了します。 V1 2025 年 9 月 15 日を過ぎると、Amazon Lex V1 コンソールまたは Amazon Lex V1 リソースにはアクセスできなくなります。Amazon Lex V2 を使用している場合は、代わりに [Amazon Lex V2 ガイド](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html)を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# メッセージの管理
**Topics**
+ [メッセージのタイプ](#msg-prompts-msg-types)
+ [メッセージの設定のコンテキスト](#msg-prompts-context-for-msgs)
+ [サポートされているメッセージ形式](#msg-prompts-formats)
+ [メッセージグループ](#message-groups)
+ [レスポンスカード](#msg-prompts-resp-card)
ボットを作成する際に、クライアントに送信したい明確メッセージや情報メッセージを設定できます。次の例を考えます。
+ 次の明確化プロンプトをボットに設定できます。
```
I don't understand. What would you like to do?
```
Amazon Lex は、ユーザーのインテントを理解できない場合に、このメッセージをクライアントに送信します。
+ `OrderPizza` というインテントをサポートするボットを作成するとします。ピザの注文では、ピザのサイズ、トッピング、クラストタイプなどの情報を指定するようにユーザーに求めます。以下のプロンプトを設定することもできます。
```
What size pizza do you want?
What toppings do you want?
Do you want thick or thin crust?
```
Amazon Lex はユーザーのインテントがピザの注文であると判断すると、これらのメッセージをクライアントに送信してユーザーから情報を取得します。
このセクションでは、ボットの設定でユーザーのやり取りをデザインする方法について説明します。
## メッセージのタイプ
メッセージはプロンプトまたはステートメントにすることができます。
+ 通常、*プロンプト*は質問でユーザーからのレスポンスを想定します。
+ *ステートメント*は情報を表示します。これはレスポンスを想定していません。
メッセージには、スロット、セッション属性、リクエスト属性への参照を含めることができます。実行時に、Amazon Lex は、これらの参照を実際の値で置き換えます。
設定されたスロット値を参照するには、次の構文を使用します。
```
{SlotName}
```
セッション属性を参照するには、次の構文を使用します。
```
[SessionAttributeName]
```
リクエスト属性を参照するには、以下の構文を使用します。
```
((RequestAttributeName))
```
メッセージには、スロット値、セッション属性、リクエスト属性を含めることができます。
例えば、次のメッセージをボットの OrderPizza インテントに設定したとします。
```
"Hey [FirstName], your {PizzaTopping} pizza will arrive in [DeliveryTime] minutes."
```
このメッセージでは、スロット (`PizzaTopping`) とセッション属性 (`FirstName` と `DeliveryTime`) の両方が参照されています。実行時に、Amazon Lex はこれらのプレースホルダを値に置き換えて、次のメッセージをクライアントに返します。
```
"Hey John, your cheese pizza will arrive in 30 minutes."
```
メッセージに角括弧 ([]) または中括弧 (\$1\$1) を入れるには、バックスラッシュ (\$1) のエスケープ文字を使用します。例えば、次のメッセージには中括弧と角括弧が含まれています。
```
\{Text\} \[Text\]
```
クライアントアプリケーションに返されたテキストは次のようになります。
```
{Text} [Text]
```
セッション属性の詳細については、ランタイム API オペレーションの「[PostText](API_runtime_PostText.md)」および「[PostContent](API_runtime_PostContent.md)」を参照してください。例については、[旅行を予約する](ex-book-trip.md)を参照してください。
Lambda 関数は、メッセージを生成して Amazon Lex に返し、ユーザーに送信することもできます。インテントの設定時に Lambda 関数を追加すると、メッセージを動的に作成できます。ボットの設定時にメッセージを指定すると、Lambda 関数でプロンプトを構築する必要がなくなります。
## メッセージの設定のコンテキスト
ボットを作成する場合、ボットの明確化プロンプト、スロット値のプロンプト、インテントからのメッセージなど、異なるコンテキストでメッセージを作成することができます。Amazon Lex は各コンテキストで適切なメッセージを選択してユーザーに戻します。各コンテキストにメッセージのグループを指定することができます。この場合、Amazon Lex はグループから 1 つのメッセージをランダムに選択します。メッセージの形式を指定したり、メッセージをグループにまとめることもできます。詳細については、「[サポートされているメッセージ形式](#msg-prompts-formats)」を参照してください。
インテントと関連付けている Lambda 関数がある場合は、構築時に設定したメッセージをどれでも上書きできます。ただし、こうしたメッセージを使用する上で Lambda 関数は必須ではありません。
### ボットメッセージ
ボットに明確化プロンプトおよびセッション終了メッセージを設定できます。実行時にユーザーのインテントを理解できない場合、Amazon Lex は明確化プロンプト**を使用します。Amazon Lex がセッション終了メッセージを送信する前に、説明を要求する回数を設定できます。次の画像のように、Amazon Lex コンソールの **[エラー処理]** セクションでボットレベルのメッセージを設定できます。
![\[コンソールのエディタタブにあるエラー処理セクション。説明を求めるプロンプトとハングアップフレーズを指定できます。\]](http://docs.aws.amazon.com/ja_jp/lex/latest/dg/images/how-works-20.png)
API で `clarificationPrompt` と `abortStatement` フィールドを設定してメッセージを設定します。このフィールドは [PutBot](API_PutBot.md) オペレーションにあります。
インテントで Lambda 関数を使用する場合は、Lambda 関数がユーザーのインテントを尋ねるために Amazon Lex に向けたレスポンスを戻す場合があります。Lambda 関数がそうしたメッセージを提供しない場合は、Amazon Lex が明確化プロンプトを使用します。
### スロットプロンプト
インテントの必須スロットのそれぞれに少なくとも 1 つのプロンプトメッセージを指定する必要があります。実行時に、Amazon Lex はこれらのメッセージのいずれかを使用して、スロットの値を指定することをユーザーに求めます。次は、`cityName` スロットに対する有効なプロンプトの例です。
```
Which city would you like to fly to?
```
コンソールを使用して各スロットの 1 つまたは複数のプロンプトを設定できます。プロンプトのグループは、[PutIntent](API_PutIntent.md) オペレーションを使用して作成することもできます。詳細については、「[メッセージグループ](#message-groups)」を参照してください。
### レスポンス
コンソールで [**Responses (レスポンス)**] セクションを使用し、ボットに動的で柔軟性の高い会話を構築します。レスポンスに 1 つ以上のメッセージグループを作成することができます。実行時に、Amazon Lex は各メッセージグループからメッセージを 1 つ選択することでレスポンスを構築します。メッセージグループの詳細については、「[メッセージグループ](#message-groups)」を参照してください。
例えば、最初のメッセージグループに「初めまして」、「こんにちは」、「ようこそ」といったように異なる応答メッセージを含めることができます。2 番目のメッセージグループには「私は予約ボットです」や「これは予約ボットです」といった異なる紹介メッセージを含めることもできます。3 番目のメッセージグループでは「レンタカーとホテルの予約をお手伝いします」、「レンタカーやホテルを予約することができます」、「レンタカーやホテルの予約をお手伝いできます」といったボットの通信機能を利用することができます。
Lex は各メッセージグループのメッセージを使用して、会話のレスポンスを動的に構築します。例えば、1 つのやり取りを以下に示します。
![\[ボットとの会話の 1 つの例\]](http://docs.aws.amazon.com/ja_jp/lex/latest/dg/images/default-response-10b.png)
もう 1 つの例としては、次のようなものがあります。
![\[ボットとの会話の別の例\]](http://docs.aws.amazon.com/ja_jp/lex/latest/dg/images/default-response-20c.png)
どちらの場合も、ユーザーは `BookCar` や `BookHotel` などで新しいインテントを使用して応答することができます。
レスポンスでフォローアップの質問をするようにボットをセットアップできます。例えば、前述のインタラクションでは「レンタカーやホテルの予約をお手伝いしましょうか?」、「今すぐ予約を入れますか?」、「他にお手伝いできることはありますか?」といった質問を追加して 4 番目のメッセージを作成することもできます。レスポンスとして「いいえ」が含まれるメッセージには、フォローアップのプロンプトを作成できます。次の画像に例を示します。
![\[ボットとの会話でのフォローアッププロンプト\]](http://docs.aws.amazon.com/ja_jp/lex/latest/dg/images/default-response-25a.png)
フォローアップのプロンプトを作成するには [**Wait for user reply**] を選択します。次に、メッセージを入力またはユーザーが「いいえ」と回答した場合に送信する複数のメッセージを入力します。フォローアップのプロンプトとして使用するレスポンスを作成する場合は、回答が「いいえ」だった場合に適切なステートメントを特定する必要があります。例については、次の画像を参照してください。
![\[ユーザーが「いいえ」と言ったときのメッセージ設定。\]](http://docs.aws.amazon.com/ja_jp/lex/latest/dg/images/default-response-30b.png)
API を使用してインテントに応答を追加するには、`PutIntent` オペレーションを使用します。レスポンスを特定するには [`conclusionStatement`] フィールドを `PutIntent` リクエストで設定します。フォローアップのプロンプトを設定するには、[`followUpPrompt`] フィールドを設定します。これにはユーザーが「いいえ」と回答した場合に送信するステートメントを含めてください。[`conclusionStatement`] フィールドと [`followUpPrompt`] フィールドの両方を同じインテントで設定することはできません。
## サポートされているメッセージ形式
[PostText](API_runtime_PostText.md) オペレーションを使用する場合、または [PostContent](API_runtime_PostContent.md) オペレーションを使用する場合に `Accept` ヘッダーを `text/plain;charset=utf8` に設定している場合、Amazon Lex は次の形式でメッセージをサポートします。
+ `PlainText` - メッセージには UTF-8 形式テキストが含まれています。
+ `SSML` - メッセージには音声出力のテキスト形式が含まれています。
+ `CustomPayload` - メッセージにはクライアント向けに作成したカスタム形式が含まれています。アプリケーションのニーズを満たすようにペイロードを定義することができます。
+ `Composite` - メッセージは各メッセージグループから 1 つずつ取り出したメッセージを集約したものです。メッセージグループの詳細については、「[メッセージグループ](#message-groups)」を参照してください。
デフォルトでは、Amazon Lex が特定のプロンプトに定義されているメッセージのうち 1 つを返します。例えば、スロット値を引き出すために 5 つのメッセージを定義した場合、Amazon Lex はランダムにいずれかのメッセージを選びクライアントに返します。
Amazon Lex がランタイムリクエストでクライアントに指定のメッセージタイプを返すには、`x-amzn-lex:accept-content-types` リクエストパラメータを設定します。レスポンスはリクエストされたタイプに制限されます。指定したタイプのメッセージが複数ある場合は、Amazon Lex がランダムに 1 つ返します。`x-amz-lex:accept-content-types` ヘッダーの詳細については、「[レスポンスタイプの設定](context-mgmt-request-attribs.md#special-response)」を参照してください。
## メッセージグループ
*メッセージグループ* は特定のプロンプトに対する一連の適切なレスポンスです。ボットで会話のレスポンスを動的に構築する場合は、メッセージグループを使用します。Amazon Lex がクライアントアプリケーションにレスポンスを返すと、各グループからメッセージを 1 つランダムに選択します。各レスポンスで最大 5 件のメッセージを作成できます。各グループには最大 5 件のメッセージを含めることができます。コンソールでメッセージグループを作成する例については「[レスポンス](#msg-prompts-response)」を参照してください。
メッセージグループを作成するには、コンソールを使用するか、[PutBot](API_PutBot.md)、[PutIntent](API_PutIntent.md)、または [PutSlotType](API_PutSlotType.md) オペレーションを使用して、メッセージにグループ数を割り当てることができます。メッセージグループを作成しない場合やメッセージグループを 1 つだけ作成した場合、Amazon Lex は `Message` フィールドでメッセージを 1 件送信します。コンソールでメッセージグループを複数作成した場合、または [PutIntent](API_PutIntent.md) オペレーションを使用してインテントを作成または更新したメッセージグループを複数作成した場合に限り、クライアントアプリケーションはレスポンスで複数のメッセージを受け取ります。
Amazon Lex がグループからメッセージを送信すると、レスポンスの `Message` フィールドにはメッセージを含むエスケープした JSON オブジェクトがあります。次の例は複数のメッセージを含む [`Message`] フィールドのコンテンツを示しています。
**注記**
このファイルは、読みやすいようにフォーマットされています。レスポンスに改行 (CR) は含まれていません。
```
{\"messages\":[
{\"type\":\"PlainText\",\"group\":0,\"value\":\"Plain text\"},
{\"type\":\"SSML\",\"group\":1,\"value\":\"SSML text\"},
{\"type\":\"CustomPayload\",\"group\":2,\"value\":\"Custom payload\"}
]}
```
メッセージの形式を設定できます。形式は次のいずれかになります。
+ プレーンテキスト—UTF-8 形式テキストのメッセージです。
+ SSML—音声合成マークアップ言語 (SSML) のメッセージです。
+ CustomPayload—指定したカスタム警視のメッセージです。
`PostContent` と `PostText` オペレーションが [`Message`] フィールドで返すメッセージの形式を管理するには、`x-amz-lex:accept-content-types` リクエストの属性を設定します。例えば次のようにヘッダーを設定すると、レスポンスでプレーンテキストと SSML メッセージのみを受信するようになります。
```
x-amz-lex:accept-content-types: PlainText,SSML
```
特定のメッセージ形式をリクエストし、メッセージグループにその形式のメッセージが含まれていない場合は `NoUsableMessageException` 例外を受信します。メッセージグループを使用してタイプ別にメッセージをグループ化する場合は、`x-amz-lex:accept-content-types` ヘッダーを使用しないでください。
`x-amz-lex:accept-content-types` ヘッダーの詳細については、「[レスポンスタイプの設定](context-mgmt-request-attribs.md#special-response)」を参照してください。
## レスポンスカード
**注記**
レスポンスカードは Amazon Connect チャットでは機能しません。ただし、同様の機能については、「[対話型メッセージをチャットに追加する](https://docs.aws.amazon.com/connect/latest/adminguide/interactive-messages.html)」を参照してください。
*レスポンスカード*にはプロンプトに対する適切なレスポンスの一連が含まれています。レスポンスカードを使用すると、ユーザーとのやり取りが簡素化され、テキストのやり取りで入力ミスが減り、ボットの精度が向上します。Amazon Lex からクライアントアプリケーションに送信される各プロンプトに対して、レスポンスカードを送信できます。レスポンスカードは、Facebook Messenger、Slack、Twilio、および独自のクライアントアプリケーションで使用できます。
例えば、タクシーアプリケーションで、レスポンスカードに「自宅」のオプションを設定し、その値としてユーザーの自宅の住所を設定できます。このオプションをユーザーが選択すると、Amazon Lex では入力テキストとして住所全体を受け取ります。次の画像を参照してください。
![\[レスポンスカードの例。\]](http://docs.aws.amazon.com/ja_jp/lex/latest/dg/images/resp-console-5.png)
レスポンスカードは以下のプロンプトに対して定義できます。
+ 結論ステートメント
+ 確認プロンプト
+ フォローアッププロンプト
+ 拒否ステートメント
+ スロットタイプ発話
プロンプトごとに 1 つレスポンスカードのみ定義できます。
レスポンスカードは、インテントを作成するときに設定します。コンソールまたは [PutIntent](API_PutIntent.md) オペレーションを使用して静的レスポンスカードを構築時に定義できます。または、Lambda 関数でランタイムに動的レスポンスを定義できます。静的レスポンスカードと動的レスポンスカードの両方を定義すると、動的レスポンスカードが優先されます。
Amazon Lex は、クライアントが理解する形式でレスポンスカードを送信します。レスポンスカードは、Facebook Messenger、Slack、Twilio に応じて変換されます。その他のクライアントの場合、Amazon Lex は [PostText](API_runtime_PostText.md) レスポンスで JSON 構造を送信します。例えば、クライアントが Facebook Messenger である場合、Amazon Lex はレスポンスカードを一般テンプレートに変換します。Facebook Messenger の一般テンプレートの詳細については、Facebook ウェブサイトの「[一般テンプレート](https://developers.facebook.com/docs/messenger-platform/send-api-reference/generic-template)」を参照してください。JSON 構造の例については、「[レスポンスカードの動的な生成](#msg-prompts-resp-card-dynamic)」を参照してください。
レスポンスカードは、[PostText](API_runtime_PostText.md) オペレーションでのみ使用できます。レスポンスカードを [PostContent](API_runtime_PostContent.md) オペレーションで使用することはできません。
### 静的レスポンスカードの定義
静的レスポンスカードは、インテントの作成時に [PutBot](API_PutBot.md) オペレーションまたは Amazon Lex コンソールで定義します。静的レスポンスカードはインテントと同時に定義されます。静的レスポンスカードはレスポンスが固定されているときに使用します。例えば、風味のスロットがあるインテントのボットを作成するとします。風味のスロットを定義する場合、次のコンソールのスクリーンショットに示すようなプロンプトを指定します。
![\[コンソールのインテントエディタ。\]](http://docs.aws.amazon.com/ja_jp/lex/latest/dg/images/resp-console-10a.png)
プロンプトを定義する場合は、必要に応じてレスポンスカードを関連付け、[PutBot](API_PutBot.md) オペレーションまたは Amazon Lex コンソール (次の例を参照) で詳細を定義できます。
![\[レスポンスカードエディタを示すコンソール。\]](http://docs.aws.amazon.com/ja_jp/lex/latest/dg/images/resp-console-20a.png)
ここで、ボットを Facebook Messenger と統合したとします。ユーザーは、次の図に示すように、ボタンをクリックして風味を選択できます。
![\[Facebook Messenger でのレスポンスカード。\]](http://docs.aws.amazon.com/ja_jp/lex/latest/dg/images/resp-fb-exampleA.png)
レスポンスカードのコンテンツをカスタマイズするには、セッション属性を参照できます。実行時に、Amazon Lex は、このリファレンスをセッション属性の該当する値に置き換えます。詳細については、「[セッション属性の設定](context-mgmt-session-attribs.md)」を参照してください。例については、[レスポンスカードの使用](ex-resp-card.md)を参照してください。
### レスポンスカードの動的な生成
レスポンスカードをランタイムに動的に生成するには、インテントで初期化および検証の Lambda 関数を使用します。動的レスポンスカードは、Lambda 関数でレスポンスがランタイムに確定される場合に使用します。Lambda 関数は、ユーザー入力に応答してレスポンスカードを生成し、それをレスポンスの `dialogAction` セクションで返します。詳細については、「[レスポンスの形式](lambda-input-response-format.md#using-lambda-response-format)」を参照してください。
Lambda 関数内の `responseCard` エレメントを示す部分は以下のとおりです。これにより、前のセクションで示したようなユーザーエクスペリエンスが生成されます。
```
responseCard: {
"version": 1,
"contentType": "application/vnd.amazonaws.card.generic",
"genericAttachments": [
{
"title": "What Flavor?",
"subtitle": "What flavor do you want?",
"imageUrl": "Link to image",
"attachmentLinkUrl": "Link to attachment",
"buttons": [
{
"text": "Lemon",
"value": "lemon"
},
{
"text": "Raspberry",
"value": "raspberry"
},
{
"text": "Plain",
"value": "plain"
}
]
}
]
}
```
例については、[予約のスケジュール](ex1-sch-appt.md)を参照してください。