지원 종료 공지: 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 파라미터를 사용합니다.
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