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 조치를 수행할 권한이 요구됩니다.

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를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.