Coletar entrada

Um bloco Collect input pode ser usado para obter informações do usuário. Quando o usuário fornece informações, o bot verificará primeiro se a informação corresponde a uma variável já conhecida.

Adicionar 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, verifica-as e as salva como uma variável.

Como um bloco Coletar entrada se parece na tela.

Um Coletar entrada normalmente fará 3 coisas:

Adicionar um passo de pergunta

Um Coletar entrada deve claramente pedir ao usuário por alguma entrada.

Faça uma pergunta ao usuário.

Capturar resposta do usuário como

O Coletar entrada primeiro verifica se a entrada corresponde a um tipo de entrada.

Verifique se a entrada do usuário corresponde.

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

Se sim, o Coletar entrada salva essa entrada sob uma variável de destino.

Salvar a entrada que corresponde 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 entidade integrada do Chatlayer.

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

Entrada Geral

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

Qualquer

O 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. Nós fornecemos um ótimo exemplo disso em nosso tutorial.

Data

O Data o tipo de parser de entrada irá analisar a resposta como uma data. Sentenças como 'próxima segunda-feira' são automaticamente convertidas para um objeto de data DD-MM-YYYY. Formatos suportados (também em outras linguagens NLP suportadas) são:

  • 22-04-2018

  • 22-04

  • 22 abr

  • 22 abril 18

  • vinte e dois de abril de 2018

  • ontem

  • hoje

  • agora

  • ontem à noite

  • amanhã, amnh

  • em duas semanas

  • em 3 dias

  • próxima segunda

  • próxima sexta da semana

  • última/passada segunda

  • última/passada semana

  • dentro/em 5/cinco dias

  • Sexta/SEX

Imagem

O Imagem o tipo de formato permite verificar se um usuário carregou uma imagem ou outro arquivo (como pdf).

A imagem será salva como um array. Se você escolher {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 o passo de envio de arquivo .

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

Localização

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

Check the user location.

Olhe para 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 variável userLocationInformed (você pode renomear essa variável se necessário).

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

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

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

Então, no exemplo acima, o bot pode exibir a localização inteira 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 ao usuário:

Obrigado, devo enviar seu pacote para Oudeleeuwenrui 39, 2000 Antwerpen, Belgium?

Idioma

Este tipo de entrada irá analisar e validar línguas suportadas pelo NLP.

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

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

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

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

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

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

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

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

  • Português do Brasil (pt-br): 'Brazil Portugese', 'Portugese', 'portugees', 'braziliaans portugees', '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 para essas mensagens.

Horas

Este tipo de entrada irá analisar e validar marcações de tempo.

Entrada de entidade do sistema

O Coletar entrada o parser pode verificar se a entrada fornecida é consistente com o formato de um dos seguintes entidades do sistema. Sempre que uma entidade do sistema é escolhida no menu '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 entidade 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. Vá para o seu bot Configurações.

  2. Em IA Generativa, clique no interruptor ao lado de Ativar recursos de IA generativa.

  3. Ativar Reconhecimento de entidade baseado em LLM.

  1. Clique Salvar.

  2. Volte para o seu Fluxos.

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

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

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

Entrada de entidade

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

Saiba mais sobre quais tipo de entidade se adequa ao seu caso de uso.

Verifique se a entrada corresponde

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. Neste ponto, ou:

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

Quando a resposta do usuário corresponde

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

🆕 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 foi inválida.

Retentativas

Configure quantas vezes você quer que o bot faça a pergunta novamente. Tipicamente, isso apenas pedirá para reformular.

Configure Retentativas dentro dos blocos Coletar entrada.

Fallback

Configure uma mensagem de fallback para onde redirecionar o usuário quando o usuário já tiver usado todas as suas retentativas. Tipicamente, isso levaria a ajuda do suporte ao cliente, por exemplo.

Configure um fallback após X retentativas.

Sem resposta

Você pode configurar o bot para detectar quando um usuário permanece em silêncio por um período especificado. Isso 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 selecionar entre 'aguardar por' ou 'aguardar até' a resposta do usuário antes de acionar um bloco

Capturar 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 está procurando.

Desativar NLP

Os usuários podem sair do Coletar entrada se uma intenção for reconhecida. Para bots com um modelo NLP muito pequeno, isso pode acionar um falso positivo. A caixa de seleção 'desativar NLP' permite que você desative o modelo NLP enquanto estiver no Coletar entrada, o que garante que o que quer que o usuário diga 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ê pede deve sempre estar no presente ou futuro, você pode usar essas opções. Um usuário dizendo “quinta-feira”, por exemplo, será mapeado para a quinta-feira passada ou próxima.

Last updated

Was this helpful?