Amazon Lex V2 を使用している場合は、代わりに Amazon Lex V2 ガイドを参照してください。
Amazon Lex V1 を使用している場合は、ボットを Amazon Lex V2 にアップグレードすることをお勧めします。V1 には新機能を追加されませんので、すべての新しいボットには V2 を使用することを強くお勧めします。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
GetUtterancesView
GetUtterancesView
のオペレーションを使用して、ユーザーがボットに対して行った発話に関する情報を取得します。このリストを使用して、ボットが応答する発話を調整できます。
例: 花を注文するボットを作成したとします。ユーザーがボットをしばらく使用した後、GetUtterancesView
オペレーションを使用して、ユーザーが行ったリクエストとその成功の有無を確認します。「花が欲しい」という発話が認識されていないかもしれません。この発話を OrderFlowers
インテントに追加することで、ボットがその発話を認識するようになります。
ボットの新しいバージョンを公開すると、古いバージョンと新しいバージョンに関する情報を取得して、2 つのバージョン間でパフォーマンスを比較できます。
発話の統計は 1 日に 1 回生成されます。過去 15 日間のデータを使用できます。1 回のリクエストで最大 5 バージョンのボットの情報をリクエストできます。Amazon Lex は、過去 15 日間にボットが受信した最大頻度の発話を返します。レスポンスには、バージョンごとに最大 100 の発話に関する情報が含まれます。
発話の統計は、以下の条件では生成されません。
-
ボットが作成されたとき、
childDirected
フィールドが TRUE に設定されます。 -
1 つ以上のスロットでスロットの難読化を実行しています。
-
Amazon Lex の改善への参加をオプトアウトしました。
このオペレーションには、lex:GetUtterancesView
アクションに対する許可が必要です。
リクエストの構文
GET /bots/botname
/utterances?view=aggregation&bot_versions=botVersions
&status_type=statusType
HTTP/1.1
URI リクエストパラメータ
リクエストでは、次の URI パラメータを使用します。
- botname
-
発話情報を返すボットの名前。
長さの制限: 最小長は 2 です。最大長は 50 です。
Pattern:
^([A-Za-z]_?)+$
必須:はい
- botVersions
-
発話情報を返す必要があるボットバージョンの配列。制限は、リクエストごとに 5 バージョンです。
配列メンバー:最小数は 1 項目です。最大数は 5 項目です。
長さの制限:最小長は 1 です。最大長は 64 文字です。
パターン:
\$LATEST|[0-9]+
必須:はい
- statusType
-
認識された発話を返すには、
Detected
を使用します。認識されなかった発話を返すには、Missed
を使用します。有効な値:
Detected | Missed
必須: はい
リクエストボディ
リクエストにリクエスト本文がありません。
レスポンスの構文
HTTP/1.1 200
Content-type: application/json
{
"botName": "string",
"utterances": [
{
"botVersion": "string",
"utterances": [
{
"count": number,
"distinctUsers": number,
"firstUtteredDate": number,
"lastUtteredDate": number,
"utteranceString": "string"
}
]
}
]
}
レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
- botName
-
利用者情報を返すボットの名前。
型: 文字列
長さの制限: 最小長は 2 です。最大長は 50 です。
Pattern:
^([A-Za-z]_?)+$
- utterances
-
UtteranceList オブジェクトの配列で、それぞれがボットで処理された発話を記述する UtteranceData オブジェクトのリストを含みます。レスポンスには、各バージョンごとに最大 100 個の
UtteranceData
オブジェクトが含まれます。Amazon Lex は、過去 15 日間にボットが受信した最大頻度の発話を返します。型: UtteranceList オブジェクトの配列
エラー
- BadRequestException
-
リクエストが適切にフォーマットされていません。例えば、値が無効であったり、必須項目が設定されていない場合です。フィールドの値を確認して、再度お試しください。
HTTP ステータスコード:400
- InternalFailureException
-
Amazon Lex 内部エラーが発生しました。リクエストを再試行してください。
HTTP ステータスコード:500
- LimitExceededException
-
リクエストが制限を超えました。リクエストを再試行してください。
HTTP ステータスコード: 429
以下も参照してください。
言語固有の AWS SDK でこの API を使用する方法の詳細については、以下を参照してください。