Copiloto IA (AI Copilot)¶
O Copiloto IA é o assistente de inteligência de negócios da Brandvelia. Ele permite ao operador consultar métricas, solicitar diagnósticos de campanhas e receber análises estratégicas através de um chat intuitivo, operando sobre dados 100% determinísticos do banco de dados.
Como o Copiloto Funciona¶
Ao receber uma pergunta no endpoint /api/ai/copilot, o sistema executa três etapas síncronas:
- Snapshot de Dados Determinístico: Executa em paralelo no Supabase a função
bv_get_dashboard_summary(métricas de hoje e do período selecionado), além de extrair as top 50 ofertas, top 50 campanhas e as 20 transações mais recentes do workspace. - Injeção do Contexto no Prompt de Sistema: A IA recebe os números consolidados em SQL e instruções estritas de governança:
- Todos os valores monetários estão em USD;
- É terminantemente proibido inventar, estimar ou projetar números que não estejam presentes no snapshot;
- Se um dado estiver ausente ou for desconhecido, o assistente deve relatar a ausência explicitamente.
- Geração de Resposta com Racional Analítico: A resposta é redigida no mesmo idioma da pergunta do operador, citando os valores exatos de receita líquida, lucro real e ROAS.
Fórmulas Utilizadas pelo Copiloto¶
| Métrica | Definição Rígida em SQL |
|---|---|
net_revenue |
$\text{Receita Bruta} - \text{Reembolsos} - \text{Chargebacks} - \text{Taxas}$ |
profit |
$\text{Receita Líquida} - \text{Ad Spend} - \text{Opex}$ |
gross_roas |
$\text{Receita Bruta} / \text{Ad Spend}$ |
net_roas |
$\text{Receita Líquida} / \text{Ad Spend}$ |
Governança e Validação de Evidência¶
- Segurança de Execução: O Copiloto pode recomendar pausas ou escala de campanhas, mas nunca executa ações no tráfego ou no dinheiro por conta própria. Toda alteração exige a ação deliberada do operador.
- Validação de Evidência (Decision Engine): Toda afirmação factual de IA passa pelo validador de evidência. Afirmações sem IDs de evidência válidos do workspace são rejeitadas.
- Auditoria de Custos: Cada interação com o Copiloto é registrada na tabela
bv_ai_runs, contabilizando modelo utilizado, latência, tokens de entrada/saída e custo real derivado debv_ai_models.