Coletar entrada

Um bloco Coletar entrada pode ser usado para obter informações do usuário. Quando o usuário fornece informações, o bot primeiro verifica se elas correspondem a uma variável já conhecida.

Adicione um Coletar entrada bloco por arrastando e soltando-o no seu fluxo.

aba Coletar entrada.

Um Coletar entrada obtém informações do usuário, as verifica e as salva como uma variável.

Como um bloco Coletar entrada aparece no canvas.

Um Coletar entrada normalmente fará 3 coisas:

• definindo qual tipo de entrada você está analisando

• verificando se a resposta do usuário corresponde

• configurando o comportamento do seu bot depois disso

Adicione uma etapa de pergunta

Um bloco Coletar entrada deve pedir claramente ao usuário alguma informação.

Faça uma pergunta ao usuário.

Capturar a resposta do usuário como

A Coletar entrada primeiro verifica se a entrada corresponde a uma tipo de entrada.

Verifique se a entrada do usuário corresponde.

Para bots de voz, certifique-se de usar o voiceMessage tipo de entrada.

Se for o caso, a Coletar entrada salva essa entrada em uma variável de destino.

Salve a entrada correspondente em uma variável.

Tipos de entrada

Coletar entrada blocos têm 3 tipos de reconhecimento de entrada:

• Geral tipos de entrada para verificar se a entrada segue um formato desejado.

• Sistema tipos de entrada para verificar se a entrada segue uma determinada entidade interna do Chatlayer.

• Entidade tipos de entrada para verificar a entrada do usuário com uma entidade do bot entidade.

O Chatlayer extrai dados das entradas do usuário. Por exemplo, se um plugin de entrada tiver o tipo data e a entrada for 'Preciso estar em Paris em dois dias', o parser identificará 'em dois dias' como a data. Ele converte isso para o formato DD-MM-AAAA e armazena o resultado na sessão do usuário.

Observe que o número de entidades do sistema que você pode usar dentro de um Coletar entrada bloco é limitado. As entidades do sistema que você pode usar dentro desses blocos são: sys.email, sys.phone_number, sys.url, sys.number e sys.time.

Entrada geral

A Geral tipo de entrada verifica se a entrada segue um formato desejado.

Qualquer

A Qualquer tipo de entrada aceitará todos os valores de string como entrada.

É importante saber que intenções e entidades são processadas antes dos parsers. Isso pode ser útil para extrair automaticamente certas partes de uma frase como resposta a uma pergunta. Fornecemos um ótimo exemplo disso em nosso tutorial.

Data

A Data tipo de parser de entrada analisará a resposta como uma data. Frases como 'segunda-feira da próxima semana' são convertidas automaticamente para um objeto de data DD-MM-AAAA. Os formatos suportados (também em outros idiomas de PLN suportados) são:

• 22-04-2018

• 22-04

• 22 abr

• 22 abril 18

• vinte e dois de abril de 2018

• ontem

• hoje

• agora

• na noite passada

• amanhã, tmr

• em duas semanas

• em 3 dias

• próxima segunda-feira

• sexta-feira da próxima semana

• segunda-feira passada/anterior

• semana passada/anterior

• dentro de/em 5/cinco dias

• sexta-feira/sex

Imagem

A Imagem tipo de formato permite verificar se um usuário enviou uma imagem ou outro arquivo (como PDF).

A imagem será salva como um array. Se você escolheu {img} como variável, isso significa que você deve usar {img[0]} para recuperar a URL da primeira imagem salva.

Para o widget de chat (canal web), recomendamos usar a envio de arquivo etapa.

Para salvar um anexo do usuário em qualquer ponto do fluxo, use a defaultOnFileUpload variável. Essa variável armazenará a URL do anexo enviado pelo usuário, independentemente de onde ele esteja na conversa.

Localização

A Localização o parser envia a entrada do usuário para um serviço da API do Google Geocoding. Quando um endereço ou local correto é reconhecido, a plataforma Chatlayer criará automaticamente um objeto que contém todos os dados geográficos relevantes.

Veja o bloco acima. Quando o usuário responde à pergunta "Onde você trabalha?" com uma localização válida, essa informação será armazenada como uma userLocationInformed variável (você pode renomear essa variável se necessário).

Abaixo está um exemplo que mostra como a userLocationInformed variável seria armazenada quando o usuário responder com 'Chatlayer.ai':

{
    fullAddress: "Oudeleeuwenrui 39, 2000 Antwerpen, Bélgica",
    latitude: 51.227317,
    longitude: 4.409155999999999,
    streetNumber: "39",
    streetName: "Oudeleeuwenrui",
    city: "Antwerpen",
    country: "Bélgica",
    zipcode: "2000",
}

Para mostrar o endereço como um endereço completo (rua, número, CEP e cidade), você precisa adicionar algumas informações extras à variável: .fullAddress

Então, no exemplo acima, o bot pode exibir a localização completa usando a seguinte variável:{userLocationInformed.fullAddress}

Uma mensagem do bot contendo as seguintes informações:

Obrigado, devo enviar seu pacote para {userLocationInformed.fullAddress}?

Exibirá a seguinte mensagem para o usuário:

Obrigado, devo enviar seu pacote para Oudeleeuwenrui 39, 2000 Antwerpen, Bélgica?

Idioma

Este tipo de entrada analisará e validará idiomas suportados por PLN.

• Inglês: (en-us): 'inglês', 'English', 'en', 'anglais'

• Holandês (nl-nl): 'nederlands', 'holandês', 'ned', 'nl', 'vlaams', 'hollands', 'be', 'ned', 'néerlandais', 'belgisch'

• Francês (fr-fr): 'francês', 'français', 'frans', 'fr', 'francais'

• Chinês (zh-cn): 'chinês', 'cn', 'zh', 'chinees'

• Espanhol (es-es): 'espanhol', 'español', 'es', 'spaans'

• Italiano (it-it): 'italiano', 'italiano', 'italiano', 'it

• Alemão (de-de): 'alemão', 'duits', 'de', 'deutsch

• Japonês (ja-jp): 'japonês', 'japans', 'jp', '日本の

• Português do Brasil (pt-br): 'português do Brasil', 'português', 'português', 'português brasileiro', 'português'

voiceMessage

Use o voiceMessage tipo de entrada para salvar mensagens do canal de voz como texto. Configure a duração máxima e o tempo de conclusão dessas mensagens.

Horas

Este tipo de entrada analisará e validará carimbos de data/hora.

Entrada de entidade do sistema

A Coletar entrada o parser pode verificar se a entrada fornecida é consistente com o formato de uma das seguintes entidades do sistema. Sempre que uma entidade do sistema for escolhida na lista suspensa 'Verificar se a resposta corresponde', você pode dar à variável um nome que funcione para você.

Renomeie a variável que corresponde ao parser de entidade do sistema.

🆕 Reconhecimento de entidades do sistema baseado em LLM

Seu bot agora é capaz de reconhecer entidades do sistema dependendo do contexto da conversa, usando tecnologia LLM.

Por enquanto, este recurso está disponível apenas para entidades do sistema.

Por exemplo:

1. Acesse o seu bot Configurações.

2. Em IA generativa, clique no botão ao lado de Ativar recursos de IA generativa.

3. Ativar Reconhecimento de entidades baseado em LLM.

1. Clique em Salvar.

2. Volte para o seu Fluxos.

3. Crie um Coletar entrada que verifica o número de passageiros e confere se corresponde a uma entrada @sys.number.

1. Exiba essa variável no próximo bloco.

2. Teste o bot: agora o bot reconhece frases mais complexas como o número correto de pessoas!

Entrada de entidade

Depois de criar uma entidade, você pode verificar se a entrada do usuário corresponde a ela.

Saiba mais sobre qual tipo de entidade se adapta ao seu caso de uso.

Verifique se a entrada corresponde a

Um bloco Coletar entrada verifica se a resposta do usuário corresponde a uma variável já conhecida:

• Se a variável ainda não tiver um valor, o bot fará a pergunta escrita no bloco Coletar entrada. Nesse ponto, ou:

  • O valor corresponde a, e a variável é preenchida.

  • O valor não corresponde a, e as perguntas de fallback são feitas.

  • O usuário não responde, e você decide detectar esse silêncio.

• Se a variável já tiver um valor, o bot pulará automaticamente o bloco Coletar entrada.

Quando a resposta do usuário corresponder a

Se a resposta corresponder no momento em que o Coletar entrada for acionado, ela será salva corretamente sob o nome de variável especificado no depurador.

Se o bloco Coletar entrada for pulado, isso ocorre porque a variável já é conhecida. As variáveis podem já ser conhecidas por vários motivos:

• O usuário já respondeu a esta pergunta antes.

• Uma entidade anterior foi detectada com o mesmo nome de variável.

• O usuário está autenticado e a variável foi definida automaticamente.

🆕 Quando a resposta do usuário não corresponde

Quando o usuário fornece uma resposta inválida, o bot deve informar ao usuário que sua resposta era inválida.

Tentativas

Defina quantas vezes você quer que o bot faça a pergunta novamente. Normalmente, isso apenas pediria para reformular.

Configure as tentativas dentro dos blocos Coletar entrada.

Fallback

Configure uma mensagem de fallback para onde redirecionar o usuário quando ele já tiver usado todas as tentativas. Normalmente, isso levaria ao suporte ao cliente, por exemplo.

Configure um fallback após X tentativas.

Sem resposta

Você pode configurar o bot para detectar quando um usuário permanece em silêncio por um período específico. Ele aciona um bloco específico quando nenhuma resposta é recebida dentro do prazo definido ou até um horário predeterminado.

Você pode definir quanto tempo leva para o novo bloco ser acionado no campo de duração (em minutos ou em um horário específico). A duração do silêncio pode ser de 1 minuto até 1440 minutos (24 horas).

Você pode escolher entre 'aguardar por' ou 'aguardar até' a resposta do usuário antes de acionar um bloco

Capturar a resposta do usuário como

A parte inferior do seu bloco Coletar entrada pode ser configurada para que você tenha certeza de detectar a resposta que procura.

Desativar PLN

Os usuários podem sair do Coletar entrada se uma intenção for reconhecida. Para bots com um modelo de PLN muito pequeno, isso pode gerar um falso positivo. A caixa de seleção 'desativar PLN' permite desativar o modelo de PLN enquanto estiver no Coletar entrada, garantindo que tudo o que o usuário disser seja salvo como entrada.

Para variável de data: sempre passado - sempre futuro

Quando você decide verificar uma data variável, o Chatlayer analisa a expressão do usuário para corresponder a um formato de data padrão. Se a data que você solicitar deve estar sempre no presente ou no futuro, você pode usar estas opções. Um usuário dizendo “quinta-feira”, por exemplo, será mapeado para a última ou a próxima quinta-feira.