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
조치를 수행할 권한이 요구됩니다.
Request Syntax
POST /intents/name
/versions HTTP/1.1
Content-type: application/json
{
"checksum": "string
"
}
URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
- name
-
새 버전을 생성하려는 봇의 버전. 이름은 대/소문자를 구분합니다.
길이 제약: 최소 길이는 1. 최대 길이는 100.
패턴:
^([A-Za-z]_?)+$
필수 사항 여부: Yes
요청 본문
요청은 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
-
Amazon Lex가 사용자와의 대화에서 의도를 선택하기 위해 활성화되어야 하는 컨텍스트를 목록화하는
InputContext
객체 배열입니다.유형: 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개. 최대 항목 수 1,500개.
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 200입니다.
- slots
-
의도를 충족하는 데 필요한 정보를 정의하는 다양한 슬롯 유형.
유형: Slot객체 어레이
어레이 멤버: 최소 항목 수 0개. 최대 항목 수는 100개.
- version
-
새 버전의 의도에 할당된 버전 번호입니다.
유형: 문자열
길이 제한: 최소 길이는 1. 최대 길이는 64.
패턴:
\$LATEST|[0-9]+
Errors
- BadRequestException
-
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.
HTTP 상태 코드: 400
- ConflictException
-
요청을 처리하는 동안 충돌이 발생했습니다. 다시 요청해 보세요.
HTTP 상태 코드: 409
- InternalFailureException
-
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.
HTTP 상태 코드: 500
- LimitExceededException
-
요청이 한도를 초과했습니다. 다시 요청해 보세요.
HTTP 상태 코드: 429
- NotFoundException
-
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.
HTTP 상태 코드: 404
- PreconditionFailedException
-
변경하려는 리소스의 체크섬이 요청의 체크섬과 일치하지 않습니다. 리소스의 체크섬을 확인한 후 다시 시도하세요.
HTTP 상태 코드: 412
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.