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

意图的创建日期。

类型:时间戳

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

意图的更新日期。

类型:时间戳

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 的更多信息,请参阅以下内容: