이 사전 빌드된 구성요소는 최종 사용자로부터 숫자 시퀀스를 수집합니다. 입력 매개변수를 통해 허용되는 최소 및 최대 길이를 구성할 수 있습니다.
이 구성요소는 각 대화 차례에서 사용자의 숫자 청크를 캡처하고 이를 연결하여 최종 시퀀스를 형성합니다. 입력 매개변수를 통해 청크당 허용되는 최소 및 최대 길이가 구성될 수 있습니다.
시퀀스 캡처는 최종 사용자가 prebuilt_components_confirmation_done 인텐트와 일치하는 입력으로 시퀀스를 완료했음을 나타낼 때까지 계속됩니다.
제한사항
사전 빌드된 구성요소에는 일반적인 사전 빌드된 구성요소 제한사항 외에도 다음과 같은 제한사항이 있습니다.
- 숫자가 아닌 문자는 지원되지 않습니다. 문자 및 숫자 지원은 영숫자 컬렉션을 참조하세요.
권장 에이전트 설정
DTMF를 사용 설정하면 사용자가 전화 키패드를 사용하여 숫자 값을 입력할 수 있습니다.
추가 기능
이 사전 빌드된 구성요소에는 다음과 같은 추가 기능이 제공됩니다.
샘플 대화상자
다음 샘플 대화상자에서는 사전 빌드된 구성요소에서 처리하는 일반적인 시나리오를 보여줍니다. 샘플 대화상자는 전화를 통해 구성요소가 호출될 때 기본 시작 인텐트와 대화 시작 시 첫 번째 에이전트 응답을 트리거하는 동작을 보여줍니다.
단일 청크
최종 사용자가 첫 번째 시도에서 숫자 시퀀스를 제공합니다. 에이전트가 이를 수락합니다
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 먼저 숫자 시퀀스의 처음 1~30자리 숫자를 말해 주세요. 완료되면 '완료'라고 말하며 수집을 완료합니다. 언제든지 '재생'이라고 말하면 현재 수집된 시퀀스를 확인할 수 있습니다. | |
| 2374 30940 029 30 | |
| 23743094002930입니다. 맞나요? | |
| 예 | |
| 좋습니다. 숫자 시퀀스의 다음 부분을 말하거나 입력하세요. | |
| 완료 | |
| 감사합니다. 수집한 숫자 시퀀스는 23743094002930입니다. 맞나요? | |
| 예 | |
| 좋습니다. 숫자 시퀀스 수집을 완료했습니다. |
여러 단위
최종 사용자가 여러 단위의 숫자 시퀀스를 제공합니다. 에이전트가 이를 수락합니다
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 먼저 숫자 시퀀스의 처음 1~30자리 숫자를 말해 주세요. 완료되면 '완료'라고 말하며 수집을 완료합니다. 언제든지 '재생'이라고 말하면 현재 수집된 시퀀스를 확인할 수 있습니다. | |
| 2374 30940 029 30 | |
| 23743094002930입니다. 맞나요? | |
| 아니요 | |
| 괜찮습니다. 숫자 시퀀스의 처음 1~30자리 숫자를 다시 입력해 주세요. | |
| 2374 | |
| 2374입니다. 맞나요? | |
| 예 | |
| 좋습니다. 숫자 시퀀스의 다음 부분을 말하거나 입력하세요. | |
| 3094 | |
| 3094입니다. 맞나요? | |
| 네 | |
| 좋습니다. 숫자 시퀀스의 다음 부분을 말하거나 입력하세요. | |
| 002930 | |
| 002930입니다. 맞나요? | |
| 아니요 | |
| 괜찮습니다. 23743094 이후에는 어떻게 되나요? | |
| 2930 | |
| 2930입니다. 맞나요? | |
| 예, 이상입니다. | |
| 감사합니다. 수집한 숫자 시퀀스는 237430942930입니다. 맞나요? | |
| 예 | |
| 좋습니다. 숫자 시퀀스 수집을 완료했습니다. |
재시도 성공
최종 사용자가 첫 번째 시도에서 숫자 시퀀스를 제공합니다. 에이전트가 재확인하지만 최종 사용자가 '아니요'라고 말합니다. 에이전트가 최종 사용자에게 시퀀스를 다시 제공하도록 요청합니다. 최종 사용자가 시퀀스를 제공하고 확인한 후 에이전트가 이를 수락합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 먼저 숫자 시퀀스의 처음 1~30자리 숫자를 말해 주세요. 완료되면 '완료'라고 말하며 수집을 완료합니다. 언제든지 '재생'이라고 말하면 현재 수집된 시퀀스를 확인할 수 있습니다. | |
| 92832938 3489 | |
| 928329383459입니다.맞나요? | |
| 아니요 | |
| 괜찮습니다. 숫자 시퀀스의 처음 1~30자리 숫자를 다시 입력해 주세요. | |
| 928329383435 | |
| 928329383435입니다.맞나요? | |
| 예, 그렇습니다. | |
| 감사합니다. 수집한 숫자 시퀀스는 928329383435입니다. 맞나요? | |
| 예 | |
| 좋습니다. 숫자 시퀀스 수집을 완료했습니다. |
재시도 실패
최종 사용자가 숫자 시퀀스를 세 번 제공하고 재확인 단계에서 '아니요'라고 말합니다. 세 번째 확인 실패 시 구성요소 흐름이 종료됩니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 먼저 숫자 시퀀스의 처음 1~30자리 숫자를 말해 주세요. 완료되면 '완료'라고 말하며 수집을 완료합니다. 언제든지 '재생'이라고 말하면 현재 수집된 시퀀스를 확인할 수 있습니다. | |
| 928329383435 | |
| 928329383835입니다.맞나요? | |
| 아니요 | |
| 괜찮습니다. 숫자 시퀀스의 처음 1~30자리 숫자를 다시 입력해 주세요. | |
| 23 289 0239 903 | |
| 232890239953입니다.맞나요? | |
| 아니요 | |
| 괜찮습니다. 숫자 시퀀스의 처음 1~30자리 숫자를 다시 입력해 주세요. | |
| 23847 02938 | |
| 2384702938입니다.맞나요? | |
| 아니요 | |
| 죄송합니다. 너무 많이 시도하여 응답을 수집하지 못했습니다. |
인식할 수 없는 입력
최종 사용자가 인식할 수 없는 입력을 세 번 제공하면 구성요소가 흐름을 종료합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 먼저 숫자 시퀀스의 처음 1~30자리 숫자를 말해 주세요. 완료되면 '완료'라고 말하며 수집을 완료합니다. 언제든지 '재생'이라고 말하면 현재 수집된 시퀀스를 확인할 수 있습니다. | |
| 좋습니다. | |
| 죄송합니다. 인식하지 못했습니다. 먼저 숫자 시퀀스의 처음 1~30자리 숫자를 말해 주세요. 완료되면 '완료'라고 말하며 수집을 완료합니다. 언제든지 '재생'이라고 말하면 현재 수집된 시퀀스를 확인할 수 있습니다. | |
| nice | |
| 아직도 이해하지 못했습니다. 숫자 시퀀스의 처음 1~30자리 숫자를 말합니다. 완료되면 '완료'라고 말하며 수집을 완료합니다. 언제든지 '재생'이라고 말하면 현재 수집된 시퀀스를 확인할 수 있습니다. 음성이 잘 인식되지 않는 경우 키패드를 사용하여 숫자 시퀀스를 입력할 수도 있습니다. | |
| 매우 좋음 | |
| 죄송하지만 응답을 이해하는 데 문제가 있습니다. |
이름 지정 규칙
이 사전 빌드된 구성요소는 다음 이름 지정 규칙을 사용합니다.
| 기능 | 형식 | 예 |
|---|---|---|
| 정렬 | [구성요소 이름] | 숫자 수집 |
| 구성요소별 인텐트 | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_numeric_collection_collect_numeric_sequence |
| 매개변수 | [param_name] | user_provided_cur_seq |
입력 매개변수
입력 매개변수는 구성요소의 특정 동작을 구성하는 데 사용되는 매개변수입니다. 매개변수는 흐름 내 하나 이상의 조건에서 구성요소 작동 방식을 결정하는 데 사용됩니다. 흐름 범위 매개변수는 아래 설명된 대로 구성요소의 시작 페이지에서 설정해야 합니다. 세션 범위 매개변수는 호출 흐름 또는 이 구성요소의 시작 페이지에서 설정할 수 있습니다.
흐름의 시작 페이지에서 매개변수 사전 설정을 수정하여 캡처당 허용되는 최소 및 최대 길이와 최종 수집된 시퀀스를 구성할 수 있습니다.
이 사전 빌드된 구성요소는 다음 입력 매개변수를 허용합니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $flow.numeric_min_length | 최종 숫자 시퀀스의 최소 길이 | 정수 |
| $flow.numeric_max_length | 최종 숫자 시퀀스의 최대 길이 | 정수 |
| $flow.lower_limit | 각 차례에 사용자가 제공할 수 있는 청크의 최소 길이 | 정수 |
| $flow.upper_limit | 각 차례에 사용자가 제공할 수 있는 청크의 최대 길이 | 정수 |
이 구성요소의 입력 매개변수를 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 빌드 탭을 선택합니다.
- 흐름 섹션에서 가져온 구성요소를 클릭합니다.
- 페이지 섹션에서 시작 페이지를 클릭합니다.
- 시작 페이지에서 true 경로를 클릭합니다.
- 경로 창에서 필요에 따라 매개변수 사전 설정 값을 수정합니다.
- 저장을 클릭합니다.
출력 매개변수
출력 매개변수는 구성요소를 종료한 후에도 활성 상태로 유지되는 세션 매개변수입니다. 이러한 매개변수에는 구성요소에 의해 수집된 중요한 정보가 포함됩니다. 이 사전 빌드된 구성요소는 다음 출력 매개변수의 값을 제공합니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| numeric_collection_numeric_sequence | 이 매개변수는 세션 중에 캡처된 숫자 시퀀스를 반환합니다. | 문자열 |
기본 설정
이 사전 빌드된 구성요소를 설정하려면 다음 안내를 따르세요.
완료
이제 에이전트가 설정되었고 테스트할 준비가 되었습니다.