영숫자 컬렉션 사전 빌드된 구성요소는 사용자로부터 영숫자 시퀀스를 수집합니다. 입력 매개변수를 사용하면 허용되는 최소 및 최대 길이를 구성할 수 있습니다.
이 구성요소는 대화할 때마다 사용자로부터 텍스트 조각을 캡처하고 이를 연결해서 최종 시퀀스를 만듭니다. 입력 매개변수를 사용하면 조각별로 허용되는 최소 및 최대 길이를 구성할 수 있습니다.
시퀀스 캡처는 사용자가 prebuilt_components_confirmation_done intent와 일치하는 입력을 제공하여 시퀀스를 완료했음을 나타낼 때까지 계속됩니다.
음성 기호
이 구성요소는 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입니다. 맞나요? | |
| 예 | |
| 좋습니다. 영숫자 시퀀스가 수집되었습니다. |
여러 단위
- 사용자가 두 개의 조각으로 영숫자 시퀀스를 제공합니다.
- 에이전트가 이를 성공적으로 수락합니다.
| 사용자 입력 | 에이전트 대답 |
|---|---|
| 영숫자 시퀀스의 처음 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이 입력되었습니다. 맞나요? | |
| 아니요 | |
| 죄송하지만 재시도 횟수가 너무 많아서 영숫자 시퀀스를 입력할 수 없습니다. |
음성 기호
- 사용자가 영숫자 시퀀스를 제공합니다.
- 에이전트가 사용자에게 재확인을 수행합니다.
- 사용자가 확인에 대해 '아니요'라고 말하면 에이전트가 사용자에게 다시 프롬프트를 표시합니다.
- 사용자가 확인에 대해 다시 '아니요'라고 말하면 에이전트가 음성 변환을 사용 설정합니다.
- 사용자가 음성 변환을 사용하여 영숫자 시퀀스를 제공합니다.
- 에이전트가 영숫자 시퀀스를 성공적으로 수락합니다.
| 사용자 입력 | 에이전트 대답 |
|---|---|
| 영숫자 시퀀스의 처음 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 | 이 매개변수는 구성요소가 캡처한 영숫자 시퀀스를 반환합니다. | 문자열 |
기본 설정
이 사전 빌드 구성요소를 설정하려면 다음 안내를 따르세요.
완료
이제 사전 빌드된 구성요소가 설정되었고 테스트할 준비가 되었습니다.