지원 종료 공지: 2025년 9월 15 AWS 일에는 Amazon Lex V1에 대한 지원을 중단할 예정입니다. 2025년 9월 15일 이후에는 Amazon Lex V1 콘솔 또는 Amazon Lex V1 리소스에 더 이상 액세스할 수 없습니다. Amazon Lex V2를 사용하는 경우 대신 [Amazon Lex V2 가이드를](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html) 참조하세요. 기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # PostContent Amazon Lex에 사용자 입력(텍스트 또는 스피치)을 전송합니다. 클라이언트는 이 API를 사용하여 런타임에 Amazon Lex에 텍스트 및 오디오 요청을 보냅니다. Amazon Lex는 봇용으로 구축한 기계 학습 모델을 사용하여 사용자 입력을 해석합니다. `PostContent` 작업은 8kHz 및 16kHz에서 오디오 입력을 지원합니다. 전화 오디오 애플리케이션에서 8kHz 오디오를 사용하여 음성 인식 정확도를 높일 수 있습니다. 이에 대한 응답으로 Amazon Lex는 사용자에게 전달할 다음 메시지를 반환합니다. 다음 예제를 검토하십시오. + 사용자가 "피자를 먹고 싶어요"라고 입력하면 Amazon Lex는 슬롯 데이터(예: `PizzaSize`: "어떤 피자 크기를 원하시나요?")를 유도하는 메시지가 포함된 응답을 반환할 수 있습니다. + 사용자가 모든 피자 주문 정보를 제공한 후 Amazon Lex는 "피자를 주문하시겠습니까?"라는 사용자 확인 메시지가 포함된 응답을 반환할 수 있습니다. + 사용자가 확인 메시지에 "예"라고 응답하면 Amazon Lex에서 "감사합니다. 치즈 피자를 주문했습니다."라는 결론을 반환할 수 있습니다. 모든 Amazon Lex 메시지에 사용자의 응답이 필요한 것은 아닙니다. 예를 들어, 결론문에는 응답이 필요하지 않습니다. 일부 메시지에는 예 또는 아니오 응답만 필요합니다. Amazon Lex는 `message` 외에도 적절한 클라이언트 사용자 인터페이스를 표시하는 등 클라이언트 동작을 개선하는 데 사용할 수 있는 메시지에 대한 추가 컨텍스트를 제공합니다. 다음 예제를 살펴보세요. + 메시지가 슬롯 데이터를 끌어내라는 것이면 Amazon Lex는 다음 컨텍스트 정보를 반환합니다. + `x-amz-lex-dialog-state` 헤더는 `ElicitSlot`로 설정되었습니다. + `x-amz-lex-intent-name` 현재 컨텍스트의 의도 이름으로 설정된 헤더 + `x-amz-lex-slot-to-elicit` 헤더는 `message`가 정보를 이끌어내는 슬롯 이름으로 설정됩니다. + `x-amz-lex-slots` 헤더는 현재 값을 사용하여 의도에 맞게 구성된 슬롯의 맵으로 설정됩니다. + 메시지가 확인 프롬프트인 경우 `x-amz-lex-dialog-state` 헤더는 `Confirmation`로 설정되고 `x-amz-lex-slot-to-elicit` 헤더는 생략됩니다. + 메시지가 의도에 맞게 구성된 설명 프롬프트로서 사용자 의도를 이해할 수 없음을 나타내는 경우 `x-amz-dialog-state`헤더는 `ElicitIntent`로 설정되고 `x-amz-slot-to-elicit` 헤더는 생략됩니다. 또한 Amazon Lex는 애플리케이션별 `sessionAttributes` 정보도 반환합니다. 자세한 내용은 [대화 컨텍스트 관리](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html)를 참조하십시오. ## Request Syntax ``` POST /bot/botName/alias/botAlias/user/userId/content HTTP/1.1 x-amz-lex-session-attributes: sessionAttributes x-amz-lex-request-attributes: requestAttributes Content-Type: contentType Accept: accept x-amz-lex-active-contexts: activeContexts inputStream ``` ## URI 요청 파라미터 요청은 다음 URI 파라미터를 사용합니다. ** [accept](#API_runtime_PostContent_RequestSyntax) ** 이것은 `Accept` HTTP 헤더의 값으로 전달됩니다. Amazon Lex가 응답에서 반환하는 메시지는 요청의 `Accept` HTTP 헤더 값을 기반으로 하는 텍스트 또는 음성일 수 있습니다. + 값이 `text/plain; charset=utf-8`인 경우 Amazon Lex는 응답에서 텍스트를 반환합니다. + 값이 `audio/`로 시작하는 경우 Amazon Lex는 응답으로 음성을 반환합니다. Amazon Lex는 Amazon Polly를 사용하여 음성을 생성합니다 (`Accept` 헤더에 지정한 구성 사용). 예를 들어 값을 `audio/mpeg`로 지정하면 Amazon Lex는 음성을 MPEG 형식으로 반환합니다. + 값이 `audio/pcm`인 경우 반환되는 음성은 16비트 리틀 엔디안 형식의 `audio/pcm`입니다. + 허용되는 값은 다음과 같습니다. + 오디오/mpeg + 오디오/ogg + 오디오/pcm + 텍스트/플레인, 문자셋=utf-8 + audio/\$1 (기본값은 mpeg) ** [activeContexts](#API_runtime_PostContent_RequestSyntax) ** 요청에 대해 활성화된 컨텍스트 목록. 이전 의도가 이행될 때 또는 요청에 컨텍스트를 포함시켜 컨텍스트를 활성화할 수 있습니다. 컨텍스트 목록을 지정하지 않으면 Amazon Lex는 세션의 현재 컨텍스트 목록을 사용합니다. 빈 목록을 지정하면 세션의 모든 컨텍스트가 지워집니다. ** [botAlias](#API_runtime_PostContent_RequestSyntax) ** Amazon Lex 봇의 별칭 필수 항목 여부: 예 ** [botName](#API_runtime_PostContent_RequestSyntax) ** Amazon Lex 봇의 이름. 필수 항목 여부: 예 ** [contentType](#API_runtime_PostContent_RequestSyntax) ** 이것은 `Content-Type` HTTP 헤더의 값으로 전달됩니다. 오디오 형식 또는 텍스트를 나타냅니다. 헤더 값은 다음 접두사 중 하나로 시작해야 합니다. + PCM 형식의 오디오 데이터는 리틀 엔디안 바이트 순서여야 합니다. + 오디오/l16, 속도=16000, 채널=1 + 오디오/x-l16, 샘플-레이트=16000, 채널-수=1 + 오디오/lpcm, 샘플-레이트=8000, 샘플-크기-비트=16, 채널-수=1, is-big-endian=거짓 + Opus 포맷 + 오디오/x-cbr-opus-with 프리앰블, 프리앰블-크기=0, 비트-레이트=256000, 프레임-크기-밀리초=4 + 날짜 형식 + 텍스트/플레인, 문자셋=utf-8 필수 항목 여부: 예 ** [requestAttributes](#API_runtime_PostContent_RequestSyntax) ** 이것은 `x-amz-lex-request-attributes` HTTP 헤더의 값으로 전달됩니다. Amazon Lex와 클라이언트 애플리케이션 간에 전달되는 요청별 정보. 값은 문자열 키와 값이 있는 JSON으로 직렬화되고 base64로 인코딩된 맵이어야 합니다. `requestAttributes` 및 `sessionAttributes` 헤더의 총 크기는 12KB로 제한됩니다. 네임스페이스 `x-amz-lex:`는 특수 속성용으로 남겨둡니다. 접두사 `x-amz-lex:`를 사용하여 요청 속성을 생성하지 마세요. 요청 속성에 대한 자세한 내용은 [요청 속성 설정](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-request-attribs)을 참조하십시오. ** [sessionAttributes](#API_runtime_PostContent_RequestSyntax) ** 이것은 `x-amz-lex-session-attributes` HTTP 헤더의 값으로 전달됩니다. Amazon Lex와 클라이언트 애플리케이션 간에 전달되는 요청별 정보. 값은 문자열 키와 값이 있는 JSON으로 직렬화되고 base64로 인코딩된 맵이어야 합니다. `sessionAttributes` 및 `requestAttributes` 헤더의 총 크기는 12KB로 제한됩니다. 요청 속성에 대한 자세한 내용은 [요청 속성 설정](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-session-attribs)을 참조하십시오. ** [userId](#API_runtime_PostContent_RequestSyntax) ** 클라이언트 애플리케이션 사용자의 ID입니다. Amazon Lex는 이를 사용하여 사용자와 봇의 대화를 식별합니다. 런타임 시 각 요청에는 `userID` 필드가 포함되어야 합니다. 애플리케이션에 사용할 사용자 ID를 결정하려면 다음 요소를 고려하십시오. + `userID` 필드에는 사용자의 개인 식별 정보 (예: 이름, 개인 식별 번호 또는 기타 최종 사용자 개인 정보)가 포함되어서는 안 됩니다. + 사용자가 한 기기에서 대화를 시작하고 다른 기기에서 계속하도록 하려면 사용자별 식별자를 사용하세요. + 동일한 사용자가 서로 다른 두 기기에서 독립적인 대화를 두 번 할 수 있게 하려면 기기별 식별자를 선택하세요. + 사용자는 같은 봇의 서로 다른 두 가지 버전과 독립적인 대화를 두 번 할 수 없습니다. 예를 들어 사용자는 동일한 봇의 PROD 및 BETA 버전과 대화할 수 없습니다. 예를 들어 테스트 중에 사용자가 서로 다른 두 버전과 대화해야 할 것으로 예상되는 경우 사용자 ID에 봇 별칭을 포함하여 두 대화를 구분하십시오. 길이 제약: 최소 길이는 2. 최대 길이는 100. 패턴: `[0-9a-zA-Z._:-]+` 필수 여부: 예 ## 요청 본문 요청은 다음의 이진 데이터를 허용합니다. ** [inputStream](#API_runtime_PostContent_RequestSyntax) ** `Content-Type` HTTP 헤더에 설명된 대로 PCM 또는 Opus 오디오 형식 또는 텍스트 형식의 사용자 입력입니다. 오디오 데이터를 Amazon Lex로 스트리밍하거나 오디오 데이터를 전송하기 전에 모든 오디오 데이터를 캡처하는 로컬 버퍼를 생성할 수 있습니다. 일반적으로 로컬에서 데이터를 버퍼링하는 대신 오디오 데이터를 스트리밍하면 성능이 향상됩니다. 필수 사항 여부: 예 ## 응답 구문 ``` HTTP/1.1 200 Content-Type: contentType x-amz-lex-intent-name: intentName x-amz-lex-nlu-intent-confidence: nluIntentConfidence x-amz-lex-alternative-intents: alternativeIntents x-amz-lex-slots: slots x-amz-lex-session-attributes: sessionAttributes x-amz-lex-sentiment: sentimentResponse x-amz-lex-message: message x-amz-lex-encoded-message: encodedMessage x-amz-lex-message-format: messageFormat x-amz-lex-dialog-state: dialogState x-amz-lex-slot-to-elicit: slotToElicit x-amz-lex-input-transcript: inputTranscript x-amz-lex-encoded-input-transcript: encodedInputTranscript x-amz-lex-bot-version: botVersion x-amz-lex-session-id: sessionId x-amz-lex-active-contexts: activeContexts audioStream ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 응답에 다음 HTTP 헤더가 반환됩니다. ** [activeContexts](#API_runtime_PostContent_ResponseSyntax) ** 세션에 대해 활성화된 컨텍스트 목록. 의도가 이행될 때 또는 `PostContent`, `PostText`, 또는 `PutSession` 작업을 호출하여 컨텍스트를 설정할 수 있습니다. 컨텍스트를 사용하여 의도를 추적할 수 있는 의도를 제어하거나 애플리케이션 작업을 수정할 수 있습니다. ** [alternativeIntents](#API_runtime_PostContent_ResponseSyntax) ** 사용자의 의도에 적용할 수 있는 1\$14개의 대체 의도. 각 대안에는 Amazon Lex가 의도가 사용자의 의도와 일치한다고 얼마나 확신하는 지를 나타내는 점수가 포함되어 있습니다. 의도는 신뢰도 점수를 기준으로 정렬됩니다. ** [botVersion](#API_runtime_PostContent_ResponseSyntax) ** 대화에 응답한 봇의 버전입니다. 이 정보를 사용하여 한 버전의 봇이 다른 버전보다 성능이 좋은지 확인할 수 있습니다. 길이 제약: 최소 길이는 1. 최대 길이는 64. 패턴: `[0-9]+|\$LATEST` ** [contentType](#API_runtime_PostContent_ResponseSyntax) ** 요청의 `Accept` HTTP 헤더에 지정된 콘텐츠 유형입니다. ** [dialogState](#API_runtime_PostContent_ResponseSyntax) ** 사용자 상호 작용의 현재 상태를 식별합니다. Amazon Lex는 다음 값 중 하나를 `dialogState`로 반환합니다. 클라이언트는 선택적으로 이 정보를 사용하여 사용자 인터페이스를 사용자 정의할 수 있습니다. + `ElicitIntent` - Amazon Lex는 사용자의 의도를 이끌어내고자 합니다. 다음 예제를 살펴보세요. 예를 들어, 사용자가 의도 ("피자를 주문하고 싶어요")를 말할 수 있습니다. Amazon Lex가 이 발언에서 사용자 의도를 유추할 수 없는 경우 이 대화상자 상태를 반환합니다. + `ConfirmIntent` - Amazon Lex는 "예" 또는 "아니요"라는 응답을 기대하고 있습니다. 예를 들어 Amazon Lex는 의도를 이행하기 전에 사용자 확인을 원합니다. 사용자는 단순한 "예" 또는 "아니요" 응답 대신 추가 정보로 응답할 수 있습니다. 예를 들어 "네, 하지만 두꺼운 크러스트 피자로 만드세요" 또는 "아니요, 음료를 주문하고 싶어요." Amazon Lex는 이러한 추가 정보를 처리할 수 있습니다(이 예시에서는 크러스트 유형 슬롯을 업데이트하거나 의도를 OrderPizza에서 OrderDrink로 변경). + `ElicitSlot` - Amazon Lex는 현재 의도에 사용할 슬롯의 값을 예상하고 있습니다. 예를 들어 Amazon Lex가 응답에서 "어떤 크기의 피자를 원하시나요?" 라는 메시지를 보낸다고 가정해 보겠습니다. 사용자가 슬롯 값(예: "중간")으로 응답할 수 있습니다. 사용자는 응답 시 추가 정보(예: "중간 두께의 크러스트 피자") 를 제공할 수도 있습니다. Amazon Lex는 이러한 추가 정보를 적절하게 처리할 수 있습니다. + `Fulfilled` - Lambda 함수가 의도를 성공적으로 수행했음을 전달합니다. + `ReadyForFulfillment` - 클라이언트가 요청을 이행해야 함을 전달합니다. + `Failed` - 사용자와의 대화가 실패했음을 전달합니다. 이는 사용자가 서비스의 프롬프트에 적절한 응답을 제공하지 않는 경우(Amazon Lex가 사용자에게 특정 정보를 요청할 수 있는 횟수를 구성할 수 있음) 또는 Lambda 함수가 의도를 이행하지 못하는 경우를 포함하여 다양한 이유로 발생할 수 있습니다. 유효한 값: `ElicitIntent | ConfirmIntent | ElicitSlot | Fulfilled | ReadyForFulfillment | Failed` ** [encodedInputTranscript](#API_runtime_PostContent_ResponseSyntax) ** 요청을 처리하는 데 사용되는 텍스트입니다. 입력이 오디오 스트림인 경우 `encodedInputTranscript` 필드에는 오디오 스트림에서 추출한 텍스트가 포함됩니다. 이 텍스트는 의도 및 슬롯 값을 인식하기 위해 실제로 처리되는 텍스트입니다. 이 정보를 사용하여 Amazon Lex가 전송되는 오디오를 올바르게 처리하고 있는지 확인할 수 있습니다. `encodedInputTranscript` 필드는 base-64로 인코딩됩니다. 값을 사용하려면 먼저 필드를 디코딩해야 합니다. ** [encodedMessage](#API_runtime_PostContent_ResponseSyntax) ** 사용자에게 전달하는 메시지입니다. 메시지는 봇의 구성 또는 Lambda 함수에서 올 수 있습니다. 의도가 Lambda 함수로 구성되지 않았거나 Lambda 함수가 응답으로 `Delegate`을 `dialogAction.type`로 반환하는 경우, Amazon Lex는 다음 액션 코스를 결정하고 현재 상호 작용 컨텍스트를 기반으로 봇의 구성에서 적절한 메시지를 선택합니다. 예를 들어 Amazon Lex가 사용자 입력을 이해할 수 없는 경우 설명 프롬프트 메시지를 사용합니다. 의도를 생성하면 그룹에 메시지를 할당할 수 있습니다. 메시지가 그룹에 할당되면 Amazon Lex는 응답의 각 그룹에서 메시지를 하나씩 반환합니다. 메시지 필드는 메시지가 포함된 이스케이프된 JSON 문자열입니다. 반환된 JSON 문자열의 구조에 대한 자세한 내용은 [지원되는 메시지 형식](howitworks-manage-prompts.md#msg-prompts-formats)을 참조하세요. Lambda 함수가 메시지를 반환하면 Amazon Lex는 응답으로 이를 클라이언트에 전달합니다. `encodedMessage` 필드는 base-64로 인코딩됩니다. 값을 사용하려면 먼저 필드를 디코딩해야 합니다. 길이 제약: 최소 길이는 1. 최대 길이는 1,366입니다. ** [inputTranscript](#API_runtime_PostContent_ResponseSyntax) ** *이 헤더는 더 이상 사용되지 않습니다.* 요청을 처리하는 데 사용되는 텍스트입니다. 이 필드는 de-de, en-AU, en-GB, en-US, es-419, es-ES, es-US, fr-CA, fr-FR 및 it-IT 로캘에서만 사용할 수 있습니다. 다른 모든 로캘에서는 이 `inputTranscript` 필드가 null입니다. 대신에 `encodedInputTranscript` 필드를 사용해야 합니다. 입력이 오디오 스트림인 경우 `inputTranscript` 필드에는 오디오 스트림에서 추출한 텍스트가 포함됩니다. 이 텍스트는 의도 및 슬롯 값을 인식하기 위해 실제로 처리되는 텍스트입니다. 이 정보를 사용하여 Amazon Lex가 전송되는 오디오를 올바르게 처리하고 있는지 확인할 수 있습니다. ** [intentName](#API_runtime_PostContent_ResponseSyntax) ** Amazon Lex가 알고 있는 현재 사용자 의도를 나타냅니다. ** [message](#API_runtime_PostContent_ResponseSyntax) ** *이 헤더는 더 이상 사용되지 않습니다.* 이 필드는 de-de, en-AU, en-GB, en-US, es-419, es-ES, es-US, fr-CA, fr-FR 및 it-IT 로캘에서만 사용할 수 있습니다. 다른 모든 로캘에서는 이 `message` 필드가 null입니다. 대신에 `encodedMessage` 필드를 사용해야 합니다. 사용자에게 전달하는 메시지입니다. 메시지는 봇의 구성 또는 Lambda 함수에서 올 수 있습니다. 의도가 Lambda 함수로 구성되지 않았거나 Lambda 함수가 응답으로 `Delegate`을 `dialogAction.type`로 반환하는 경우, Amazon Lex는 다음 액션 코스를 결정하고 현재 상호 작용 컨텍스트를 기반으로 봇의 구성에서 적절한 메시지를 선택합니다. 예를 들어 Amazon Lex가 사용자 입력을 이해할 수 없는 경우 설명 프롬프트 메시지를 사용합니다. 의도를 생성하면 그룹에 메시지를 할당할 수 있습니다. 메시지가 그룹에 할당되면 Amazon Lex는 응답의 각 그룹에서 메시지를 하나씩 반환합니다. 메시지 필드는 메시지가 포함된 이스케이프된 JSON 문자열입니다. 반환된 JSON 문자열의 구조에 대한 자세한 내용은 [지원되는 메시지 형식](howitworks-manage-prompts.md#msg-prompts-formats)을 참조하세요. Lambda 함수가 메시지를 반환하면 Amazon Lex는 응답으로 이를 클라이언트에 전달합니다. 길이 제약: 최소 길이는 1. 최대 길이는 1,024. ** [messageFormat](#API_runtime_PostContent_ResponseSyntax) ** 응답 메시지의 형식. 다음 값 중 하나입니다. + `PlainText` - 메시지에 일반 UTF-8 텍스트가 포함됩니다. + `CustomPayload` - 메시지는 클라이언트의 사용자 지정 형식입니다. + `SSML` - 메시지에 음성 출력용으로 서식이 지정된 텍스트가 포함됩니다. + `Composite` - 메시지에는 의도 생성 시 메시지가 할당된 그룹의 메시지가 하나 이상 포함된 이스케이프된 JSON 개체가 포함되어 있습니다. 유효한 값: `PlainText | CustomPayload | SSML | Composite` ** [nluIntentConfidence](#API_runtime_PostContent_ResponseSyntax) ** Amazon Lex가 반환된 의도가 사용자의 의도와 일치한다고 얼마나 확신하는지 나타내는 점수를 제공합니다. 점수는 0.0\$11.0 사이입니다. 점수는 상대 점수이며 절대 점수가 아닙니다. 점수는 Amazon Lex의 개선 사항에 따라 변경될 수 있습니다. ** [sentimentResponse](#API_runtime_PostContent_ResponseSyntax) ** 감정이 하나의 표현으로 표현되었습니다. 봇이 감정 분석을 위해 Amazon Comprehend로 표현을 보내도록 구성된 경우 이 필드에 분석 결과가 포함됩니다. ** [sessionAttributes](#API_runtime_PostContent_ResponseSyntax) ** 세션별 컨텍스트 정보를 나타내는 키/값 페어의 맵입니다. ** [sessionId](#API_runtime_PostContent_ResponseSyntax) ** 세션의 고유 식별자입니다. ** [slots](#API_runtime_PostContent_ResponseSyntax) ** Amazon Lex가 대화 중 사용자 입력에서 감지한 0개 이상의 의도 슬롯(이름/값 페어) 맵입니다. 필드는 base-64로 인코딩됩니다. Amazon Lex는 슬롯에 대한 예상 값을 가진 해결 목록을 생성합니다. 반환되는 값은 슬롯 유형이 생성되거나 업데이트될 때 선택된 `valueSelectionStrategy`에 따라 결정됩니다. `valueSelectionStrategy`을 `ORIGINAL_VALUE`로 설정하면 사용자 값이 슬롯 값과 유사한 경우 사용자가 제공한 값이 반환됩니다. `valueSelectionStrategy`가 `TOP_RESOLUTION`로 설정된 경우, Amazon Lex는 해결 목록의 첫 번째 값을 반환하고, 해결 목록이 없는 경우 null을 반환합니다. `valueSelectionStrategy`를 지정하지 않으면 기본값은 `ORIGINAL_VALUE`입니다. ** [slotToElicit](#API_runtime_PostContent_ResponseSyntax) ** `dialogState`값이 `ElicitSlot`인 경우 Amazon Lex가 값을 추출하는 슬롯의 이름을 반환합니다. 응답은 다음 내용을 HTTP 본문으로 반환합니다. ** [audioStream](#API_runtime_PostContent_ResponseSyntax) ** 사용자에게 전달할 프롬프트(또는 명령문). 이는 봇 구성 및 컨텍스트를 기반으로 합니다. 예를 들어 Amazon Lex가 사용자 의도를 이해하지 못한 경우 봇을 위해 구성된 `clarificationPrompt`을 보냅니다. 이행 작업을 수행하기 전에 의도에서 확인이 필요한 경우 `confirmationPrompt`를 보냅니다. 또 다른 예: Lambda 함수가 의도를 성공적으로 수행하고 사용자에게 전달할 메시지를 보냈다고 가정해 보겠습니다. 그러면 Amazon Lex가 응답으로 해당 메시지를 보냅니다. ## 오류 ** BadGatewayException ** Amazon Lex 봇이 아직 구축 중이거나 종속 서비스 중 하나(Amazon Polly, AWS Lambda) 가 내부 서비스 오류로 인해 장애가 발생했습니다. HTTP 상태 코드: 502 ** BadRequestException ** 요청 검증이 실패했거나, 컨텍스트에 사용 가능한 메시지가 없거나, 봇 빌드가 실패했거나, 아직 진행 중이거나, 빌드되지 않은 변경 사항이 포함되어 있습니다. HTTP 상태 코드: 400 ** ConflictException ** 두 클라이언트가 동일한 AWS 계정, Amazon Lex 봇 및 사용자 ID를 사용하고 있습니다. HTTP 상태 코드: 409 ** DependencyFailedException ** AWS Lambda 또는 Amazon Polly와 같은 종속 서비스 중 하나에서 예외가 발생했습니다. 예를 들어, + Amazon Lex에 Lambda 함수를 호출할 수 있는 충분한 권한이 없는 경우. + Lambda 함수를 실행하는 데 30초 이상 걸리는 경우. + 이행 Lambda 함수가 슬롯 값을 제거하지 않고 `Delegate` 대화 작업을 반환하는 경우. HTTP 상태 코드: 424 ** InternalFailureException ** 내부 서비스 오류. 호출을 다시 시도하세요. HTTP 상태 코드: 500 ** LimitExceededException ** 제한 초과함. HTTP 상태 코드: 429 ** LoopDetectedException ** 이 예외는 사용되지 않습니다. HTTP 상태 코드: 508 ** NotAcceptableException ** 요청의 수락 헤더에 유효한 값이 없습니다. HTTP 상태 코드: 406 ** NotFoundException ** 참조된 리소스(예: Amazon Lex 봇 또는 별칭)를 찾을 수 없습니다. HTTP 상태 코드: 404 ** RequestTimeoutException ** 입력 음성이 너무 깁니다. HTTP 상태 코드: 408 ** UnsupportedMediaTypeException ** 콘텐츠 유형 헤더(`PostContent`API)에 유효하지 않은 값이 있습니다. HTTP 상태 코드: 415 ## 예제 ### 예제 1. 이 요청에서 URI는 봇(트래픽), 봇 버전(\$1LATEST) 및 최종 사용자 이름(일부 사용자)을 식별합니다. `Content-Type` 헤더는 본문의 오디오 형식을 식별합니다. Amazon Lex는 다른 형식도 지원합니다. 필요한 경우 SoX 오픈 소스 소프트웨어를 사용하여 오디오를 한 형식에서 다른 형식으로 변환할 수 있습니다. `Accept` HTTP 헤더를 추가하여 응답을 받을 형식을 지정합니다. 응답의 `x-amz-lex-message` 헤더에는 Amazon Lex가 반환한 응답이 표시됩니다. 그러면 클라이언트는 이 응답을 사용자에게 보낼 수 있습니다. 청크 인코딩을 통해 동일한 메시지가 오디오/MPEG 형식으로 전송됩니다(요청에 따라). #### 샘플 요청 ``` "POST /bot/Traffic/alias/$LATEST/user/someuser/content HTTP/1.1[\r][\n]" "x-amz-lex-session-attributes: eyJ1c2VyTmFtZSI6IkJvYiJ9[\r][\n]" "Content-Type: audio/x-l16; channel-count=1; sample-rate=16000f[\r][\n]" "Accept: audio/mpeg[\r][\n]" "Host: runtime.lex.us-east-1.amazonaws.com[\r][\n]" "Authorization: AWS4-HMAC-SHA256 Credential=BLANKED_OUT/20161230/us-east-1/lex/aws4_request, SignedHeaders=accept;content-type;host;x-amz-content-sha256;x-amz-date;x-amz-lex-session-attributes, Signature=78ca5b54ea3f64a17ff7522de02cd90a9acd2365b45a9ce9b96ea105bb1c7ec2[\r][\n]" "X-Amz-Date: 20161230T181426Z[\r][\n]" "X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855[\r][\n]" "Transfer-Encoding: chunked[\r][\n]" "Connection: Keep-Alive[\r][\n]" "User-Agent: Apache-HttpClient/4.5.x (Java/1.8.0_112)[\r][\n]" "Accept-Encoding: gzip,deflate[\r][\n]" "[\r][\n]" "1000[\r][\n]" "[0x7][0x0][0x7][0x0][\n]" "[0x0][0x7][0x0][0xfc][0xff][\n]" "[0x0][\n]" … ``` #### 샘플 응답 ``` "HTTP/1.1 200 OK[\r][\n]" "x-amzn-RequestId: cc8b34af-cebb-11e6-a35c-55f3a992f28d[\r][\n]" "x-amz-lex-message: Sorry, can you repeat that?[\r][\n]" "x-amz-lex-dialog-state: ElicitIntent[\r][\n]" "x-amz-lex-session-attributes: eyJ1c2VyTmFtZSI6IkJvYiJ9[\r][\n]" "Content-Type: audio/mpeg[\r][\n]" "Transfer-Encoding: chunked[\r][\n]" "Date: Fri, 30 Dec 2016 18:14:28 GMT[\r][\n]" "[\r][\n]" "2000[\r][\n]" "ID3[0x4][0x0][0x0][0x0][0x0][0x0]#TSSE[0x0][0x0][0x0][0xf][0x0][0x0][0x3]Lavf57.41.100[0x0][0x0][0x0][0x0][0x0][0x0][0x0][0x0][0x0][0x0][0x0][0xff][0xf3]`[0xc4][0x0][0x1b]{[0x8d][0xe8][0x1]C[0x18][0x1][0x0]J[0xe0]`b[0xdd][0xd1][0xb][0xfd][0x11][0xdf][0xfe]";[0xbb][0xbb][0x9f][0xee][0xee][0xee][0xee]|DDD/[0xff][0xff][0xff][0xff]www?D[0xf7]w^?[0xff][0xfa]h[0x88][0x85][0xfe][0x88][0x88][0x88][[0xa2]'[0xff][0xfa]"{[0x9f][0xe8][0x88]]D[0xeb][0xbb][0xbb][0xa2]!u[0xfd][0xdd][0xdf][0x88][0x94][0x0]F[0xef][0xa1]8[0x0][0x82]w[0x88]N[0x0][0x0][0x9b][0xbb][0xe8][0xe … ``` ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/runtime.lex-2016-11-28/PostContent) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/PostContent) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/PostContent) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/PostContent) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/PostContent) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/PostContent) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/PostContent) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/PostContent) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/PostContent) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/PostContent)