지원 종료 공지: 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) 참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Setting Request Attributes
*요청 속성*은 요청 관련 정보를 포함하고 있고 현재 요청에만 적용됩니다. 클라이언트 애플리케이션은 이 정보를 Amazon Lex로 전송합니다. 전체 세션에서 유지할 필요가 없는 정보를 전달하려면 요청 속성을 사용합니다. 요청 속성을 직접 생성할 수도 있고 사전 정의된 속성을 사용할 수도 있습니다. 요청 속성을 보내려면 [PostText](API_runtime_PostText.md) 요청에 포함된 [PostContent](API_runtime_PostContent.md) 또는 `requestAttributes` 필드 안의 `x-amz-lex-request-attributes` 헤더를 사용합니다. 요청 속성은 세션 속성처럼 요청 전체에 지속되지 않기 때문에 요청 속성은 `PostContent` 또는 `PostText` 응답에서 반환되지 않습니다.
**참고**
요청 간에 유지되는 정보를 보내려면 세션 속성을 사용하십시오.
네임스페이스 `x-amz-lex:`는 사전 정의된 요청 속성용으로 보류되어 있습니다. `x-amz-lex:` 접두사를 사용하여 요청 속성을 생성하지 마세요.
## 사전 정의된 요청 속성 설정
Amazon Lex는 봇으로 전송된 정보를 처리하는 방식을 관리하기 위해 사전 정의된 요청 속성을 제공합니다. 속성은 전체 세션 동안 지속되지 않으므로 각 요청에서 사전 정의된 속성을 전송해야 합니다. 사전 정의된 모든 속성은 `x-amz-lex:` 네임스페이스에 있습니다.
Amazon Lex는 다음과 같은 사전 정의된 속성 외에도 메시징 플랫폼을 위한 사전 정의된 속성을 제공합니다. 이러한 속성의 목록은 [메시징 플랫폼에 Amazon Lex 봇 배포하기](example1.md)을 참조하십시오.
### 응답 유형 설정
기능이 다른 두 개의 클라이언트 애플리케이션을 사용하는 경우 응답의 메시지 형식을 제한해야 할 수 있습니다. 예를 들어 웹 클라이언트에 보내는 메시지는 일반 텍스트로 제한하고 모바일 클라이언트는 일반 텍스트와 음성 합성 마크업 언(SSML)를 모두 사용할 수 있도록 할 수 있습니다. [PostContent](API_runtime_PostContent.md) 및 [PostText](API_runtime_PostText.md) 작업이 필드에 반환하는 메시지 형식을 제어하려면 `x-amz-lex:accept-content-types"` 요청 속성을 사용합니다.
다음 메시지 유형의 모든 조합으로 속성을 설정할 수 있습니다.
+ `PlainText`—메시지에 일반 UTF-8 텍스트가 포함됩니다.
+ `SSML`—메시지에 음성 출력용으로 서식이 지정된 텍스트가 포함됩니다.
+ `CustomPayload`—메시지에 클라이언트용으로 생성한 사용자 지정 형식이 포함됩니다. 애플리케이션의 요건을 이행하도록 페이로드를 정의할 수 있습니다.
Amazon Lex는 응답 `Message` 필드에 지정된 유형의 메시지만 반환합니다. 값을 쉼표로 구분하여 둘 이상의 값을 설정할 수 있습니다. 메시지 그룹을 사용하는 경우 모든 메시지 그룹에는 지정된 유형의 메시지가 하나 이상 포함되어야 합니다. 그러지 않을 경우 `NoUsableMessageException` 오류가 발생합니다. 자세한 내용은 [메시지 그룹](howitworks-manage-prompts.md#message-groups) 단원을 참조하십시오.
**참고**
`x-amz-lex:accept-content-types` 요청 속성은 HTML 본문의 내용에 영향을 주지 않습니다. `PostText` 작업 응답의 내용은 항상 일반 UTF-8 텍스트입니다. `PostContent` 작업 응답 본문에는 요청 안에 있는 `Accept` 헤더에서 설정된 형식의 데이터가 포함됩니다.
### 선호 시간대 설정
날짜를 확인하는 데 사용되는 시간대를 사용자의 시간대를 기준으로 설정하려면 `x-amz-lex:time-zone` 요청 속성을 사용하십시오. `x-amz-lex:time-zone` 속성에 시간대를 지정하지 않는 경우 기본값은 봇에 사용하는 지역에 따라 달라집니다.
| 지역 | 기본 설정 시간대 |
| --- | --- |
| 미국 동부(버지니아 북부) | America/New\$1York |
| 미국 서부(오레곤) | America/Los\$1Angeles |
| 아시아 태평양(싱가포르) | Asia/Singapore |
| 아시아 태평양(시드니) | Australia/Sydney |
| 아시아 태평양(도쿄) | Asia/Tokyo |
| 유럽(프랑크푸르트) | Europe/Berlin |
| 유럽(아일랜드) | Europe/Dublin |
| 유럽(런던) | Europe/London |
예를 들어, 사용자가 "패키지를 어느 날짜에 배송하시겠습니까?" 라는 프롬프트에 `tomorrow` 응답하는 경우. 패키지가 배송되는 실제 *날짜*는 사용자의 시간대에 따라 다릅니다. 예를 들어 뉴욕의 경우 9월 16일 01:00이고 로스앤젤레스의 경우 9월 15일 22:00입니다. 서비스가 미국 동부 (버지니아 북부) 지역에서 운영되고 있고 로스앤젤레스에 있는 사람이 기본 시간대를 사용하여 "내일"에 배송되도록 패키지를 주문하는 경우 패키지는 16일이 아닌 17일에 배송됩니다. 하지만 `x-amz-lex:time-zone` 요청 속성을 `America/Los_Angeles`로 설정하면 패키지는 16일에 배달됩니다.
속성을 원하는 인터넷 지정 번호 기관(IANA) 시간대 이름으로 설정할 수 있습니다. 시간대 이름 목록은 Wikipedia의 [tz 데이터베이스 시간대 목록](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)을 참조하십시오.
## 사용자-정의 요청 속성 설정
*사용자-정의 요청 속성*은 각 요청에서 봇에 보내는 데이터입니다. `PostContent` 요청의 `amz-lex-request-attributes` 헤더나 `PostText` 요청의 `requestAttributes` 필드에 정보를 전송합니다.
세션 속성을 Amazon Lex로 전송하려면 속성의 string-to-string 맵을 생성합니다. 다음은 세션 속성을 매핑하는 방법을 보여줍니다.
```
{
"attributeName": "attributeValue",
"attributeName": "attributeValue"
}
```
`PostText` 작업의 경우 다음과 같이 `requestAttributes` 필드를 사용하여 요청 본문에 맵을 삽입합니다.
```
"requestAttributes": {
"attributeName": "attributeValue",
"attributeName": "attributeValue"
}
```
`PostContent` 작업의 경우, 맵을 base64로 인코딩한 다음 `x-amz-lex-request-attributes` 헤더로 전송합니다.
세션 속성으로 이진수 또는 구조화된 데이터를 보내는 경우 먼저 데이터를 단순 문자열로 변환해야 합니다. 자세한 내용은 [복합 속성 설정](context-mgmt-complex-attributes.md) 단원을 참조하세요.