사전 빌드된 생년월일 구성요소 수집

사전 빌드된 구성요소는 월, 일, 연도를 수집하여 생년월일을 캡처하고 검증합니다.

제한사항

사전 빌드된 구성요소에는 일반적인 사전 빌드된 구성요소 제한사항 외에도 다음과 같은 제한사항이 있습니다.

  • 이 구성요소는 신분증 확인을 통한 최종 사용자의 생년월일 확인은 지원하지 않습니다.

DTMF를 사용 설정하면 사용자가 전화 키패드를 사용하여 숫자 값을 입력할 수 있습니다.

추가 기능

이 사전 빌드된 구성요소에는 다음과 같은 추가 기능이 제공됩니다.

샘플 대화상자

다음 샘플 대화상자에서는 사전 빌드된 구성요소에서 처리하는 일반적인 시나리오를 보여줍니다. 샘플 대화상자는 전화를 통해 구성요소가 호출될 때 기본 시작 인텐트와 대화 시작 시 첫 번째 에이전트 응답을 트리거하는 동작을 보여줍니다.

생년월일

최종 사용자가 한 번에 완전한 생년월일을 제공합니다. 에이전트가 이를 수락합니다

사용자 입력 에이전트 응답
생년월일을 입력하세요. 출생 월, 출생 일, 출생 연도를 알려주세요.
1995년 9월 9일
네, 생년월일은 1995년 9월 9일입니다. 맞나요?
좋습니다. 생년월일을 수집했습니다.

생년월일 일부

최종 사용자가 출생 월을 먼저 얘기하고 일, 연도를 얘기하여 생년월일을 제공합니다. 에이전트가 이를 수집합니다.

사용자 입력 에이전트 응답
생년월일을 입력하세요. 출생 월, 출생 일, 출생 연도를 알려주세요.
3월
생일이 며칠인가요?
12
몇 년도에 태어났나요?
1999
예, 생년월일은 1999년 3월 12일입니다. 맞나요?
좋습니다. 생년월일을 수집했습니다.

미래 날짜 검증

이 시나리오에서는 현재 날짜가 2023년 3월 22일이라고 가정합니다. 최종 사용자가 미래 날짜의 생년월일을 제공합니다. 에이전트가 이를 검증하고 최종 사용자에게 올바른 생년월일을 제공하도록 다시 요청합니다.

사용자 입력 에이전트 응답
생년월일을 입력하세요. 출생 월, 출생 일, 출생 연도를 알려주세요.
2023년 9월 9일
몇 년도에 태어났나요?
2023
예, 생년월일은 2023년 9월 9일입니다. 맞나요?
죄송하지만, 미래의 날짜를 입력했습니다. 다시 시작하겠습니다.
어떤 달에 태어났나요?
3월
생일이 며칠인가요?
12
몇 년도에 태어났나요?
1999
예, 생년월일은 1999년 3월 12일입니다. 맞나요?
좋습니다. 생년월일을 수집했습니다.

날짜가 잘못되었습니다.

최종 사용자가 1999년 2월 30일 또는 1999년 4월 31일과 같이 잘못된 생년월일을 제공합니다. 에이전트에서 이를 검증하고 최종 사용자에게 올바른 생년월일을 제공하도록 다시 요청합니다.

사용자 입력 에이전트 응답
생년월일을 입력하세요. 출생 월, 출생 일, 출생 연도를 알려주세요.
1999년 2월 30일
예, 생년월일은 1999년 2월 30일입니다. 맞나요?
입력한 날짜가 잘못되었습니다. 다시 시작하겠습니다.
어떤 달에 태어났나요?
3월
생일이 며칠인가요?
12
몇 년도에 태어났나요?
1999
예, 생년월일은 1999년 3월 12일입니다. 맞나요?
좋습니다. 생년월일을 수집했습니다.

인식할 수 없는 입력

최종 사용자가 인식할 수 없는 입력을 세 번 제공하면 구성요소가 흐름을 종료합니다.

사용자 입력 에이전트 응답
생년월일을 입력하세요. 출생 월, 출생 일, 출생 연도를 알려주세요.
좋습니다.
죄송합니다. 인식하지 못했습니다. 생년월일을 다시 말해주세요.
nice
죄송하지만 생년월일을 찾을 수 없습니다. 먼저 월부터 시작하겠습니다. 출생한 월을 알려주세요.
good
죄송합니다. 인식하지 못했습니다. 월을 다시 말하거나 입력해 주세요.
nice
아직도 이해하지 못했습니다. 월을 말하고 있는지 확인하세요. 음성이 잘 인식되지 않는 경우 키패드를 사용하여 월을 입력할 수도 있습니다.
nice
죄송하지만 응답을 이해하는 데 문제가 있습니다.

생년월일 검증

이 사전 빌드된 구성요소는 IS_DATEIS_FUTURE_DATE 시스템 함수를 사용하여 수집된 날짜가 유효하고 과거인지 여부를 확인합니다. 또한 다음 사항도 적용됩니다.

  • '이번 달', '다음 달' 또는 '지난달'과 같은 입력은 적절한 월로 변환됩니다. 예를 들어 최종 사용자가 3월에 에이전트와 상호작용한 경우 '이번 달', '다음 달', '지난달'은 각각 '3월', '4월', '2월'로 변환됩니다.
  • 연도가 4자릿수인지 확인합니다. 연도 입력에 두 자리만 포함된 경우 구성요소는 4자리 연도로 변환합니다. 예를 들어 '98'은 '1998'로 변환됩니다.
  • '이번 목요일', '지난 목요일', '다음 목요일'과 같은 입력은 적절한 월 및 일로 캡처되고 에이전트에서 연도를 입력하라는 메시지를 표시합니다. 예를 들어 최종 사용자가 수요일인 2023년 3월 22일과 에이전트와 상호작용하는 경우 '이번 목요일', '지난 목요일', '다음 목요일'은 각각 '3월 23일', '3월 16일', '3월 30일'로 변환됩니다.

이름 지정 규칙

이 사전 빌드된 구성요소는 다음 이름 지정 규칙을 사용합니다.

기능 형식
정렬 [구성요소 이름] DOB 수집
구성요소별 인텐트 prebuilt_components_[component_name]_[intent_name] prebuilt_components_dob_collection_collect_month
매개변수 [param_name] dob
항목 유형 prebuilt_components_[component_name]_[entity_type] prebuilt_components_dob_collection_dob_day

출력 매개변수

출력 매개변수는 구성요소를 종료한 후에도 활성 상태로 유지되는 세션 매개변수입니다. 이러한 매개변수에는 구성요소에 의해 수집된 중요한 정보가 포함됩니다. 이 사전 빌드된 구성요소는 다음 출력 매개변수의 값을 제공합니다.

매개변수 이름 설명 출력 형식
dob_collection_dob 이 매개변수는 생년월일 요소(일, 월, 연도)가 포함된 객체를 반환합니다.

{
"year": integer,
"month": integer,
"day": integer
}

기본 설정

이 사전 빌드된 구성요소를 설정하려면 다음 안내를 따르세요.

  1. 사전 빌드된 구성요소를 가져옵니다.

완료

에이전트가 설정되었으며 테스트할 준비가 되었습니다.