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