Nomear o componente pré-criado da coleção

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

Limitações

Além das limitações comuns dos componentes pré-criados, esse componente tem as seguintes limitações:

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

Outros recursos

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

Diálogos de exemplo

Os diálogos de exemplo a seguir demonstram cenários comuns processados por esse componente pré-criado. Os diálogos 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 vez, e o agente o aceita.

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

Nome completo em partes

O usuário final não consegue fornecer um nome completo na primeira tentativa. Em seguida, o usuário final informa o nome, o sobrenome e o nome do meio em turnos separados, e o agente o aceita.

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

Caracteres especiais

O usuário final não consegue fornecer um nome completo na primeira tentativa. Em seguida, o usuário final informa o nome, o sobrenome e o nome do meio em turnos separados com caracteres especiais, e o agente o aceita.

Entrada do usuário Resposta do agente
Qual é seu nome completo? Informe seu nome, sobrenome e nome do meio, se tiver um.
legal
Não entendi. Vamos começar a capturar o nome novamente.
Antes de capturar seu nome, você pode me ajudar a confirmar se tem hifens, espaços extras ou apóstrofos no seu nome?
Sim, eu tenho
Entendi. Esses caracteres especiais estão no seu nome, sobrenome ou nome do meio?
Nome
Informe a primeira parte do seu nome antes de qualquer caractere especial.
Evan
Evan. Eu escrevi a primeira parte corretamente?
sim
Informe o que vem a seguir: um espaço, um apóstrofo ou um hífen.
hífen
"hífen". Eu capturei o separador de nome após a primeira parte do seu nome corretamente?
sim
Informe a próxima parte do seu nome, após o hífen. Diga apenas as letras, por exemplo, J-O-H-N.
Paulo
Paulo. Diga 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. Eu escrevi seu sobrenome corretamente?
sim
Você tem um nome do meio?
não
Obrigado, Evan-James.

Sem entrada

O componente sai do fluxo depois que o usuário final não fornece 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 um.
[Sem entrada]
Não consegui ouvir você. Qual é seu nome completo?
[Sem entrada]
Ainda não consigo ouvir você. Tente falar mais alto ou vá para um local mais silencioso.
[Sem entrada]
Não estou conseguindo entender sua resposta.

Convenções de nomenclatura

Esse componente pré-criado usa as seguintes convenções de nomenclatura:

Recurso Formato Exemplo
Flow [Nome do componente] Coleta de nomes
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 [nome_do_parâmetro] 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 pré-criado 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 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 agora está configurado e pronto para teste.