Setting Request Attributes - Amazon Lex V1
사전 정의된 요청 속성 설정사용자-정의 요청 속성 설정

Amazon Lex V2를 사용하는 경우 Amazon Lex V2 가이드를 대신 참조하십시오.

 

Amazon Lex V1을 사용하는 경우 봇을 Amazon Lex V2로 업그레이드하는하는 것이 좋습니다. 더 이상 V1에 새로운 기능을 추가하지 않으므로 모든 새 봇에 V2를 사용할 것을 강력히 권장합니다.

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

Setting Request Attributes

요청 속성은 요청 관련 정보를 포함하고 있고 현재 요청에만 적용됩니다. 클라이언트 애플리케이션은 이 정보를 Amazon Lex로 전송합니다. 전체 세션에서 유지할 필요가 없는 정보를 전달하려면 요청 속성을 사용합니다. 요청 속성을 직접 생성할 수도 있고 사전 정의된 속성을 사용할 수도 있습니다. 요청 속성을 보내려면 PostText 요청에 포함된 PostContent 또는 requestAttributes 필드 안의 x-amz-lex-request-attributes 헤더를 사용합니다. 요청 속성은 세션 속성처럼 요청 전체에 지속되지 않기 때문에 요청 속성은 PostContent 또는 PostText 응답에서 반환되지 않습니다.

참고

요청 간에 유지되는 정보를 보내려면 세션 속성을 사용하십시오.

네임스페이스 x-amz-lex:는 사전 정의된 요청 속성용으로 보류되어 있습니다. x-amz-lex: 접두사를 사용하여 요청 속성을 생성하지 마세요.

사전 정의된 요청 속성 설정

Amazon Lex는 봇으로 전송된 정보를 처리하는 방식을 관리하기 위해 사전 정의된 요청 속성을 제공합니다. 속성은 전체 세션 동안 지속되지 않으므로 각 요청에서 사전 정의된 속성을 전송해야 합니다. 사전 정의된 모든 속성은 x-amz-lex: 네임스페이스에 있습니다.

Amazon Lex는 다음과 같은 사전 정의된 속성 외에도 메시징 플랫폼을 위한 사전 정의된 속성을 제공합니다. 이러한 속성의 목록은 메시징 플랫폼에 Amazon Lex 봇 배포하기을 참조하십시오.

응답 유형 설정

기능이 다른 두 개의 클라이언트 애플리케이션을 사용하는 경우 응답의 메시지 형식을 제한해야 할 수 있습니다. 예를 들어 웹 클라이언트에 보내는 메시지는 일반 텍스트로 제한하고 모바일 클라이언트는 일반 텍스트와 음성 합성 마크업 언(SSML)를 모두 사용할 수 있도록 할 수 있습니다. PostContent 및 PostText 작업이 필드에 반환하는 메시지 형식을 제어하려면 x-amz-lex:accept-content-types" 요청 속성을 사용합니다.

다음 메시지 유형의 모든 조합으로 속성을 설정할 수 있습니다.

  • PlainText—메시지에 일반 UTF-8 텍스트가 포함됩니다.

  • SSML—메시지에 음성 출력용으로 서식이 지정된 텍스트가 포함됩니다.

  • CustomPayload—메시지에 클라이언트용으로 생성한 사용자 지정 형식이 포함됩니다. 애플리케이션의 요건을 이행하도록 페이로드를 정의할 수 있습니다.

Amazon Lex는 응답 Message 필드에 지정된 유형의 메시지만 반환합니다. 값을 쉼표로 구분하여 둘 이상의 값을 설정할 수 있습니다. 메시지 그룹을 사용하는 경우 모든 메시지 그룹에는 지정된 유형의 메시지가 하나 이상 포함되어야 합니다. 그러지 않을 경우 NoUsableMessageException 오류가 발생합니다. 자세한 내용은 메시지 그룹을 참조하세요.

참고

x-amz-lex:accept-content-types 요청 속성은 HTML 본문의 내용에 영향을 주지 않습니다. PostText 작업 응답의 내용은 항상 일반 UTF-8 텍스트입니다. PostContent 작업 응답 본문에는 요청 안에 있는 Accept 헤더에서 설정된 형식의 데이터가 포함됩니다.

선호 시간대 설정

날짜를 확인하는 데 사용되는 시간대를 사용자의 시간대를 기준으로 설정하려면 x-amz-lex:time-zone 요청 속성을 사용하십시오. x-amz-lex:time-zone 속성에 시간대를 지정하지 않는 경우 기본값은 봇에 사용하는 지역에 따라 달라집니다.

지역 기본 설정 시간대
미국 동부(버지니아 북부) America/New_York
미국 서부(오레곤) America/Los_Angeles
아시아 태평양(싱가포르) 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 데이터베이스 시간대 목록을 참조하십시오.

사용자-정의 요청 속성 설정

사용자-정의 요청 속성은 각 요청에서 봇에 보내는 데이터입니다. 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 헤더로 전송합니다.

세션 속성으로 이진수 또는 구조화된 데이터를 보내는 경우 먼저 데이터를 단순 문자열로 변환해야 합니다. 자세한 내용은 복합 속성 설정을 참조하세요.