GetUtterancesView - Amazon Lex V1

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 SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。