Nomear o componente pré-criado da coletânea

Esse componente pré-criado captura o nome, o sobrenome e o nome do meio opcionais, além de espaços, hifens ou apóstrofos.

Limitações

Além das limitações comuns de componentes predefinidos, este componente predefinido tem as seguintes limitações:

  • Nomes com caracteres especiais, exceto espaços, apóstrofes e hifens, não são aceitos por esse componente.

Outros recursos

Este componente pré-criado oferece as seguintes funcionalidades adicionais:

Exemplos de diálogos

As caixas de diálogo de exemplo a seguir demonstram cenários comuns processados por esse componente pré-criado. As caixas de diálogo de exemplo demonstram o comportamento quando o componente é chamado por telefonia, o que aciona a intent de boas-vindas padrão e a primeira resposta do agente no início da conversa.

Nome completo

O usuário final fornece um nome completo na primeira fala, e o agente aceita.

Entrada do usuário Resposta do agente
Qual é seu nome completo? Informe seu nome, sobrenome e nome do meio, se tiver.
Sundar Pichai
Para confirmar, seu primeiro nome é Sundar e seu sobrenome é Pichai. Escrevai seu nome completo corretamente?
Sim
Você tem um nome do meio?
não
Agradeço, Sundar.

Nome completo em partes

O usuário final não consegue informar o nome completo na primeira tentativa. O usuário final informa o nome, o sobrenome e o nome do meio em turnos separados. O agente aceita a informação.

Entrada do usuário Resposta do agente
Qual é seu nome completo? Informe seu nome, sobrenome e nome do meio, se tiver.
legal
Não entendi. Vamos começar a capturar o nome de novo.
Antes de capturar seu nome, poderia me ajudar a confirmar se você tem hifens, espaços extras ou apóstrofes no seu nome?
Não
Vamos começar capturando seu nome.
Qual é seu nome?
Lawrence
Lawrence. Escrevemos seu nome corretamente?
sim
Qual é seu sobrenome?
Página
Página. Escreva seu sobrenome corretamente?
sim
Você tem um nome do meio?
sim
Qual é seu nome do meio?
Edward
Edward. Escrevai seu nome do meio corretamente?
sim
Agradeço, Lawrence.

Caracteres especiais

O usuário final não consegue informar o nome completo na primeira tentativa. O usuário final informa o primeiro, o último e o nome do meio em turnos separados com caracteres especiais. O agente aceita.

Entrada do usuário Resposta do agente
Qual é seu nome completo? Informe seu nome, sobrenome e nome do meio, se tiver.
legal
Não entendi. Vamos começar a capturar o nome de novo.
Antes de capturar seu nome, poderia me ajudar a confirmar se você tem hifens, espaços extras ou apóstrofes no seu nome?
Sim
Ok. Esses caracteres especiais estão no seu nome, nome do meio ou sobrenome?
Nome
Informe a primeira parte do seu nome antes dos caracteres especiais.
Evan
Evan. A primeira parte foi escrita corretamente?
sim
Diga o que vem a seguir: um espaço, um apóstrofo ou um hífen.
hífen
"hífen". Consegui capturar o separador de nome após a primeira parte do seu nome corretamente?
sim
Soletre a próxima parte do seu nome, depois do hífen. Diga apenas as letras, por exemplo, J-O-H-N.
Paulo
James. Informe se isso está errado, se é o fim ou o que vem a seguir: um espaço, um apóstrofo ou um hífen.
Terminei
Qual é seu sobrenome?
Mady
Mady. Escreva seu sobrenome corretamente?
sim
Você tem um nome do meio?
não
Agradeço, Evan-James.

Sem entrada

O componente sai do fluxo depois que o usuário final não fornece nenhuma entrada três vezes.

Entrada do usuário Resposta do agente
Qual é seu nome completo? Informe seu nome, sobrenome e nome do meio, se tiver.
[No-input]
Não consegui ouvir você. Qual é seu nome completo?
[No-input]
Humm, ainda não consigo ouvir você. Tente falar mais alto ou vá para um local mais silencioso.
[No-input]
Não estou conseguindo entender sua resposta.

Convenções de nomenclatura

Esse componente predefinido usa as seguintes convenções de nomenclatura:

Recurso Formato Exemplo
Fluxo [Nome do componente] Nome da coleção
Intent específica do componente prebuilt_components_[component_name]_[intent_name] prebuilt_components_name_collection_special_characters_decider
Tipo da entidade prebuilt_components_[component_name]_[entity_type_name] prebuilt_components_name_collection_first_name
Parâmetro [param_name] user_provided_first_name

Parâmetros de saída

Os parâmetros de saída são parâmetros de sessão que permanecem ativos após a saída do componente. Esses parâmetros contêm informações importantes coletadas pelo componente. Esse componente predefinido fornece valores para os seguintes parâmetros de saída:

Nome do parâmetro Descrição Formato da saída
name_collection_first_name Esse parâmetro retorna o primeiro nome fornecido pelo usuário que é capturado pelo componente. string
name_collection_last_name Esse parâmetro retorna o sobrenome fornecido pelo usuário que é capturado pelo componente. string
name_collection_middle_name Esse parâmetro retorna o nome do meio fornecido pelo usuário que é capturado pelo componente. Se nenhum nome do meio for coletado, o parâmetro será uma string vazia. string

Configuração básica

Para configurar esse componente pré-criado:

  1. Importe o componente pré-criado.

Concluído

Seu agente está configurado e pronto para ser testado.