支援終止通知：2025 年 9 月 15 日， AWS 將停止對 Amazon Lex 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)。本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # CreateIntentVersion 根據意圖的版本建立新的意圖`$LATEST`版本。如果自上次更新後，此意圖的`$LATEST`版本尚未變更，Amazon Lex 不會建立新的版本。它會傳回您建立的最後一個版本。 **注意** 您只能更新意圖的`$LATEST`版本。您無法更新使用 `CreateIntentVersion`操作建立的編號版本。當您建立意圖版本時，Amazon Lex 會將版本設定為 1。後續版本會累加 1。如需詳細資訊，請參閱[版本控制](versioning-aliases.md#versioning-intro)。這項操作需要許可來執行 `lex:CreateIntentVersion` 動作。 ## 請求語法 ``` POST /intents/name/versions HTTP/1.1 Content-type: application/json { "checksum": "string" } ``` ## URI 請求參數請求會使用下列 URI 參數。 ** [name](#API_CreateIntentVersion_RequestSyntax) ** 您要建立新版本之意圖的名稱。名稱區分大小寫。長度限制：長度下限為 1。長度上限為 100。模式：`^([A-Za-z]_?)+$` 必要：是 ## 請求主體請求接受採用 JSON 格式的下列資料。 ** [checksum](#API_CreateIntentVersion_RequestSyntax) ** 應用於建立新`$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](#API_CreateIntentVersion_ResponseSyntax) ** 已建立意圖版本的檢查總和。類型：字串 ** [conclusionStatement](#API_CreateIntentVersion_ResponseSyntax) ** 在 `fulfillmentActivity` 欄位指定的 Lambda 函數滿足意圖後，Amazon Lex 會將此陳述式傳達給使用者。類型：[Statement](API_Statement.md) 物件 ** [confirmationPrompt](#API_CreateIntentVersion_ResponseSyntax) ** 如果已定義，Amazon Lex 會先使用確認使用者意圖的提示，再予以滿足。類型：[Prompt](API_Prompt.md) 物件 ** [createdDate](#API_CreateIntentVersion_ResponseSyntax) ** 建立意圖的日期。類型：Timestamp ** [description](#API_CreateIntentVersion_ResponseSyntax) ** 意圖的描述。類型：字串長度限制：長度下限為 0。長度上限為 200。 ** [dialogCodeHook](#API_CreateIntentVersion_ResponseSyntax) ** 如果已定義，Amazon Lex 會為每個使用者輸入調用此 Lambda 函數。類型：[CodeHook](API_CodeHook.md) 物件 ** [followUpPrompt](#API_CreateIntentVersion_ResponseSyntax) ** 如果已定義，Amazon Lex 會在滿足意圖後使用此提示來請求額外的使用者活動。類型：[FollowUpPrompt](API_FollowUpPrompt.md) 物件 ** [fulfillmentActivity](#API_CreateIntentVersion_ResponseSyntax) ** 描述如何實現意圖。類型：[FulfillmentActivity](API_FulfillmentActivity.md) 物件 ** [inputContexts](#API_CreateIntentVersion_ResponseSyntax) ** 物件陣列`InputContext`，列出 Amazon Lex 在與使用者的對話中必須處於作用中狀態的內容，以選擇意圖。類型：[InputContext](API_InputContext.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 5。 ** [kendraConfiguration](#API_CreateIntentVersion_ResponseSyntax) ** 若有組態資訊，用於將 Amazon Kendra 索引與`AMAZON.KendraSearchIntent`意圖連線。類型：[KendraConfiguration](API_KendraConfiguration.md) 物件 ** [lastUpdatedDate](#API_CreateIntentVersion_ResponseSyntax) ** 意圖更新的日期。類型：Timestamp ** [name](#API_CreateIntentVersion_ResponseSyntax) ** 意圖的名稱。類型：字串長度限制：長度下限為 1。長度上限為 100。模式：`^([A-Za-z]_?)+$` ** [outputContexts](#API_CreateIntentVersion_ResponseSyntax) ** 物件陣列`OutputContext`，列出意圖在滿足意圖時啟用的內容。類型：[OutputContext](API_OutputContext.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 10。 ** [parentIntentSignature](#API_CreateIntentVersion_ResponseSyntax) ** 內建意圖的唯一識別符。類型：字串 ** [rejectionStatement](#API_CreateIntentVersion_ResponseSyntax) ** 如果使用者對中定義的問題回答「否」`confirmationPrompt`，Amazon Lex 會回應此陳述式，以確認意圖已取消。類型：[Statement](API_Statement.md) 物件 ** [sampleUtterances](#API_CreateIntentVersion_ResponseSyntax) ** 為意圖設定的範例表達用語陣列。類型：字串陣列陣列成員：項目數下限為 0。最多 1500 個項目。長度限制：長度下限為 1。長度上限為 200。 ** [slots](#API_CreateIntentVersion_ResponseSyntax) ** 槽類型的陣列，定義實現意圖所需的資訊。類型：[Slot](API_Slot.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 100。 ** [version](#API_CreateIntentVersion_ResponseSyntax) ** 指派給新版本意圖的版本編號。類型：字串長度限制：長度下限為 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 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/CreateIntentVersion) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/CreateIntentVersion) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/CreateIntentVersion) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/CreateIntentVersion) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/CreateIntentVersion) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/CreateIntentVersion) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/CreateIntentVersion) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/CreateIntentVersion) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/CreateIntentVersion) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/CreateIntentVersion)