🌍 Engenharia & Boas Práticas

Objetivo do Volume: Compreender a tese fundamental dos Compound AI Systems (Sistemas Compostos de IA da Universidade de Berkeley), dominar a anatomia das 7 camadas de um AI-First OS de padrão industrial, dissecar a engenharia de caso real do Grupo LLE (distribuição B2B) e analisar minuciosamente a arquitetura de agentes, memória e auditores de código da Accelera 360 (Growth OS) instalada na sua máquina.


1. O Fim da Ilusão do "Modelo Monolítico": Por Que o ChatGPT Sozinho Falha no B2B

Para quem está começando sem bagagem técnica, existe uma armadilha quase irresistível: acreditar que colocar IA numa empresa significa apenas assinar o ChatGPT Plus, colar um prompt gigantesco de 5 páginas e esperar que a inteligência artificial cuide de todo o atendimento comercial da empresa.

Quem tenta fazer isso em uma distribuidora ou transportadora real descobre a verdade em menos de 48 horas:

  1. Alucinações Custosas: O modelo inventa preços que não existem, promete descontos de 50% sem autorização ou confirma estoque de itens que saíram de linha há 3 anos.
  2. Perda de Contexto em Conversas Longas: Em uma negociação B2B com 30 trocas de mensagens e áudios de WhatsApp, o modelo esquece o que o cliente disse no início e se contradiz.
  3. Falta de Acesso Determinístico a Sistemas: Uma LLM (Large Language Model) pura não sabe consultar uma tabela de banco de dados SQL com 50.000 SKUs, não sabe verificar a chave PIX da empresa nem calcular frete fracionado com precisão matemática.

A Pesquisa de Berkeley: The Shift from Models to Compound AI Systems

Em 2024, pesquisadores do laboratório de inteligência artificial da UC Berkeley (liderados por Matei Zaharia, criador do Apache Spark e cofundador da Databricks) publicaram um artigo seminal que mudou a engenharia de software global: o futuro da inteligência artificial não está em criar modelos gigantescos monolíticos, mas em construir Sistemas Compostos de IA (Compound AI Systems).

💡 Analogia do Mundo Real

A Analogia do Piloto de Fórmula 1 e a Equipe de Boxes: Um modelo de linguagem (como GPT-4o, Claude 3.5 Sonnet ou Gemini 1.5 Pro) é como um piloto genial de Fórmula 1: ele possui reflexos rápidos e raciocínio verbal sofisticado. Mas se você colocar esse piloto sozinho em uma pista sem carro, sem telemetria, sem equipe de troca de pneus, sem combustível calibrado e sem rádio com o engenheiro-chefe, ele não vence corrida nenhuma. O Compound AI System é a equipe inteira de Fórmula 1: - O Piloto é o modelo de IA (raciocínio cognitivo); - O Carro é a infraestrutura de computação em nuvem (Docker / VPS); - A Telemetria é o banco de dados determinístico (PostgreSQL 16); - Os Sensores e Ferramentas são os protocolos de conexão (MCP / APIs); - O Rádio do Engenheiro é a observabilidade e os auditores de código.

No mundo corporativo B2B, a inteligência artificial generativa é responsável por apenas 10% a 15% do sistema — a camada puramente linguística. Os outros 85% a 90% são engenharia de software clássica, determinística, segura e auditável.


2. A Anatomia em 7 Camadas de um AI-First OS Industrial

Um Sistema Operacional de Inteligência Artificial corporativo não é um "bot". É uma malha integrada composta por 7 camadas interdependentes:

┌───────────────────────────────────────────────────────────────────────────────┐ │ CAMADA 1: CANAIS DE INGESTÃO OMNICHANNEL │ │ WhatsApp (Evolution API v2) │ E-mail Corporativo │ Webhooks ERP │ └───────────────────────────────────────┬───────────────────────────────────────┘ │ ┌───────────────────────────────────────▼───────────────────────────────────────┐ │ CAMADA 2: TRIAGEM & PROCESSAMENTO MULTIMODAL INICIAL │ │ Whisper API (Transcrição de Áudios) │ Visão Computacional (PDF/Fotos) │ └───────────────────────────────────────┬───────────────────────────────────────┘ │ ┌───────────────────────────────────────▼───────────────────────────────────────┐ │ CAMADA 3: MÁQUINA DE ESTADOS & ORQUESTRAÇÃO CENTRAL │ │ LangGraph / Temporal (Estados Duráveis) │ n8n (Fila Redis) │ └──────────────────┬────────────────────┬────────────────────┬──────────────────┘ │ │ │ ┌──────────────────▼──────┐ ┌───────────▼──────────┐ ┌───────▼──────────────────┐ │ CAMADA 4: PROTOCOLO │ │ CAMADA 5: DADOS & │ │ CAMADA 6: INTERVENÇÃO │ │ COGNITIVO (MCP) │ │ BANCO DETERMINÍSTICO │ │ HUMANA (HUMAN-IN-LOOP) │ │ Model Context Protocol │ │ PostgreSQL 16 + RLS │ │ Chatwoot CRM │ │ (Ferramentas/APIs) │ │ pgvector (Busca RRF) │ │ Caixa de Entrada Unificada│ └──────────────────┬──────┘ └───────────┬──────────┘ └───────┬──────────────────┘ │ │ │ ┌──────────────────▼────────────────────▼────────────────────▼──────────────────┐ │ CAMADA 7: OBSERVABILIDADE & AUDITORIA DE CUSTOS │ │ Langfuse Tracing │ Métricas de Latência │ Custo por Tenant (R$) │ └───────────────────────────────────────────────────────────────────────────────┘

Vamos examinar minuciosamente o papel de cada camada na operação real:

Camada 1: Ingestão Omnichannel

É a porta de entrada da empresa. No Brasil, mais de 90% do comércio B2B roda no WhatsApp. Por isso, a estabilidade da integração é crítica.

Camada 2: Triagem & Multimodalidade

Clientes B2B não escrevem mensagens perfeitas e formatadas. Eles enviam:

Essa camada recebe o payload bruto, passa pelo Whisper API para transcrição de áudio e por modelos multimodais de visão para extrair itens estruturados em formato JSON antes que qualquer agente tome decisões.

Camada 3: Máquina de Estados e Orquestração

É o cérebro procedimental do sistema. Garante que um orçamento nunca "pule etapas". Se o cliente solicitou uma cotação, a máquina de estados força a seguinte sequência matemática:

  1. Extrair lista de produtos;
  2. Consultar estoque real no banco de dados;
  3. Checar status de crédito do CNPJ no ERP;
  4. Se o valor passar de R$ 50.000, disparar alerta no Chatwoot para aprovação do diretor comercial;
  5. Se aprovado, compor a mensagem de orçamento e enviar de volta ao WhatsApp.

Camada 4: Protocolo Cognitivo (MCP - Model Context Protocol)

Criado pela Anthropic no final de 2024 e tornado padrão aberto de mercado, o Model Context Protocol (MCP) é o equivalente ao cabo USB-C para inteligência artificial. Ele permite que qualquer agente de IA se conecte a qualquer ferramenta corporativa (ERP, banco SQL, API de frete) através de um protocolo universal e seguro, sem código proprietário amarrado.

Camada 5: Memória Transacional e Vetorial (PostgreSQL 16 + pgvector)

O banco de dados relacional é onde reside a verdade incontestável: produtos, preços, estoque, clientes e histórico de pedidos. No mesmo banco, a extensão pgvector armazena as representações matemáticas (vetores) das fichas técnicas e manuais dos produtos, permitindo busca híbrida de precisão cirúrgica.

Camada 6: Human-in-the-Loop (Chatwoot)

Nenhum sistema industrial sério opera 100% autônomo sem supervisão. Se um cliente fica irritado, se uma exceção tributária ocorre ou se o negócio ultrapassa o limite de crédito, o sistema transfere a conversa de forma transparente para a equipe humana via Chatwoot, mantendo todo o histórico da conversa e o resumo das ações tomadas pelos agentes.

Camada 7: Observabilidade (Langfuse)

Você não pode gerenciar o que não pode medir. O Langfuse atua como a caixa-preta de um avião: rastreia cada token consumido, mede a latência em milissegundos de cada consulta, calcula o custo exato em centavos de dólar de cada atendimento e alerta os operadores caso ocorra qualquer desvio de comportamento ou alucinação.


3. Estudo de Caso Real: A Arquitetura do Grupo LLE (Kelvin Cleto)

Para ver a teoria em funcionamento no mundo real, examinamos o caso real compartilhado por Kelvin Cleto em suas imersões: a modernização comercial do Grupo LLE (uma grande distribuidora de materiais de construção com faturamento multimilionário e dezenas de filiais).

O Gargalo Operacional Original

FLUXO DE COTAÇÃO DO GRUPO LLE (AI-FIRST OS) │ 1. MENSAGEM DO CLIENTE ──────────────► [Evolution API v2] (Áudio de 1m30s no WhatsApp) │ ▼ 2. TRANSCRIÇÃO & EXTRAÇÃO ───────────► [Whisper + Vision Parser] Extrai JSON: [{sku_desc: "Tubo PVC 100mm", qty: 20}] │ ▼ 3. BUSCA HÍBRIDA NO CATÁLOGO ────────► [PostgreSQL 16 + pgvector (HNSW)] Localiza SKUs exatos no catálogo de 35.000 itens │ ▼ 4. CONSULTA DE ESTOQUE & PREÇO ──────► [MCP Server ERP Sync] Verifica saldo no depósito da filial mais próxima │ ▼ 5. DECISÃO DE MARGEM ────────────────► [LangGraph State Machine] Calcula margem líquida e limite de crédito │ ┌──────────────────────────────────────┴──────────────────────────────────────┐ ↓ (Se valor < R$ 25.000) ↓ (Se valor ≥ R$ 25.000) 6. DISPARO INSTANTÂNEO 7. APROVAÇÃO HUMANA Cotação enviada no WhatsApp em 38 segundos Notificação prioritária no Chatwoot com botão PIX e link de pagamento com minuta pré-preenchida para o diretor

Resultados Comprovados da Implementação


4. Desconstrução da Estrutura Accelera 360 (Growth OS)

Ao inspecionar a estrutura de automação da Accelera 360 instalada no seu computador (em ~/.claude/skills/growth-os-skills), encontramos a implementação mais avançada de orquestração multiagente aplicada a negócios existente hoje.

Vamos dissecar a arquitetura exata que você tem instalada:

A Hierarquia de 3 Tiers (Orchestrator-Worker-Critic)

TIER 1: COORDINATOR (/gos) │ │ (Briefing Estruturado & Roteamento) ▼ TIER 2: DIRECTOR (/gos-mission-control) │ ┌────────────────────────┼────────────────────────┐ ↓ ↓ ↓ TIER 3: EMPLOYEES TIER 3: EMPLOYEES TIER 3: EMPLOYEES (Descoberta de Nicho) (Geração de Propostas) (Estratégia de Mercado) /gos-nicho-explorer /gos-pitch-deck-builder /gos-gtm-architect /gos-mapear-nicho /gos-lp-builder /gos-playbook-vendas │ │ │ └────────────────────────┼────────────────────────┘ │ ▼ AUDITORES DETERMINÍSTICOS (CRITICS) /gos-critic-{nicho, lp, deck, playbook} (Validação via CÓDIGO, não via LLM)

Tier 1 — Coordinator (/gos)

O coordenador possui um prompt enxuto (< 5.000 tokens) e não executa tarefas operacionais. Sua única responsabilidade é receber o objetivo do usuário em português natural, identificar a real intenção e encaminhar o pedido com um briefing estruturado para o Diretor correto. Isso evita poluir a janela de contexto do modelo com instruções desnecessárias.

Tier 2 — Directors (/gos-mission-control)

O diretor organiza o fluxo de execução. Antes de disparar qualquer agente de criação de apresentação comercial (pitch-deck-builder), ele verifica determinísticamente os pré-requisitos:

O diretor garante que nenhum agente comece a trabalhar com dados incompletos.

Tier 3 — Employees (Os 8 Agentes Especialistas)

Cada funcionário de IA é ultra-especializado em uma única entrega canônica:

  1. /gos-nicho-explorer: Varre mercados e entrega um relatório de GO / NÃO-GO com pontuação de viabilidade;
  2. /gos-mapear-nicho: Extrai as dores em reais, o mecanismo proprietário e a oferta mestra do segmento;
  3. /gos-cliente-radar: Mapeia um prospect específico antes de uma ligação comercial;
  4. /gos-meeting-prep: Gera um roteiro de 1 página para a reunião de diagnóstico de 60 minutos;
  5. /gos-lp-builder: Constrói a landing page da oferta em 9 blocos canônicos de alta conversão;
  6. /gos-pitch-deck-builder: Gera a apresentação comercial de 20 slides em HTML;
  7. /gos-gtm-architect: Desenha a cadência de outbound e o plano de ação dos primeiros 30 dias;
  8. /gos-playbook-vendas: Entrega o script de fechamento, funil de 5 fases e respostas para as 5 maiores objeções.

O Grande Segredo Técnico: Os Auditores Baseados em Código (Critics)

Aqui reside o maior diferencial técnico da Accelera 360 em relação ao resto do mercado: ela não utiliza uma segunda IA para avaliar o trabalho da primeira.

Estudos empíricos mostram que utilizar uma LLM como juíza (LLM-as-a-judge) introduz uma taxa de erro e viés de conformidade de cerca de 16%. Uma IA tende a ser "educada" com outra IA e aprova textos prolixos ou incompletos.

Por isso, os Critics da Accelera 360 executam scripts determinísticos em código:


5. Exercício Prático de Fixação do Volume 2

  1. Desenhe no papel o fluxo de dados da sua empresa ou do seu cliente ideal, mapeando as 7 camadas descritas neste volume. Identifique claramente: onde o dado entra? Quem transcreve? Quem decide? Qual banco armazena? Onde o humano intervém?
  2. Defina a sua regra de auditoria determinística: se você estivesse criando um sistema para cotação automática de fretes em uma transportadora, quais são as 3 regras em código que NUNCA poderiam falhar antes de uma cotação ser enviada ao cliente? (Ex: CEP de destino válido com 8 dígitos; peso maior que zero; valor do frete superior ao custo do diesel mínimo).

No próximo volume (Volume 3), colocaremos as mãos na massa técnica de infraestrutura: vamos entender a fundo servidores dedicados na Hetzner, configuração de Linux Hardening, contêineres Docker, redes isoladas e a instalação do Coolify como nosso PaaS privado de alta performance.