支援終止通知：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)。本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # CreateBotVersion 根據版本建立新的機器人`$LATEST`版本。如果自您建立最後一個`$LATEST`版本以來，此資源的版本尚未變更，Amazon Lex 不會建立新的版本。它會傳回上次建立的版本。 **注意** 您只能更新機器人的`$LATEST`版本。您無法更新使用 `CreateBotVersion`操作建立的編號版本。當您建立機器人的第一個版本時，Amazon Lex 會將版本設定為 1。後續版本會累加 1。如需詳細資訊，請參閱[版本控制](versioning-aliases.md#versioning-intro)。這項操作需要 `lex:CreateBotVersion` 動作的許可。 ## 請求語法 ``` POST /bots/name/versions HTTP/1.1 Content-type: application/json { "checksum": "string" } ``` ## URI 請求參數請求會使用下列 URI 參數。 ** [name](#API_CreateBotVersion_RequestSyntax) ** 您要建立新版本之機器人的名稱。名稱區分大小寫。長度限制：長度下限為 2。長度上限為 50。模式：`^([A-Za-z]_?)+$` 必要：是 ## 請求主體請求接受採用 JSON 格式的下列資料。 ** [checksum](#API_CreateBotVersion_RequestSyntax) ** 識別機器人`$LATEST`版本的特定修訂。如果您指定檢查總和，且機器人的`$LATEST`版本具有不同的檢查總和，則會傳回`PreconditionFailedException`例外狀況，且 Amazon Lex 不會發佈新版本。如果您未指定檢查總和，Amazon Lex 會發佈 `$LATEST`版本。類型：字串必要：否 ## 回應語法 ``` HTTP/1.1 201 Content-type: application/json { "abortStatement": { "messages": [ { "content": "string", "contentType": "string", "groupNumber": number } ], "responseCard": "string" }, "checksum": "string", "childDirected": boolean, "clarificationPrompt": { "maxAttempts": number, "messages": [ { "content": "string", "contentType": "string", "groupNumber": number } ], "responseCard": "string" }, "createdDate": number, "description": "string", "detectSentiment": boolean, "enableModelImprovements": boolean, "failureReason": "string", "idleSessionTTLInSeconds": number, "intents": [ { "intentName": "string", "intentVersion": "string" } ], "lastUpdatedDate": number, "locale": "string", "name": "string", "status": "string", "version": "string", "voiceId": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 201 回應。服務會傳回下列 JSON 格式的資料。 ** [abortStatement](#API_CreateBotVersion_ResponseSyntax) ** Amazon Lex 用來取消對話的訊息。如需詳細資訊，請參閱[PutBot](API_PutBot.md)。類型：[Statement](API_Statement.md) 物件 ** [checksum](#API_CreateBotVersion_ResponseSyntax) ** 識別已建立之機器人版本的檢查總和。類型：字串 ** [childDirected](#API_CreateBotVersion_ResponseSyntax) ** 對於使用 Amazon Lex Model Building Service 建立的每個 Amazon Lex 機器人，您必須指定您對 Amazon Lex 的使用是否與網站、程式或其他應用程式相關，而該網站、程式或其他應用程式全部或部分針對 13 以下兒童，並在 `false` `childDirected` 欄位中指定 `true` 或以遵守兒童線上隱私權保護法 (COPPA)。透過`true`在 `childDirected` 欄位中指定，您確認使用 Amazon Lex **與**網站、程式或其他應用程式相關，而該網站、程式或其他應用程式全部或部分以 13 以下兒童為目標，且受到 COPPA 的約束。透過`false`在 `childDirected` 欄位中指定，您確認 Amazon Lex 的使用與網站、程式或其他應用程式**無關**，而該網站、程式或其他應用程式全部或部分針對 13 以下且受 COPPA 約束的兒童。您無法為 `childDirected` 欄位指定預設值，該值無法準確反映您對 Amazon Lex 的使用是否與網站、程式或其他應用程式相關，而該網站、程式或其他應用程式是針對或部分針對未滿 13 歲且受 COPPA 規範的 13 歲兒童。如果您使用 Amazon Lex 與網站、程式或其他應用程式有關，而該網站、程式或其他應用程式全部或部分導向至未滿 13 歲的孩童，則您必須根據 COPPA 取得任何必要的可驗證父系同意。如需將 Amazon Lex 與網站、程式或其他應用程式搭配使用的相關資訊，而這些網站、程式或其他應用程式全部或部分針對未滿 13 歲的孩童，請參閱 [Amazon Lex 常見問答集。](https://aws.amazon.com/lex/faqs#data-security) 類型：布林值 ** [clarificationPrompt](#API_CreateBotVersion_ResponseSyntax) ** Amazon Lex 在不了解使用者請求時使用的訊息。如需詳細資訊，請參閱[PutBot](API_PutBot.md)。類型：[Prompt](API_Prompt.md) 物件 ** [createdDate](#API_CreateBotVersion_ResponseSyntax) ** 建立機器人版本的日期。類型：Timestamp ** [description](#API_CreateBotVersion_ResponseSyntax) ** 機器人的描述。類型：字串長度限制：長度下限為 0。長度上限為 200。 ** [detectSentiment](#API_CreateBotVersion_ResponseSyntax) ** 指出使用者輸入的表達用語是否應傳送至 Amazon Comprehend 進行情緒分析。類型：布林值 ** [enableModelImprovements](#API_CreateBotVersion_ResponseSyntax) ** 指出機器人是否使用準確性改進。 `true` 指出機器人正在使用改進，否則是 `false`。類型：布林值 ** [failureReason](#API_CreateBotVersion_ResponseSyntax) ** 如果 `status`是 `FAILED`，Amazon Lex 會提供無法建置機器人的原因。類型：字串 ** [idleSessionTTLInSeconds](#API_CreateBotVersion_ResponseSyntax) ** Amazon Lex 保留對話中所收集資料的秒數上限。如需詳細資訊，請參閱[PutBot](API_PutBot.md)。類型：整數有效範圍：最小值為 60。最大值為 86400。 ** [intents](#API_CreateBotVersion_ResponseSyntax) ** `Intent` 物件的陣列。如需詳細資訊，請參閱[PutBot](API_PutBot.md)。類型：[Intent](API_Intent.md) 物件陣列 ** [lastUpdatedDate](#API_CreateBotVersion_ResponseSyntax) ** 此機器人`$LATEST`版本更新的日期。類型：Timestamp ** [locale](#API_CreateBotVersion_ResponseSyntax) ** 指定機器人的目標地區設定。類型：字串有效值:`de-DE | en-AU | en-GB | en-IN | en-US | es-419 | es-ES | es-US | fr-FR | fr-CA | it-IT | ja-JP | ko-KR` ** [name](#API_CreateBotVersion_ResponseSyntax) ** 機器人的名稱。類型：字串長度限制：長度下限為 2。長度上限為 50。模式：`^([A-Za-z]_?)+$` ** [status](#API_CreateBotVersion_ResponseSyntax) ** 當您傳送建立或更新機器人的請求時，Amazon Lex 會將`status`回應元素設定為 `BUILDING`。Amazon Lex 建置機器人後，會將 `status`設定為 `READY`。如果 Amazon Lex 無法建置機器人，則會將 `status`設定為 `FAILED`。Amazon Lex 會在`failureReason`回應元素中傳回失敗的原因。類型：字串有效值:`BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT` ** [version](#API_CreateBotVersion_ResponseSyntax) ** 機器人的版本。類型：字串長度限制：長度下限為 1。長度上限為 64。模式：`\$LATEST|[0-9]+` ** [voiceId](#API_CreateBotVersion_ResponseSyntax) ** Amazon Lex 用來與使用者進行語音互動的 Amazon Polly 語音 ID。類型：字串 ## 錯誤 ** 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/CreateBotVersion) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/CreateBotVersion) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/CreateBotVersion) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/CreateBotVersion) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/CreateBotVersion) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/CreateBotVersion) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/CreateBotVersion) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/CreateBotVersion) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/CreateBotVersion) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/CreateBotVersion)