이 사전 빌드된 구성요소는 공백, 하이픈 또는 애포스트로피와 함께 이름, 성, 중간 이름(선택사항)을 캡처합니다.
제한사항
사전 빌드된 구성요소에는 일반적인 사전 빌드된 구성요소 제한사항 외에도 다음과 같은 제한사항이 있습니다.
- 공백, 애포스트로피, 하이픈 이외의 특수문자가 포함된 이름은 이 구성요소에서 지원되지 않습니다.
추가 기능
이 사전 빌드된 구성요소에는 다음과 같은 추가 기능이 제공됩니다.
샘플 대화상자
다음 샘플 대화상자에서는 사전 빌드된 구성요소에서 처리하는 일반적인 시나리오를 보여줍니다. 샘플 대화상자는 전화를 통해 구성요소가 호출될 때 기본 시작 인텐트와 대화 시작 시 첫 번째 에이전트 응답을 트리거하는 동작을 보여줍니다.
이름
최종 사용자가 첫 번째 차례에 전체 이름을 제공하고 에이전트가 이를 수락합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 이름이 무엇인가요? 이름, 성, 중간 이름이 있으면 알려주세요. | |
| 순다르 피차이 | |
| 귀하의 이름은 순다르이고 성은 피차이입니다. 성명이 올바른가요? | |
| 예 | |
| 중간 이름이 있나요? | |
| 아니요 | |
| 순다르님, 감사합니다. |
전체 이름의 부분
최종 사용자가 첫 번째 시도에서 전체 이름을 제공할 수 없습니다. 그런 다음 최종 사용자가 이름, 성, 중간 이름을 각각 입력하고 에이전트가 이를 수락합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 이름이 무엇인가요? 이름, 성, 중간 이름이 있으면 알려주세요. | |
| nice | |
| 죄송하지만 이해하지 못했습니다. 이름을 다시 캡처해 보겠습니다. 이름을 캡처하기 전에 이름에 하이픈, 여백이 너무 많거나, 애포스트로피가 있는지 확인해 주시겠어요? |
|
| 아니요 | |
| 먼저 이름을 캡처합니다. 이름이 무엇인가요? |
|
| 로렌스 | |
| 로렌스 이름이 올바른가요? | |
| 예 | |
| 성이 무엇인가요? | |
| 페이지 | |
| 페이지 성이 올바른가요? | |
| 예 | |
| 중간 이름이 있나요? | |
| 예 | |
| 중간 이름이 무엇인가요? | |
| Edward | |
| 에드워드 중간 이름이 올바른가요? | |
| 예 | |
| 로렌스님, 감사합니다. |
특수문자
최종 사용자가 첫 번째 시도에서 전체 이름을 제공할 수 없습니다. 그런 다음 최종 사용자가 특수 문자를 사용하여 이름, 성, 중간 이름을 별도로 입력합니다. 에이전트가 이를 수락합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 이름이 무엇인가요? 이름, 성, 중간 이름이 있으면 알려주세요. | |
| nice | |
| 죄송하지만 이해하지 못했습니다. 이름을 다시 캡처해 보겠습니다. 이름을 캡처하기 전에 이름에 하이픈, 여백이 너무 많거나 애포스트로피가 있는지 확인해 주시겠어요? |
|
| 예, 있습니다. | |
| 알겠습니다. 이러한 특수문자가 이름, 중간 이름 또는 성 중 어디에 있나요? | |
| 이름 | |
| 이름에서 특수문자 앞의 첫 부분을 알려주세요. | |
| Evan | |
| 에반입니다. 첫 번째 부분의 철자가 맞나요? | |
| 예 | |
| 다음에 오는 공백, 아포스트로피 또는 하이픈을 알려주세요. | |
| 하이픈 | |
| '하이픈'입니다. 이름의 첫 번째 부분 뒤의 이름 구분 기호를 올바르게 캡처했나요? | |
| 예 | |
| 하이픈 뒤의 이름 뒷부분을 알려주세요. J-O-H-N과 같이 문자만 말합니다. | |
| 제임스 | |
| 제임스입니다. 틀렸는지, 이게 다인지, 다음은 무엇인지(공백, 아포스트로피, 하이픈) 알려주세요. | |
| 완료했습니다 | |
| 성이 무엇인가요? | |
| Mady | |
| 매디입니다. 성이 올바른가요? | |
| 예 | |
| 중간 이름이 있나요? | |
| 아니요 | |
| 에반-제임스님, 감사합니다. |
입력 없음
최종 사용자가 입력을 세 번 제공하지 않으면 구성요소에서 흐름을 종료합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 이름이 무엇인가요? 이름, 성, 중간 이름이 있으면 알려주세요. | |
| [No-input] | |
| 죄송합니다. 잘 들리지 않았습니다. 이름이 무엇인가요? | |
| [No-input] | |
| 아직도 듣지 못했습니다. 더 크게 말하거나 조용한 곳으로 이동해 주세요. | |
| [No-input] | |
| 죄송합니다. 고객님의 답변을 이해하기 어렵습니다. |
이름 지정 규칙
이 사전 빌드 구성요소는 다음 이름 지정 규칙을 사용합니다.
| 기능 | 형식 | 예 |
|---|---|---|
| 흐름 | [구성요소 이름] | 이름 수집 |
| 구성요소별 인텐트 | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_name_collection_special_characters_decider |
| 항목 유형 | prebuilt_components_[component_name]_[entity_type_name] | prebuilt_components_name_collection_first_name |
| 매개변수 | [param_name] | user_provided_first_name |
출력 매개변수
출력 매개변수는 구성요소를 종료한 후에도 활성 상태로 유지되는 세션 매개변수입니다. 이러한 매개변수에는 구성요소에 의해 수집된 중요한 정보가 포함됩니다. 이 사전 빌드 구성요소는 다음 출력 매개변수의 값을 제공합니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| name_collection_first_name | 이 매개변수는 구성요소에서 캡처한 사용자가 제공한 이름을 반환합니다. | 문자열 |
| name_collection_last_name | 이 매개변수는 구성요소에서 캡처한 사용자가 제공한 성명을 반환합니다. | 문자열 |
| name_collection_middle_name | 이 매개변수는 구성요소에서 캡처한 사용자가 제공한 중간 이름을 반환합니다. 중간 이름이 수집되지 않으면 매개변수가 빈 문자열이 됩니다. | 문자열 |
기본 설정
이 사전 빌드 구성요소를 설정하려면 다음 안내를 따르세요.
완료
이제 에이전트가 설정되었고 테스트할 준비가 되었습니다.