영숫자 컬렉션 사전 빌드된 구성요소는 최종 사용자로부터 영숫자 시퀀스를 수집합니다. 허용되는 최소 및 최대 길이는 입력 매개변수를 통해 구성할 수 있습니다.
이 구성요소는 대화할 때마다 사용자로부터 텍스트 조각을 캡처하고 이를 연결해서 최종 시퀀스를 만듭니다. 조각별로 허용되는 최소 및 최대 길이는 입력 매개변수를 통해 구성할 수 있습니다.
시퀀스 캡처는 최종 사용자가 prebuilt_components_confirmation_done 인텐트와 일치하는 입력으로 시퀀스를 완료했음을 나타낼 때까지 계속됩니다.
음성 기호
이 구성요소는 NATO 음성 기호와 같은 음성 기호 사용을 지원합니다.
| 사용자 입력 | 캡처된 시퀀스 |
|---|---|
| alpha bravo charlie 123 | abc123 |
| A B Cat 1 2 3 | ABC123 |
| A as in apple, B as in banana, C for chili, one fifteen | ABC115 |
추가 기능
이 사전 빌드된 구성요소에는 다음과 같은 추가 기능이 제공됩니다.
샘플 대화상자
다음 샘플 대화상자에서는 사전 빌드된 구성요소에서 처리하는 일반적인 시나리오를 보여줍니다. 샘플 대화상자는 전화를 통해 구성요소가 호출될 때 기본 시작 인텐트와 대화 시작 시 첫 번째 에이전트 응답을 트리거하는 동작을 보여줍니다.
단일 조각
최종 사용자가 하나의 조각으로 영숫자 시퀀스를 제공하고 '완료'라고 말하면 에이전트가 이를 성공적으로 수락합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 영숫자 시퀀스의 처음 1~8자를 말하는 것으로 시작합니다. 완료되었으면 '완료'라고 말해서 수집을 끝냅니다. 언제든지 "재생"이라고 말하면 현재 수집된 시퀀스를 확인할 수 있습니다. | |
| fvfd3433 | |
| 알겠습니다. fvfd3433이 입력되었습니다. 맞나요? | |
| 예 | |
| 좋습니다. 시퀀스에서 다음 1~8자를 알려주세요. | |
| 완료 | |
| 확인해 주셔서 감사합니다. 입력된 최종 영숫자 시퀀스는 fvfd3433입니다. 맞나요? | |
| 예 | |
| 좋습니다. 영숫자 시퀀스가 수집되었습니다. |
복수 조각
최종 사용자가 2개의 조각으로 영숫자 시퀀스를 제공하고 에이전트가 이를 성공적으로 수락합니다
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 영숫자 시퀀스의 처음 1~8자를 말하는 것으로 시작합니다. 완료되었으면 '완료'라고 말해서 수집을 끝냅니다. 언제든지 "재생"이라고 말하면 현재 수집된 시퀀스를 확인할 수 있습니다. | |
| fvfd3433 | |
| 알겠습니다. fvfd3433이 입력되었습니다. 맞나요? | |
| 예 | |
| 좋습니다. 시퀀스에서 다음 1~8자를 알려주세요. | |
| gh67 | |
| 알겠습니다. gh67이 입력되었습니다. 맞나요? | |
| 예 | |
| 좋습니다. 시퀀스에서 다음 1~8자를 알려주세요. | |
| 완료 | |
| 확인해 주셔서 감사합니다. 입력된 최종 영숫자 시퀀스는 fvfd3433gh67입니다. 맞나요? | |
| 예 | |
| 좋습니다. 영숫자 시퀀스가 수집되었습니다. |
재시도 성공
최종 사용자가 영숫자 시퀀스를 제공하고 에이전트가 최종 사용자에게 재확인을 수행합니다. 최종 사용자가 확인에 대해 '아니요'라고 말하고 영숫자 시퀀스를 다시 제공하면 에이전트가 이를 성공적으로 수락합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 영숫자 시퀀스의 처음 1~8자를 말하는 것으로 시작합니다. 완료되었으면 '완료'라고 말해서 수집을 끝냅니다. 언제든지 "재생"이라고 말하면 현재 수집된 시퀀스를 확인할 수 있습니다. | |
| fvfd3433 | |
| 알겠습니다. fd3433이 입력되었습니다. 맞나요? | |
| 아니요 | |
| 죄송하지만 처음 1~8자를 다시 알려주시겠어요? | |
| fvfd3433 | |
| 알겠습니다. fvfd3433이 입력되었습니다. 맞나요? | |
| 예 | |
| 좋습니다. 시퀀스에서 다음 1~8자를 알려주세요. | |
| 완료 | |
| 확인해 주셔서 감사합니다. 입력된 최종 영숫자 시퀀스는 fvfd3433입니다. 맞나요? | |
| 예 | |
| 좋습니다. 영숫자 시퀀스가 수집되었습니다. |
재시도 실패
최종 사용자가 세 번의 재시도 횟수 내에서 1~8자의 영숫자 시퀀스를 제공할 수 없고 구성요소가 흐름을 종료합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 영숫자 시퀀스의 처음 1~8자를 말하는 것으로 시작합니다. 완료되었으면 '완료'라고 말해서 수집을 끝냅니다. 언제든지 "재생"이라고 말하면 현재 수집된 시퀀스를 확인할 수 있습니다. | |
| 123N | |
| 알겠습니다. 123M이 입력되었습니다. 맞나요? | |
| 아니요 | |
| 죄송하지만 처음 1~8자를 다시 알려주시겠어요? | |
| 123N | |
| 알겠습니다. 123M이 입력되었습니다. 맞나요? | |
| 아니요 | |
| 죄송하지만 처음 1~8자를 다시 알려주시겠어요? 각 문자로 시작하는 단어를 이용해서 시퀀스에서 각 문자의 철자를 알려주세요. 예를 들어 시퀀스가 AB123이면 "Apple Baby 123"라고 말합니다. |
|
| 123 Nest | |
| 알겠습니다. 123N이 입력되었습니다. 맞나요? | |
| 아니요 | |
| 죄송하지만 재시도 횟수가 너무 많아서 영숫자 시퀀스를 입력할 수 없습니다. |
음성 기호
최종 사용자가 영숫자 시퀀스를 제공하고 에이전트가 최종 사용자에게 재확인을 수행합니다. 최종 사용자가 확인에 대해 2회 연속 '아니요'라고 말하면, 음성 전환이 사용 설정되고, 최종 사용자가 영숫자 시퀀스를 다시 제공하면, 에이전트가 이를 성공적으로 수락합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 영숫자 시퀀스의 처음 1~8자를 말하는 것으로 시작합니다. 완료되었으면 '완료'라고 말해서 수집을 끝냅니다. 언제든지 "재생"이라고 말하면 현재 수집된 시퀀스를 확인할 수 있습니다. | |
| 123N | |
| 알겠습니다. 123M이 입력되었습니다. 맞나요? | |
| 아니요 | |
| 죄송하지만 처음 1~8자를 다시 알려주시겠어요? | |
| 123N | |
| 알겠습니다. 123M이 입력되었습니다. 맞나요? | |
| 아니요 | |
| 죄송하지만 처음 1~8자를 다시 알려주시겠어요? 각 문자로 시작하는 단어를 이용해서 시퀀스에서 각 문자의 철자를 알려주세요. 예를 들어 시퀀스가 AB123이면 "Apple Baby 123"라고 말합니다. |
|
| 123 N as in Nancy | |
| 알겠습니다. 123N이 입력되었습니다. 맞나요? | |
| 예 | |
| 좋습니다. 시퀀스에서 다음 1~8자를 알려주세요. | |
| 567BC | |
| 알겠습니다. 567BC가 입력되었습니다. 맞나요? | |
| 완료 | |
| 확인해 주셔서 감사합니다. 입력된 최종 영숫자 시퀀스는 123N56BC입니다. 맞나요? | |
| 그렇습니다 | |
| 좋습니다. 영숫자 시퀀스가 수집되었습니다. |
잘못된 시퀀스 길이
최종 사용자가 영숫자 시퀀스에 대해 사전 정의된 최소 및 최대 길이를 벗어나는 길이로 영숫자 시퀀스를 제공합니다. 에이전트는 최종 사용자에게 다시 시작하라는 안내를 제공하고 최종 사용자가 거부하면 구성요소가 흐름을 종료합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 영숫자 시퀀스의 처음 1~8자를 말하는 것으로 시작합니다. 완료되었으면 '완료'라고 말해서 수집을 끝냅니다. 언제든지 "재생"이라고 말하면 현재 수집된 시퀀스를 확인할 수 있습니다. | |
| 123M | |
| 알겠습니다. 123M이 입력되었습니다. 맞나요? | |
| 완료 | |
| 죄송하지만 5~30자 사이의 필수 문자 길이를 벗어나는 영숫자 시퀀스를 제공했습니다. 다시 시작하시겠어요? | |
| 아니요 | |
| 죄송하지만 재시도 횟수가 너무 많아서 영숫자 시퀀스를 입력할 수 없습니다. |
이름 지정 규칙
이 사전 빌드 구성요소는 다음 이름 지정 규칙을 사용합니다.
| 기능 | 형식 | 예 |
|---|---|---|
| 흐름 | [구성요소 이름] | 영숫자 컬렉션 |
| 구성요소 특정 인텐트 | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_alphanumeric_collection_support_continue |
| 매개변수 | [param_name] | alphanumeric_max_length |
입력 매개변수
입력 매개변수는 구성요소의 특정 동작을 구성하는 데 사용되는 매개변수입니다. 매개변수는 흐름 내 하나 이상의 조건에서 구성요소 작동 방식을 결정하는 데 사용됩니다. 흐름 범위 매개변수는 아래 설명된 대로 구성요소의 시작 페이지에서 설정해야 합니다. 세션 범위 매개변수는 호출 흐름 또는 이 구성요소의 시작 페이지에서 설정할 수 있습니다.
흐름의 시작 페이지에서 매개변수 사전 설정을 수정하여 캡처당 허용되는 최소 및 최대 길이와 최종 수집된 시퀀스를 구성할 수 있습니다.
이 사전 빌드된 구성요소는 다음 입력 매개변수를 허용합니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $flow.alphanumeric_min_length | 최종 영숫자 시퀀스의 최소 길이입니다. 기본값은 1입니다. |
정수 |
| $flow.alphanumeric_max_length | 최종 영숫자 시퀀스의 최대 길이입니다. 기본값은 30입니다. |
정수 |
| $flow.lower_limit | 각 차례에 사용자가 제공할 수 있는 청크의 최소 길이 기본값은 1입니다. |
정수 |
| $flow.upper_limit | 각 차례에 사용자가 제공할 수 있는 청크의 최대 길이 기본값은 8입니다. |
정수 |
이 구성요소의 입력 매개변수를 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 빌드 탭을 선택합니다.
- 흐름 섹션에서 가져온 구성요소를 클릭합니다.
- 페이지 섹션에서 시작 페이지를 클릭합니다.
- 시작 페이지에서 true 경로를 클릭합니다.
- 경로 창에서 필요에 따라 매개변수 사전 설정 값을 수정합니다.
- 저장을 클릭합니다.
출력 매개변수
출력 매개변수는 구성요소를 종료한 후에도 활성 상태로 유지되는 세션 매개변수입니다. 이러한 매개변수에는 구성요소에 의해 수집된 중요한 정보가 포함됩니다. 이 사전 빌드 구성요소는 다음 출력 매개변수의 값을 제공합니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| alphanumeric_collection_alphanumeric_sequence | 이 매개변수는 구성요소가 캡처한 영숫자 시퀀스를 반환합니다. | 문자열 |
기본 설정
이 사전 빌드 구성요소를 설정하려면 다음 안내를 따르세요.
완료
이제 에이전트가 설정되었고 테스트할 준비가 되었습니다.