Categorização Supervisionada com Agentes
Este tutorial é para o planejador financeiro que quer resolver um problema recorrente: lançamentos que chegam com nomes genéricos e são categorizados de forma errada pela IA.
Aqui você vai aprender:
- o que é categorização supervisionada e por que ela existe;
- qual problema operacional ela resolve no dia a dia;
- como montar um agente completo passo a passo;
- como funciona a experiência do cliente no WhatsApp;
- como a ferramenta "Reforçar categorização" trabalha por baixo;
- exemplos reais de instrução prontos para usar;
- erros comuns e como evitar.
O problema: lançamentos ambíguos
A categorização automática da Rica funciona muito bem quando o nome do lançamento é descritivo. Um lançamento chamado "Supermercado Extra" vai para "Alimentação" sem dificuldade. "Netflix" vai para "Assinaturas".
Mas nem todo lançamento chega com nome claro. Veja exemplos reais que aparecem nos extratos:
| Nome no extrato | O que realmente foi | Categoria correta |
|---|---|---|
| PagSeguro | Violão para presente | Lazer |
| Amazon compra | Material escolar dos filhos | Educação |
| Mercado Livre | Peça de reposição do carro | Transporte |
| PIX enviado | Mensalidade da academia | Saúde e bem-estar |
| Débito automático | Seguro do apartamento | Moradia |
Nesses casos, a IA só tem o nome genérico para trabalhar. Ela faz o melhor que pode, mas sem contexto, erra. "Amazon compra" vira "Eletrônicos e gadgets" quando na verdade foi um violão. "PagSeguro" vira "Serviços digitais" quando era um presente.
O que o planejador faz hoje (sem agente)
Sem a categorização supervisionada, o fluxo operacional do planejador para corrigir esses erros é:
- Abrir a plataforma e revisar os lançamentos recentes do cliente.
- Identificar visualmente quais lançamentos parecem mal categorizados.
- Entrar em contato com o cliente (WhatsApp, ligação) para perguntar o que foi cada compra.
- Esperar a resposta do cliente.
- Voltar à plataforma e corrigir manualmente a categoria de cada lançamento.
- Repetir esse processo periodicamente para cada cliente.
Para uma carteira de 30 clientes com Open Finance ativo, isso pode significar dezenas de correções manuais por semana. E o pior: se o planejador demora para revisar, as análises de fluxo de caixa, metas e orçamento ficam distorcidas até a correção.
O que muda com a categorização supervisionada
Com um agente configurado, o fluxo passa a ser:
- Lançamento ambíguo chega via Open Finance ou registro manual.
- A Rica detecta que a confiança da categorização é baixa.
- A Rica pergunta diretamente ao cliente no WhatsApp: "O que foi essa compra?"
- O cliente responde com uma descrição simples.
- A Rica re-categoriza automaticamente usando a resposta do cliente como critério principal.
- A Rica confirma a nova categoria ao cliente.
O planejador não precisa intervir. A correção acontece em tempo real, no momento em que o lançamento entra. O orçamento, as metas e as análises já refletem a categoria correta.
Trabalho operacional eliminado
Para deixar claro o impacto, veja o comparativo:
| Etapa | Sem agente | Com agente |
|---|---|---|
| Identificar lançamento ambíguo | Planejador revisa manualmente | Rica detecta automaticamente |
| Perguntar ao cliente | Planejador envia mensagem | Rica pergunta no WhatsApp |
| Aguardar resposta | Planejador acompanha | Rica recebe na thread |
| Corrigir categoria | Planejador edita na plataforma | Rica re-categoriza sozinha |
| Confirmar ao cliente | Planejador avisa (opcional) | Rica confirma automaticamente |
| Tempo por lançamento | 3-5 minutos | 0 minutos do planejador |
Para uma carteira com 20 lançamentos ambíguos por semana, isso representa entre 1 e 2 horas semanais de trabalho operacional eliminado por completo.
Como funciona por dentro
Quando o agente tem a ferramenta Reforçar categorização habilitada, a Rica usa uma estratégia inteligente para a re-categorização:
- O cliente responde "foi um violão".
- A Rica chama a ferramenta
reforcarCategorizacaoLancamentocom o ID do lançamento e o texto do cliente. - A ferramenta grava a descrição do cliente no campo de reforço do lançamento.
- A categorização automática é executada novamente, mas desta vez com uma diferença fundamental: os campos originais do extrato (nome, notas, extensão) são completamente ignorados. A IA recebe apenas a descrição do cliente e as categorias disponíveis.
- Como a IA não vê "Amazon compra" nem dados do extrato que induziram o erro original, ela categoriza "violão" corretamente como "Lazer" ou a categoria mais adequada.
Isso é importante porque a categorização original já tentou usar o nome do extrato e errou. Mandar o mesmo nome de novo junto com a descrição do cliente faria a IA ficar em dúvida. Removendo o ruído, a resposta do cliente se torna a única fonte de verdade.
Montagem do agente passo a passo
Passo 1: Acessar o painel de agentes
Acesse Consultoria > Estúdio > Agentes > Feedback.
Passo 2: Criar novo agente
Clique em Novo agente e preencha:
- Nome:
Categorização supervisionada - Tipo de entrada:
Lançamento - Status: Ativo
Passo 3: Habilitar as ferramentas
No painel de ferramentas, habilite:
- Reforçar categorização — permite que a Rica atualize a descrição do lançamento e re-categorize.
- Enviar WhatsApp — permite que a Rica envie a pergunta ao cliente.
Essas duas ferramentas são o mínimo necessário. Opcionalmente, você pode habilitar também:
- Listar lançamentos período — para a Rica ter contexto de outros lançamentos recentes da mesma origem.
- Listar metas — para a Rica conectar a re-categorização ao impacto em metas ativas.
Passo 4: Escrever a instrução
Este é o campo mais importante. A instrução define quando a Rica deve agir e como deve se comportar.
Instrução recomendada:
Quando um novo lançamento chegar com confiança de categorização abaixo de 0.5 e o nome do lançamento for genérico (nomes de plataformas de pagamento, marketplaces, PIX sem identificação ou siglas que não indicam claramente o que foi comprado), pergunte à pessoa de forma direta e curta o que foi essa compra.
Formato da pergunta: mencione o nome do lançamento, o valor e a data. Use no máximo duas frases. Não explique por que está perguntando. Não ofereça opções de categoria.
Quando a pessoa responder o que foi a compra, use a ferramenta reforcarCategorizacaoLancamento para atualizar e re-categorizar o lançamento. Depois confirme a nova categoria em uma mensagem curta com o nome do lançamento e a categoria atualizada.
Se a confiança for maior que 0.5 ou o nome do lançamento for descritivo o suficiente para a categorização ser confiável, não envie nenhuma mensagem.
Passo 5: Salvar e ativar
Salve o agente. Ele começa a atuar imediatamente em novos lançamentos.
Experiência do cliente no WhatsApp
Veja como a conversa acontece do ponto de vista do cliente. A Rica mantém a conversa natural dentro da mesma thread do WhatsApp que o cliente já usa para registrar lançamentos e fazer consultas.
Exemplo 1 — Compra na Amazon
Rica: Compra de R$ 345,00 na Amazon em 25/03. O que foi?
Maria: Um violão para o Pedro
Rica: Recategorizado. Amazon compra agora está em Lazer.
Exemplo 2 — PIX genérico
Rica: PIX de R$ 180,00 em 24/03. O que foi esse pagamento?
João: Mensalidade da academia
Rica: Recategorizado. PIX enviado agora está em Saúde e bem-estar.
Exemplo 3 — PagSeguro
Rica: Compra de R$ 89,90 no PagSeguro em 23/03. O que foi?
Ana: Presente de aniversário pro meu sobrinho
Rica: Recategorizado. PagSeguro agora está em Presentes e doações.
Exemplo 4 — Mercado Livre
Rica: Compra de R$ 420,00 no Mercado Livre em 22/03. O que foi?
Carlos: Pneu novo pro carro
Rica: Recategorizado. Mercado Livre agora está em Transporte.
Exemplo 5 — Lançamento que não precisa de pergunta
Neste caso, o lançamento "Supermercado Extra" tem confiança alta. O agente avalia e decide não enviar nada. O cliente não recebe nenhuma mensagem desnecessária.
Variações de instrução para diferentes perfis de cliente
Instrução para cliente com alto volume de lançamentos
Clientes com Open Finance ativo e vários cartões tendem a ter mais lançamentos ambíguos. Use uma instrução que agrupe perguntas:
Quando houver lançamentos com confiança abaixo de 0.5, agrupe os lançamentos ambíguos do mesmo dia em uma única mensagem. Pergunte sobre todos de uma vez, listando nome e valor de cada um. Quando a pessoa responder, re-categorize todos usando a ferramenta reforcarCategorizacaoLancamento para cada lançamento e confirme as novas categorias em uma lista curta.
Formato da pergunta: liste os lançamentos numerados. Use no máximo uma frase de introdução.
Se não houver lançamentos ambíguos, não envie nada.
Exemplo de como fica no WhatsApp:
Rica: Esses lançamentos de hoje ficaram sem categoria clara:
1. PagSeguro — R$ 89,90
2. PIX enviado — R$ 250,00
3. Amazon — R$ 156,00
O que foi cada um?
Maria: 1 foi remédio da farmácia
2 mensalidade do inglês
3 brinquedo pro Pedro
Rica: Recategorizado:
PagSeguro — Saúde
PIX enviado — Educação
Amazon — Lazer
Instrução para cliente que prefere respostas mínimas
Quando um lançamento tiver confiança abaixo de 0.4, pergunte o que foi em uma única frase curta com nome e valor. Quando a pessoa responder, re-categorize e confirme com no máximo 5 palavras. Não envie mensagem se a confiança for maior que 0.4.
Exemplo:
Rica: PagSeguro R$ 89,90 — o que foi?
Ana: Remédio
Rica: PagSeguro — Saúde.
Instrução com contexto de metas
Se você quer que a Rica também conecte a re-categorização ao impacto em metas, habilite a ferramenta Listar metas e use:
Quando um lançamento tiver confiança abaixo de 0.5 e nome genérico, pergunte o que foi. Após re-categorizar, verifique se a nova categoria está vinculada a alguma meta ativa. Se estiver, informe brevemente o impacto no ciclo atual da meta.
Formato: primeiro confirme a re-categorização, depois em uma segunda linha mencione a meta se houver impacto. Se não houver meta relacionada, não mencione.
Exemplo:
Rica: Compra de R$ 420,00 no Mercado Livre em 22/03. O que foi?
Carlos: Pneu novo pro carro
Rica: Recategorizado. Mercado Livre — Transporte.
Meta Transporte: R$ 1.820 de R$ 2.000 usados no ciclo (91%).
Quando usar e quando não usar
Use quando
- O cliente tem Open Finance ativo e recebe muitos lançamentos automáticos com nomes de plataformas de pagamento.
- O cliente usa PIX com frequência e os lançamentos chegam como "PIX enviado" sem descrição.
- O cliente faz compras em marketplaces (Amazon, Mercado Livre, Shopee) onde o nome do estabelecimento não diz o que foi comprado.
- A categorização automática está errando com frequência para determinados tipos de lançamento.
Não use quando
- O cliente tem poucas movimentações e o planejador prefere revisar manualmente.
- As categorias do cliente estão muito bem definidas com conceitos detalhados e a categorização automática já acerta na maioria dos casos.
- O cliente não responde mensagens no WhatsApp com frequência (a pergunta ficaria sem resposta).
Relação com conceitos de categoria
A categorização supervisionada e os conceitos de categoria são complementares:
| Abordagem | Como funciona | Quando é melhor |
|---|---|---|
| Conceitos | Você ensina a IA antecipadamente o que cada categoria significa. | Quando os padrões são previsíveis e repetitivos. |
| Categorização supervisionada | A IA pergunta ao cliente quando não tem certeza e aprende no momento. | Quando o lançamento é imprevisível e depende de contexto que só o cliente tem. |
A prática recomendada é usar os dois juntos:
- Configure conceitos detalhados nas categorias para cobrir os padrões recorrentes (nomes de estabelecimentos conhecidos, siglas de convênios, etc.).
- Ative a categorização supervisionada para capturar os casos que fogem do padrão.
Quanto mais conceitos você configurar, menos perguntas a Rica vai precisar fazer. Mas sempre vai existir o lançamento imprevisível que só o cliente sabe o que é.
Checklist de configuração
Antes de ativar, valide:
- O agente tem a ferramenta Reforçar categorização habilitada?
- O agente tem a ferramenta Enviar WhatsApp habilitada?
- A instrução define claramente o limiar de confiança (recomendado: 0.5)?
- A instrução define quando não enviar mensagem?
- O formato da pergunta é curto e objetivo?
- O formato da confirmação é curto?
- O cliente usa WhatsApp e costuma responder mensagens da Rica?
Erros comuns e como evitar
-
Erro: limiar de confiança muito alto (ex.: 0.8). Resultado: a Rica pergunta sobre quase todo lançamento, gerando ruído. Correção: use 0.5 como referência. Ajuste para baixo se o cliente reclamar de muitas perguntas.
-
Erro: não instruir quando não enviar. Resultado: a Rica pode perguntar sobre lançamentos óbvios como "Supermercado Extra". Correção: inclua na instrução que lançamentos com nome descritivo e confiança adequada não devem gerar pergunta.
-
Erro: mensagem longa demais na pergunta. Resultado: o cliente ignora por parecer complexo. Correção: limite a pergunta a duas frases. O cliente precisa poder responder em uma palavra.
-
Erro: oferecer opções de categoria na pergunta ("foi lazer, educação ou transporte?"). Resultado: o cliente escolhe uma opção sem pensar no que realmente foi. Correção: pergunte aberto ("o que foi?") para que a resposta descreva a compra real.
-
Erro: não habilitar a ferramenta Enviar WhatsApp. Resultado: a Rica processa o agente mas não consegue enviar a pergunta ao cliente. Correção: sempre habilite Enviar WhatsApp junto com Reforçar categorização.
Conclusão
A categorização supervisionada com agentes elimina o trabalho operacional mais repetitivo da rotina do planejador: identificar lançamentos mal categorizados, perguntar ao cliente, esperar resposta e corrigir manualmente.
Com um único agente configurado, a Rica:
- detecta lançamentos ambíguos automaticamente;
- pergunta ao cliente no WhatsApp de forma direta;
- re-categoriza com base na resposta do cliente;
- mantém orçamento, metas e análises atualizados em tempo real.
O planejador fica livre para dedicar tempo ao que realmente importa: análise estratégica, construção de plano e relacionamento com o cliente.