> For the complete documentation index, see [llms.txt](https://tilus.gitbook.io/konversas-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tilus.gitbook.io/konversas-doc/assistente-ia/intencoes.md).

# Intenções

Intenções são um recurso exclusivo do Konversas que usa agentes de IA qie monitoram a conversa e identificam intenções dos usuários e tomam ações a partir dela. Por exemplo identificar quando usuário quer transferir para uma pessoa ou quando ele solicitou um catálogo de produtos. 

Conheça abaixo os tipos e configurações de intenções

## Sobre intenções

### Gatilhoes de intenções

Gatilhos são formas de iniciar iniciar as inteções e executar ações a partir dela.. Temos dois tipos de gatílhos de intenções:

* EXPRESSÕES DE TEXTO: O gatilho mais simples que ativa uma intenção (e sua ação) se uma das expressões cadastras estiver contida na mensagem do cliente. ex: se você cadastras as expressão "arquivo\_logo" e um cliente manda uma mensagem "gostaria de receber o arquivo\_logo". A intenção será identificada e executada. \
  A expressão precisa estar na mensagem exatamente como cadastrada (desconsiderando maiúsculas e minúsculas) e deve ter no mínimo 5 caracteres.
* INTELIGÊNTE E SEMÂNTICO: Diferente do gatilho de expressões de texto que precisam ser exatas, esse gatilho identifica a intenção usando agentes de IA que leem as últimas mensagens da conversa e identificam de foram semântica se a intenção do cliente é a que você cadastrou. \
  Para funcionar bem, você deve descrever a intenção no campo *descrição* ex:\
  "usuário deseja transferir a chamada para uma pessoa, atendente ou humano"\
  "usuário deseja saber informações de entrega do seu pedido"\
  \
  Boas Práticas: Seja claro na sua descrição, sem enrolar nem faltar informação. Adicione opções de como o cliente pode pedir a mesma coisa, como no exemplo "transferir para pessoa, humano ou atendente"

Intenções só são executadas e identificadas quando a conversa está em posse do assistente treinado nessas intenções.

### Executar um Flow

Com a nova atualização do Konversas, agora as inteções iniciam a execução de um "Flow". Dando muito mais flexibilidade e possibilidades para usar esse recurso.

Um Flow é um fluxo de ações encadeadas que pode ser iniciado em diversas partes do sistema, uma delas na identificação de intenções.

O funcionamento é simples, uma vez que a intenção é identificada pelo sistema, o flow determinado é executado. Isso permite que você mande mensagens, arquivos, adicione tag, funnil ao cliente e muito mais.

Para saber mais sobre flow. [clique aqui.](/konversas-doc/configuracoes/flow.md)

* Uma api chamada pelo seu assistente não pode demorar mais do que 10 segundos para retornar. (timeout control)

DICA: use ferramentas como POSTMAN para testar chamadas de API antes de configurar no Konversas. Solicite suporte a seu gerente de contas se necessário.