如果您使用的是 Amazon Lex V2，請改參閱 Amazon Lex V2 指南。
如果您使用的是 Amazon Lex V1，建議您將機器人升級至 Amazon Lex V2。我們不再將新功能新增至 V1，強烈建議所有新機器人都使用 V2。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
CreateBotVersion
根據版本創建一個新版$LATEST本的機器人。如果自建立上一個$LATEST版本後，此資源的版本並未變更，Amazon Lex 不會建立新版本。它返回上次創建的版本。
注意
您只能更新機器人的$LATEST版本。您無法更新使用CreateBotVersion作業建立的編號版本。
當您建立機器人的第一個版本時，Amazon Lex 會將版本設定為 1。後續版本會累加 1。如需詳細資訊，請參閱 版本控制。
這項操作需要 lex:CreateBotVersion 動作的許可。
請求語法
POST /bots/name/versions HTTP/1.1
Content-type: application/json
{
"checksum": "string"
}URI 請求參數
請求會使用下列 URI 參數。
- name
-
您要建立新版本的機器人名稱。名稱區分大小寫。
長度約束：最小長度為 2。長度上限為 50。
模式：
^([A-Za-z]_?)+$必要：是
請求主體
請求接受採用 JSON 格式的下列資料。
- checksum
-
識別機器人
$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
-
Amazon Lex 用來取消對話的訊息。如需詳細資訊，請參閱 PutBot。
類型：Statement 物件
- checksum
-
識別所建立機器人版本的總和檢查碼。
類型：字串
- childDirected
-
對於使用 Amazon Lex 模型建置服務建立的每個 Amazon Lex 機器人，您必須在
childDirected欄位中指定或全部或部分針對 13 歲以下兒童並遵守《兒童線上隱私保護法》(COPPA) 的網站、程式或其他應用程式是否與全部或部分導向或鎖定目標的網站、程式true或其他應用程false式相關。透過true在childDirected欄位中指定，即表示您確認您對 Amazon Lex 的使用與針對 13 歲以下兒童且受 COPPA 規範的全部或部分針對網站、程式或其他應用程式有關。透過false在childDirected欄位中指定，即表示您確認您對 Amazon Lex 的使用與針對 13 歲以下兒童且受 COPPA 規範的全部或部分針對網站、程式或其他應用程式無關。您不得為欄位指定預設值，該childDirected欄位無法準確反映您對 Amazon Lex 的使用情況是否與針對 13 歲以下兒童的網站、程式或其他應用程式全部或部分針對 13 歲以下且受 COPPA 規限的網站、程式或其他應用程式有關。如果您對 Amazon Lex 的使用涉及全部或部分針對 13 歲以下兒童的網站、程式或其他應用程式，您必須根據 COPPA 取得任何必要的可驗證父母同意。如需針對全部或部分針對 13 歲以下兒童的網站、程式或其他應用程式使用 Amazon Lex 的相關資訊，請參閱 Amazon Lex 常見問題集。
類型：布林值
- clarificationPrompt
-
Amazon Lex 在不了解使用者要求時所使用的訊息。如需詳細資訊，請參閱 PutBot。
類型：Prompt 物件
- createdDate
-
建立機器人版本的日期。
類型：Timestamp
- description
-
機器人的描述。
類型：字串
長度限制：長度下限為 0。長度上限為 200。
- detectSentiment
-
指出是否應將使用者輸入的語音傳送至 Amazon Comprehend 進行情緒分析。
類型：布林值
- enableModelImprovements
-
指出機器人是否使用精確度改進。
true表示機器人正在使用改進，否則，false。類型：布林值
- failureReason
-
如果
status是FAILED，Amazon Lex 會提供無法建置機器人的原因。類型：字串
- idleSessionTTLInSeconds
-
Amazon Lex 保留交談中收集之資料的時間上限 (以秒為單位)。如需詳細資訊，請參閱 PutBot。
類型：整數
有效範圍：最小值為 60。最大值為 86400。
- intents
-
Intent物件的陣列。如需詳細資訊，請參閱 PutBot。類型：Intent 物件陣列
- lastUpdatedDate
-
更新此機器人
$LATEST版本的日期。類型：Timestamp
- locale
-
指定機器人的目標地區設定。
類型：字串
有效值:
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
-
機器人的名稱。
類型：字串
長度約束：最小長度為 2。長度上限為 50。
模式：
^([A-Za-z]_?)+$ - status
-
當您傳送建立或更新機器人的請求時，Amazon Lex 會將
status回應元素設定為BUILDING。在 Amazon Lex 建置機器人之後，它就會設定status為READY。如果 Amazon Lex 無法建置機器人，它就會設定status為FAILED。Amazon Lex 返回failureReason響應元素失敗的原因。類型：字串
有效值:
BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT - version
-
機器人的版本。
類型：字串
長度限制：長度下限為 1。長度上限為 64。
模式：
\$LATEST|[0-9]+ - voiceId
-
亞馬遜 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 SDK 中使用此 API 的詳細資訊，請參閱下列內容：
