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

建立意圖的日期。

類型:Timestamp

description

意圖的描述。

類型:字串

長度限制:長度下限為 0。長度上限為 200。

dialogCodeHook

如果已定義,Amazon Lex 會針對每個使用者輸入叫用此 Lambda 函數。

類型:CodeHook 物件

followUpPrompt

如果已定義,Amazon Lex 會在完成意圖後使用此提示來徵求其他使用者活動。

類型:FollowUpPrompt 物件

fulfillmentActivity

描述如何實現意圖。

類型:FulfillmentActivity 物件

inputContexts

InputContext物件陣列,列出 Amazon Lex 必須處於作用中狀態的內容,才能在與使用者交談中選擇意圖。

類型:InputContext 物件陣列

陣列成員:項目數下限為 0。項目數上限為 5。

kendraConfiguration

用於將 Amazon Kendra 索引與AMAZON.KendraSearchIntent意圖連接的組態資訊 (如果有的話)。

類型:KendraConfiguration 物件

lastUpdatedDate

更新意圖的日期。

類型:Timestamp

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 SDK 中使用此 API 的詳細資訊,請參閱下列內容: