GetIntent - Amazon Lex V1

지원 종료 공지: 2025년 9월 15 AWS 일에는 Amazon Lex V1에 대한 지원을 중단합니다. 2025년 9월 15일 이후에는 Amazon Lex V1 콘솔 또는 Amazon Lex V1 리소스에 더 이상 액세스할 수 없습니다. Amazon Lex V2를 사용하는 경우 대신 Amazon Lex V2 가이드를 참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

GetIntent

의도에 대한 정보를 반환합니다. 의도 이름 뿐만 아니라 의도 버전 또한 지정해야 합니다.

이 작업에는 lex:GetIntent 조치를 수행할 권한이 요구됩니다.

Request Syntax

GET /intents/name/versions/version HTTP/1.1

URI 요청 파라미터

요청은 다음 URI 파라미터를 사용합니다.

name

의도의 이름. 이름은 대/소문자를 구분합니다.

길이 제약: 최소 길이는 1. 최대 길이는 100.

Pattern: ^([A-Za-z]_?)+$

필수 여부: 예

version

의도의 버전.

길이 제한: 최소 길이는 1. 최대 길이는 64.

Pattern: \$LATEST|[0-9]+

필수 여부: 예

Request Body

해당 요청에는 본문이 없습니다.

Response Syntax

HTTP/1.1 200 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 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

checksum

의도의 체크섬입니다.

유형: 문자열

conclusionStatement

fulfillmentActivity 요소에 지정된 Lambda 함수가 의도를 이행한 후, Amazon Lex는 이 명령문을 사용자에게 전달합니다.

유형: Statement 객체

confirmationPrompt

봇에 정의된 경우 Amazon Lex는 사용자의 요청을 이행하기 전에 의도를 확인하기 위해 프롬프르틑 사용합니다. 자세한 내용은 PutIntent을 참조하세요.

유형: Prompt 객체

createdDate

의도가 생성된 날짜입니다.

유형: 타임스탬프

description

의도에 대한 설명.

유형: 문자열

길이 제한: 최소 길이는 0. 최대 길이는 200.

dialogCodeHook

봇이 정의된 경우 Amazon Lex는 각 사용자 입력에 대해 이 Lambda 함수를 호출합니다. 자세한 내용은 PutIntent 단원을 참조하십시오.

유형: CodeHook 객체

followUpPrompt

의도에 정의된 경우 Amazon Lex는 이 프롬프트를 사용하여 의도가 충족된 후 추가 사용자 활동을 요청합니다. 자세한 내용은 PutIntent 단원을 참조하십시오.

유형: FollowUpPrompt 객체

fulfillmentActivity

의도가 이행되는 방식을 설명합니다. 자세한 내용은 PutIntent 단원을 참조하십시오.

유형: FulfillmentActivity 객체

inputContexts

Amazon Lex가 사용자와의 대화에서 의도를 선택하기 위해 활성화되어야 하는 컨텍스트를 목록화하는 InputContext 객체 배열입니다.

유형: InputContext객체 어레이

배열 멤버: 최소 항목 수 0개. 최대 항목 수는 5개.

kendraConfiguration

Amazon Kendra 인덱스를 AMAZON.KendraSearchIntent 의도와 연결하기 위한 구성 정보(있는 경우)입니다.

유형: KendraConfiguration 객체

lastUpdatedDate

의도가 업데이트된 날짜. 리소스를 생성할 때 생성 날짜 및 최종 업데이트 날짜가 동일합니다.

유형: 타임스탬프

name

의도의 이름.

유형: 문자열

길이 제약: 최소 길이는 1. 최대 길이는 100.

Pattern: ^([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

InternalFailureException

내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.

HTTP 상태 코드: 500

LimitExceededException

요청이 한도를 초과했습니다. 다시 요청해 보세요.

HTTP 상태 코드: 429

NotFoundException

요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.

HTTP 상태 코드: 404

참고

언어별 AWS SDKs