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. Escreva 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 confirmar se há hifens, espaços extras ou apóstrofes nele?
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.