# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tilus.gitbook.io/konversas-doc/assistente-ia/intencoes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.