如果您使用的是 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 的更多信息,请参阅以下内容: