CreateIntentVersion - Amazon Lex V1

Amazon Lex V2 を使用している場合は、代わりに Amazon Lex V2 ガイドを参照してください。

 

Amazon Lex V1 を使用している場合は、ボットを Amazon Lex V2 にアップグレードすることをお勧めします。V1 には新機能を追加されませんので、すべての新しいボットには V2 を使用することを強くお勧めします。

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

CreateIntentVersion

$LATEST バージョンのインテントに基づいて、インテントの新しいバージョンを作成します。$LATEST バージョンのインテントの最後の更新から変更がない場合、Amazon Lex は新しいバージョンを作成しません。最後に作成したバージョンを返します。

注記

$LATEST バージョンのインテントのみアップデートすることができます。CreateIntentVersion オペレーションを使用して作成した番号付きのバージョンを更新することはできません。

ボットの最初のバージョンを作成すると、Amazon Lex はバージョンを 1 に設定します。それ以降のバージョンは 1 ずつ増えます。詳細については、「バージョニング」を参照してください。

このオペレーションには lex:CreateIntentVersion アクションを実行するアクセス許可が必要です。

リクエストの構文

POST /intents/name/versions HTTP/1.1 Content-type: application/json { "checksum": "string" }

URI リクエストパラメータ

リクエストでは、次の URI パラメータを使用します。

name

新しいバージョンを作成するインテントの名前。名前は、大文字と小文字が区別されます。

長さの制限:最小長は 1 です。最大長は 100 です。

パターン: ^([A-Za-z]_?)+$

必須: はい

リクエストボディ

リクエストは以下の JSON 形式のデータを受け入れます。

checksum

新しいバージョンの作成に使用する $LATEST バージョンのインテントのチェックサム。チェックサムを指定しても、$LATEST バージョンのインテントのチェックサムが異なる場合、Amazon Lex は PreconditionFailedException の例外を返し、新しいバージョンを公開しません。チェックサムを指定しない場合、Amazon Lex は $LATEST バージョンを公開します。

タイプ: 文字列

必須: いいえ

レスポンスの構文

HTTP/1.1 201 Content-type: application/json { "checksum": "string", "conclusionStatement": { "messages": [ { "content": "string", "contentType": "string", "groupNumber": number } ], "responseCard": "string" }, "confirmationPrompt": { "maxAttempts": number, "messages": [ { "content": "string", "contentType": "string", "groupNumber": number } ], "responseCard": "string" }, "createdDate": number, "description": "string", "dialogCodeHook": { "messageVersion": "string", "uri": "string" }, "followUpPrompt": { "prompt": { "maxAttempts": number, "messages": [ { "content": "string", "contentType": "string", "groupNumber": number } ], "responseCard": "string" }, "rejectionStatement": { "messages": [ { "content": "string", "contentType": "string", "groupNumber": number } ], "responseCard": "string" } }, "fulfillmentActivity": { "codeHook": { "messageVersion": "string", "uri": "string" }, "type": "string" }, "inputContexts": [ { "name": "string" } ], "kendraConfiguration": { "kendraIndex": "string", "queryFilterString": "string", "role": "string" }, "lastUpdatedDate": number, "name": "string", "outputContexts": [ { "name": "string", "timeToLiveInSeconds": number, "turnsToLive": number } ], "parentIntentSignature": "string", "rejectionStatement": { "messages": [ { "content": "string", "contentType": "string", "groupNumber": number } ], "responseCard": "string" }, "sampleUtterances": [ "string" ], "slots": [ { "defaultValueSpec": { "defaultValueList": [ { "defaultValue": "string" } ] }, "description": "string", "name": "string", "obfuscationSetting": "string", "priority": number, "responseCard": "string", "sampleUtterances": [ "string" ], "slotConstraint": "string", "slotType": "string", "slotTypeVersion": "string", "valueElicitationPrompt": { "maxAttempts": number, "messages": [ { "content": "string", "contentType": "string", "groupNumber": number } ], "responseCard": "string" } } ], "version": "string" }

レスポンス要素

アクションが成功すると、HTTP 201 レスポンスが返されます。

サービスから以下のデータが JSON 形式で返されます。

checksum

作成されたインテントバージョンのチェックサム。

型: 文字列

conclusionStatement

fulfillmentActivity フィールドで指定された Lambda 関数がインテントを達成すると、Amazon Lex はこのステートメントをユーザーに伝えます。

型: Statement オブジェクト

confirmationPrompt

これが定義されている場合、Amazon Lex がユーザーのインテントを達成する前の確認に使用するプロンプトです。

型: Prompt オブジェクト

createdDate

インテントが作成された日付。

型: タイムスタンプ

description

インテントの説明。

型: 文字列

長さの制限: 最小長は 0 です。最大長は 200 です。

dialogCodeHook

これが定義されている場合、Amazon Lex は各ユーザー入力に対してこの Lambda 関数を呼び出します。

型: CodeHook オブジェクト

followUpPrompt

これが定義されている場合、Amazon Lex はこのプロンプトを使用して、インテントが達成された後に追加のユーザーアクティビティを要求します。

型: FollowUpPrompt オブジェクト

fulfillmentActivity

インテントがどのように達成されるのかを説明します。

型: FulfillmentActivity オブジェクト

inputContexts

Amazon Lex がユーザーとの会話の中でインテントを選択するためのアクティブなコンテキストをリストアップした InputContext オブジェクトの配列です。

型: InputContext オブジェクトの配列

配列メンバー:最小数は 0 項目です。最大数は 5 項目です。

kendraConfiguration

Amazon Kendra インデックスと AMAZON.KendraSearchIntent インテントを接続するための設定情報 (項目がある場合)。

型: KendraConfiguration オブジェクト

lastUpdatedDate

インテントが更新された日付。

型: タイムスタンプ

name

インテントの名前。

型: 文字列

長さの制限: 最小長は 1 です。最大長は 100 です。

パターン: ^([A-Za-z]_?)+$

outputContexts

OutputContext オブジェクトの配列で、インテントが達成されたときにアクティブになるコンテキストを列挙します。

型: OutputContext オブジェクトの配列

の配列メンバー: 最小数は 0 項目です。最大数は 10 項目です。

parentIntentSignature

組み込みインテントの一意の識別子。

型: 文字列

rejectionStatement

ユーザーが confirmationPrompt で定義された質問に「いいえ」と答えた場合、Amazon Lex はインテントがキャンセルされたことを確認するためにこのステートメントを返します。

型: Statement オブジェクト

sampleUtterances

インテント用に構成されたサンプル発話の配列。

型: 文字列の配列

配列メンバー:最小数は 0 項目です。最大数は 1500 項目です。

長さの制限:最小長は 1 です。最大長は 200 です。

slots

インテントを達成するために必要な情報を定義するスロットタイプの配列。

型: Slot オブジェクトの配列

配列メンバー: 最小数は 0 項目です。最大数は 100 項目です。

version

インテントの新しいバージョンに割り当てられたバージョン番号。

型: 文字列

長さの制限:最小長は 1 です。最大長は 64 文字です。

パターン:\$LATEST|[0-9]+

エラー

BadRequestException

リクエストが適切にフォーマットされていません。例えば、値が無効であったり、必須項目が設定されていない場合です。フィールドの値を確認して、再度お試しください。

HTTP ステータスコード:400

ConflictException

リクエストの処理中に競合が発生しました。リクエストを再試行してください。

HTTP ステータスコード: 409

InternalFailureException

Amazon Lex 内部エラーが発生しました。リクエストを再試行してください。

HTTP ステータスコード:500

LimitExceededException

リクエストが制限を超えました。リクエストを再試行してください。

HTTP ステータスコード: 429

NotFoundException

リクエストで指定されたリソースは見つかりませんでした。リソースを確認して、もう一度お試しください。

HTTP ステータスコード: 404

PreconditionFailedException

変更しようとしているリソースのチェックサムがリクエストのチェックサムと一致しません。リソースのチェックサムを確認して、もう一度お試しください。

HTTP ステータスコード: 412

その他の参照資料

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。