이 사전 빌드된 구성요소는 공백, 하이픈 또는 아포스트로피와 함께 이름, 성, 선택적 중간 이름을 캡처합니다.
제한사항
사전 빌드된 구성요소에는 일반적인 사전 빌드된 구성요소 제한사항 외에도 다음과 같은 제한사항이 있습니다.
- 공백, 아포스트로피, 하이픈 이외의 특수문자는 이 구성요소에서 지원되지 않습니다.
추가 기능
이러한 사전 빌드된 구성요소는 다음과 같은 추가 기능을 제공합니다.
샘플 대화상자
다음 샘플 대화상자에서는 사전 빌드된 구성요소에서 처리하는 일반적인 시나리오를 보여줍니다. 샘플 대화상자는 전화를 통해 구성요소가 호출될 때 기본 시작 인텐트와 대화 시작 시 첫 번째 에이전트 응답을 트리거하는 동작을 보여줍니다.
이름
최종 사용자가 첫 번째 차례에서 전체 이름을 제공합니다. 에이전트가 이를 수락합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 이름이 무엇인가요? 이름, 성, 중간 이름이 있으면 알려주세요. | |
| 순다르 피차이 | |
| 귀하의 이름은 순다르이고 성은 피차이입니다. 전체 이름을 올바르게 입력했나요? | |
| 예 | |
| 중간 이름이 있나요? | |
| 아니요 | |
| 순다르님, 감사합니다. |
전체 이름의 부분
최종 사용자가 첫 시도에서 전체 이름을 제공할 수 없습니다. 그러면 최종 사용자가 이름, 성, 중간 이름을 차례대로 제공합니다. 에이전트가 이를 수락합니다
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 이름이 무엇인가요? 이름, 성, 중간 이름이 있으면 알려주세요. | |
| nice | |
| 죄송하지만 이해하지 못했습니다. 이름을 다시 캡처해 보겠습니다. 이름을 캡처하기 전에 이름에 하이픈, 추가 공백, 아포스트로피가 있는지 확인해 주시겠어요? |
|
| 아니요 | |
| 먼저 이름을 캡처합니다. 이름이 무엇인가요? |
|
| 로렌스 | |
| 로렌스 이름이 올바른가요? | |
| 예 | |
| 성이 무엇인가요? | |
| 페이지 | |
| 페이지 성이 올바른가요? | |
| 예 | |
| 중간 이름이 있나요? | |
| 예 | |
| 중간 이름이 무엇인가요? | |
| Edward | |
| 에드워드 중간 이름이 올바른가요? | |
| 예 | |
| 로렌스님, 감사합니다. |
특수문자
최종 사용자가 첫 시도에서 전체 이름을 제공할 수 없습니다. 그러면 최종 사용자가 이름, 성, 중간 이름을 특수문자와 함께 차례대로 제공합니다. 에이전트가 이를 수락합니다
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 이름이 무엇인가요? 이름, 성, 중간 이름이 있으면 알려주세요. | |
| nice | |
| 죄송하지만 이해하지 못했습니다. 이름을 다시 캡처해 보겠습니다. 이름을 캡처하기 전에 이름에 하이픈, 추가 공백, 아포스트로피가 있는지 확인해 주시겠어요? |
|
| 예, 있습니다. | |
| 알겠습니다. 이러한 특수문자가 이름, 중간 이름 또는 성 중 어디에 있나요? | |
| 이름 | |
| 이름에서 특수문자 앞의 첫 부분을 알려주세요. | |
| Evan | |
| 에반입니다. 첫 번째 부분을 올바르게 작성했나요? | |
| 예 | |
| 다음에 오는 공백, 아포스트로피 또는 하이픈을 알려주세요. | |
| 하이픈 | |
| '하이픈'입니다. 이름의 첫 번째 부분 뒤의 이름 구분 기호를 올바르게 캡처했나요? | |
| 예 | |
| 하이픈 뒤의 이름 뒷부분을 알려주세요. J-O-H-N과 같이 문자만 말합니다. | |
| 제임스 | |
| 제임스입니다. 틀렸는지, 이게 다인지, 다음은 무엇인지(공백, 아포스트로피, 하이픈) 알려주세요. | |
| 완료 | |
| 성이 무엇인가요? | |
| 매디 | |
| 매디입니다. 성이 올바른가요? | |
| 예 | |
| 중간 이름이 있나요? | |
| 아니요 | |
| 에반-제임스님, 감사합니다. |
입력 없음
최종 사용자가 입력을 3회 제공하지 않으면 구성요소가 흐름을 종료합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 이름이 무엇인가요? 이름, 성, 중간 이름이 있으면 알려주세요. | |
| [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 | 이 매개변수는 구성요소에서 캡처하는 사용자 제공 중간 이름을 반환합니다. 중간 이름이 수집되지 않으면 매개변수는 빈 문자열입니다. | 문자열 |
기본 설정
이 사전 빌드된 구성요소를 설정하려면 다음 안내를 따르세요.
완료
이제 에이전트가 설정되었고 테스트할 준비가 되었습니다.