Antes de experimentar este tutorial, deve conhecer as noções básicas do Dialogflow abordadas nos Inícios rápidos.
Crie um agente
Use a consola Dialogflow ES para criar um agente denominado "PackageTracker". Se não souber como o fazer, reveja os inícios rápidos.
Se preferir trabalhar com um agente existente, também não há problema. Certifique-se de que ativa a adaptação automática da voz nas definições do agente. Esta opção está ativada por predefinição para novos agentes.
Crie uma entidade de reconhecimento de sequências
A função essencial deste agente é compreender sequências alfanuméricas através da voz. Especificamente, vai configurar o agente para ouvir alguns carateres de cada vez e, eventualmente, juntar todas as subsequências antes de validar a sequência final num armazenamento de dados. Vamos começar por definir uma entidade para reconhecer as sequências parciais.
Crie as entidades de sequência de regexp
Temos de usar uma entidade regexp para capturar sequências, de modo que a adaptação automática da voz saiba que tem de ouvir "ABC" em vez de "a bee sea".
Estas entidades têm de estar em conformidade com as diretrizes de entidades de expressões regulares de adaptação automática da voz para garantir que o reconhecimento de voz está otimizado para reconhecer sequências escritas.
Entidade de sequência parcial
Vamos configurar a entidade para aceitar qualquer sequência alfanumérica de, pelo menos, 3 carateres. Mais tarde, vai adicionar um webhook para poder validar a sequência final em relação a um repositório de dados ou uma API.
- Crie uma nova entidade. Vamos chamá-lo de "alfanumérico" porque aceita qualquer entrada alfanumérica.
- Selecione a caixa Entidade de expressão regular
- Adicione uma única entrada,
^[a-zA-Z0-9]{3}[a-zA-Z0-9]*$ - Clique em GUARDAR.
Repare que a expressão regular que adicionou é muito rigorosa, pois procura apenas uma string de carateres alfanuméricos, sem espaços nem travessões. Isto é importante por dois motivos:
- Esta expressão regular segue os requisitos de adaptação automática da voz para ativar o modo de reconhecimento "sequência detalhada".
- Ao não procurar espaços e procurar apenas frases completas (
^...$), permite que os utilizadores finais saiam facilmente do reconhecimento de sequências. Por exemplo, quando pergunta "qual é o seu número de encomenda" e um utilizador final responde "não, quero fazer uma encomenda", a expressão regular é rejeitada e o Dialogflow sabe que deve procurar outra intenção que possa corresponder a essa frase.
Se só tiver interesse em valores numéricos, pode criar uma entidade mais personalizada, como [0-9]{3}[0-9]*, ou até usar a entidade @sys.number-sequence integrada.
O resto do tutorial pressupõe que está a recolher sequências alfanuméricas. Aceda à secção seguinte para ver como configurar intenções para recolher estas sequências.