AI Router
5 min de leitura
AI Router — Configuração Centralizada de IA
O que é o AI Router
O AI Router e o ponto único de controle de todas as chamadas de Inteligência Artificial do ConvertaFlow. Toda função que precisa chamar um modelo de linguagem (classificação de intenção, geração de fluxos, agentes de suporte, embeddings) passa obrigatoriamente pelo AI Router.
Isso garante que:
- O provedor e modelo de IA escolhido pelo cliente e respeitado em todas as funções
- Quando o cliente desativa uma função, ela para imediatamente de consumir tokens
- O controle e centralizado: configurar uma vez aplica em todo o sistema
Como funciona
Quando qualquer serviço do ConvertaFlow precisa chamar IA, ele passa pelo AI Router que executa 3 verificações na ordem:
1. Feature esta habilitada?
Verifica se a função está ativada para a sua empresa. Se estiver desativada, nada é chamado — zero tokens consumidos.
2. Qual provedor/modelo usar?
Busca a configuração BYOK (Bring Your Own Key) do tenant:
- Se o cliente configurou sua própria API Key → usa a chave dele
- Se não configurou → usa a chave da plataforma (com limites do plano)
3. Chamada ao LLM
Chama o provedor correto com o modelo escolhido pelo cliente, respeitando o budget de tokens da função.
Provedores suportados
Você pode usar a sua própria chave de provedores como Google Gemini, OpenAI, Anthropic Claude e outros. A lista de provedores e de modelos disponíveis aparece na própria tela de Configuração IA — ela é mantida pela plataforma e muda conforme os provedores lançam e aposentam modelos, por isso não a repetimos aqui.
Funções controladas pelo AI Router
Detecção de Intenção
- Toggle: Detecção de Intenção (em Minhas Funções IA)
- O que faz: Classifica automaticamente cada mensagem recebida em: compra, suporte, reclamação, curiosidade, saudação, outro
- Quando desativado: Nenhum token e consumido, badge de intenção não aparece no chat
- Budget: ~200 tokens por classificação (com cache de 5 minutos)
Agente IA no Chat
- Toggle: Agente IA no Chat (em Minhas Funções IA)
- O que faz: Permite que a IA responda automaticamente pelas conversas quando o atendente ativa o botao IA
- Quando desativado: Botao IA não aparece no chat, zero tokens
Geração de Fluxos com IA
- O que faz: Gera fluxos visuais de automação a partir de instruções em linguagem natural no Flow Builder
- Usa: O provedor/modelo configurado pelo cliente
Embeddings (Busca Semântica)
- O que faz: Gera vetores para busca inteligente na base de conhecimento, memórias de contato e resumos de conversa
- Nota: Sempre usa OpenAI text-embedding-3-small (compatível com pgvector). Se o cliente tem chave OpenAI configurada, usa a dele.
AI Support (MAIA IA)
- O que faz: Agentes de suporte autonomo (CTO, CMO, CSO) que atendem via WebSocket
- Usa: O provedor configurado pelo cliente quando disponível
Auto-move no Pipeline
- Toggle: Auto-move no Pipeline (em Minhas Funções IA)
- O que faz: Move deals automaticamente quando a IA detecta intenção de compra com alta confianca
- Depende de: Detecção de Intenção estar ativada
Auto-prioridade em Reclamações
- Toggle: Auto-prioridade em Reclamações (em Minhas Funções IA)
- O que faz: Define prioridade "Alta" automaticamente quando detecta reclamação
- Depende de: Detecção de Intenção estar ativada
Configuração passo a passo
Configurar provedor de IA
- Va em IA & Agentes > Configuração IA
- Na secao "Provedores de IA", escolha um provedor
- Siga o tutorial para obter a API Key (ex: para Gemini, acesse aistudio.google.com)
- Cole a API Key e clique em Testar Conexão
- Se o teste passar (status "Conectado"), a chave esta pronta
Ativar/desativar funções
- Na mesma pagina, role até "Minhas Funções IA"
- Cada função tem um toggle independente
- Funções desativadas não consomem tokens — garantia absoluta
- O modelo usado por cada função segue o provedor configurado acima
- Clique em Salvar para aplicar
Escolher modelo por função
Ao lado de cada função em "Minhas Funções IA", existe um seletor de modelo. O padrão e o modelo do provedor ativo, mas você pode personalizar:
- Funções simples (intenção, auto-move): use os modelos rápidos e baratos do provedor
- Funções complexas (agente no chat, geração de fluxos): use os modelos mais capazes do provedor
Economia de tokens
O sistema economiza tokens de varias formas antes de chamar a IA:
- Feature desativada? → 0 tokens (toggle controla)
- Bot desativado para o contato? → 0 tokens
- Fluxo ativo respondendo? → 0 tokens (FlowBuilder já responde)
- Intent em cache (últimos 5 min)? → 0 tokens (reutiliza classificação anterior)
- Nada resolve? → Chama IA com budget controlado (~200-500 tokens)
O consumo aparece em IA & Agentes > AI Monitor.
BYOK — Bring Your Own Key
O que e
BYOK permite que o cliente use sua própria API Key de IA. O custo de tokens vai para a conta do cliente, não da plataforma.
Como funciona
- O cliente configura a chave em IA & Agentes > Configuração IA
- O sistema guarda a chave criptografada (nunca em texto puro)
- Todas as funções passam a usar a chave do cliente automaticamente
- Se a chave falhar, o sistema tenta usar a chave da plataforma como fallback
Beneficios para o cliente
- Faixas gratuitas: alguns provedores oferecem uma faixa de uso gratuita — confira as condições no site do provedor
- Controle total: O cliente ve o consumo direto no dashboard do provedor
- Sem limites de plano: Usando BYOK, o limite de tokens do plano não se aplica
Segurança
- As chaves de API são guardadas criptografadas
- As chaves nunca aparecem em logs nem em respostas da plataforma
- A interface mostra só a chave mascarada (ex:
AIza...xyz9) - Isolamento por empresa: as configurações de cada empresa ficam separadas das demais