IA Ascend - Assistente Inteligente
Simplifica operações do dia a dia ao permitir que qualquer ação seja feita por conversa, sem navegar entre telas ou lembrar onde encontrar cada funcionalidade.
Destaques
- Chat inteligente com retrieval contextual que entende o histórico da conversa
- Widget flutuante disponível em todas as páginas autenticadas
- Página dedicada /ai com histórico completo de conversas e threads
- Ferramentas para buscar devedores, consultar dívidas e criar registros
- Isolamento automático entre dados PF e PJ conforme contexto do usuário
- Observabilidade completa com traces, métricas de uso e logs estruturados
O que mudou
O ASCEND Bot é um assistente de IA integrado ao workspace que permite executar operações financeiras usando linguagem natural. Ele está disponível de duas formas:
- Widget flutuante: accessible em todas as páginas pelo botão "Falar com IA"
- Página dedicada (/ai): experiência completa com histórico de conversas e threads
Funcionalidades
Chat inteligente
O bot entende o contexto da conversa e mantém o histórico, permitindo perguntas de seguimento como "e o devedor X?" sem repetir informações já fornecidas.
Widget flutuante
- Disponivel em todas as páginas autenticadas (exceto na própria página /ai)
- Botão com logo Ascend e texto "Falar com IA"
- Expande para painel de chat com animação suave
- Estados em português: "Pensando...", "Ops! Algo deu errado. Tentar novamente?"
Página dedicada /ai
- Sidebar de conversas: lista de threads anteriores com preview da última mensagem
- Área de chat: mensagens formatadas com diferenciação visual entre usuário e IA
- Citações: quando o bot usa dados do sistema, exibe as fontes consultadas
- NOVA conversa: botão para iniciar thread limpa
Ferramentas disponíveis
O bot tem acesso a ferramentas que executam operações no sistema:
| Ferramenta | O que faz |
|------------|-----------|
| create_transaction | Cria uma transação no sistema |
| search_debtors | Busca devedores por nome ou documento |
| create_debtor | Cadastra um novo devedor |
| search_debts | Busca dívidas por devedor ou status |
| create_debt | Cria uma dívida para um devedor |
segurança e isolamento
- Dados de Pessoa Física (PF) e Pessoa Jurídica (PJ) são isolados automaticamente
- O bot respeita o contexto de tenant e permissões do usuário logado
- Nenhuma ação é executada sem validação de entitlement
Observabilidade
- Traces distribuídos em toda a cadeia: controller → orchestrator → adapters
- Métricas de uso: tokens de entrada/saída, latência de retrieval, contagem de chunks
- Logs estruturados em todos os pontos de decisão
- Endpoints administrativos para saúde, flags e estatísticas de uso
Como usar
- No widget: clique no botão flutuante "Falar com IA" no canto inferior direito
- Na página /ai: acesse pelo menu do workspace ou diretamente via URL
- Exemplos de comando:
- "Buscar devedores com nome Silva"
- "Criar um devedor chamado João, CPF 123.456.789-00"
- "Listar dívidas em aberto do devedor X"
- "Criar uma dívida de R$ 500 para o devedor Y"
Limitações conhecidas
- O bot consulta apenas dados existentes no sistema; não cria informações do zero
- Ações sensíveis (criação de dívida, transação) pedem confirmação antes de executar
- O widget não está disponível na página /ai para evitar redundância