---
title: Intenções (IA)
slug: helper/intencoes-ia
createdAt: 2026-11-19T14:26:40.044Z
---

**Intenção** (ou **assunto**) é aquilo que o cliente *quer* — mesmo que ele escreva de mil formas diferentes. "Perdi meu boleto", "quero a segunda via", "não achei o boleto do mês" são frases diferentes com a **mesma intenção**: pedir a segunda via do boleto.

:inlineImage[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/HoxGtV1FGA2Xa_6c5dgDT_d40314475542bb00a9c3caef316c3bca.jpg" alt="Os assuntos (intenções) ficam dentro do fluxo" caption size="160" width="1600" height="911"} *Os assuntos (intenções) ficam dentro do fluxo*

## Onde ficam os assuntos

Os assuntos são criados **dentro do fluxo**: no editor de fluxo, clique em **"O que ele entende"** (topo). Ali você vê todos os **Assuntos** do assistente, com **Filtrar**, **Importar**, **Baixar** e **+ Adicionar assunto**. Cada assunto reúne as **frases** que a pessoa pode dizer — a **resposta** é definida no próprio fluxo (pelo bloco *Entender o assunto* e as setas que saem dele).

## Como a plataforma entende

Você **dá exemplos** de como o cliente escreve. A IA transforma cada frase num **vetor** de significado (embedding) e, quando chega uma mensagem nova, compara por **similaridade**. A intenção mais parecida vence — desde que passe de um **limiar** (confiança mínima).

## Criar um assunto

1. No **editor de fluxo**, clique em **"O que ele entende"**.
2. Clique em **+ Adicionar assunto**, digite o nome (ex.: `segunda_via_boleto`) e **Criar**.
3. No card do assunto, adicione **frases de exemplo** (uma por vez, campo **"+ frase"**).
4. No fluxo, ligue um bloco **Entender o assunto** com uma **seta para cada assunto** + uma **"Qualquer outra"** de fallback.

## Testar se está entendendo

Para **testar e afinar**, use a tela **Intenções** (a versão avançada/laboratório de NLU — o painel dentro do fluxo é para o dia a dia). Lá há duas ferramentas:

- **Testar 1 frase** — escreva uma mensagem e veja qual intenção a IA escolhe e com quanta confiança.
- **Teste em lote** — cole várias frases com a intenção esperada (formato `frase | intenção_esperada`) e veja a taxa de acerto e onde a IA se confunde.

## O limiar de confiança

O **limiar** define o mínimo de certeza para aceitar uma intenção:

- **Mais alto** → a IA só aceita quando tem bastante certeza. Erra menos, mas responde "não entendi" com mais frequência.
- **Mais baixo** → entende mais coisas, mas arrisca mais erros.

## Regras de negócio (como a classificação decide)

- Cada exemplo vira um **vetor** (embedding, roda em **CPU** — sem custo por chamada de IA). A mensagem nova é comparada por **similaridade de cosseno** com todos os exemplos; vence a intenção do exemplo mais próximo.
- Se a confiança **≥ limiar**, a intenção é aceita; **abaixo, o robô não chuta** — retorna "nenhuma" e o fluxo segue pelo **"senão"** (ou humano).
- As mensagens **não compreendidas** ficam registradas e viram **candidatas a curadoria** (veja em *Monitor NLU*, e como gráfico em [Painéis](https://docs.run2biz.com/helper/paineis) › *Bot & IA*) — é a matéria-prima para você melhorar os exemplos.

## Começar de uma biblioteca pronta

Se não quiser começar do zero, use **Começar de uma biblioteca pronta** para importar um conjunto de intenções comuns e depois ajustar aos seus casos.
