Engenharia
A engenharia que sustenta cada decisão
Doze capacidades de engenharia, cada uma explicada pelo problema que resolve, pela arquitetura e pelo caso onde aparece. Diagramas antes de listas de tecnologia.
Descrevemos o desenho. O que está em produção em cada cliente depende do case, e a evidência de cada um está marcada.
Arquitetura
Como contexto, modelos e agentes se organizam.
Arquiteturas multiagente
Exemplo ilustrativo- O problema
- Um único agente generalista erra mais e é difícil de auditar.
- Arquitetura
- 1Objetivo e política
- 2Planejador divide a tarefa
- 3Agentes especializados executam
- 4Camada de política valida
- 5Aprovação humana se preciso
- Por que importa
- Papéis claros tornam cada etapa testável e permitem limites por agente.
- Onde aparece
- Agentes no case RE/MAX
Roteamento de modelos
Arquitetura proposta- O problema
- Nem toda tarefa precisa do modelo maior, e nem todo modelo serve a toda tarefa.
- Arquitetura
- 1Tarefa e requisitos
- 2Classificação da dificuldade
- 3Escolha do modelo
- 4Verificação da saída
- 5Registro de custo e qualidade
- Por que importa
- Equilibra qualidade, custo e latência com uma regra explícita.
- Onde aparece
- Camada de inteligência
Busca semântica
Exemplo ilustrativo- O problema
- Palavras-chave perdem o que as pessoas querem dizer.
- Arquitetura
- 1Texto vira vetor
- 2Índice vetorial
- 3Busca por similaridade
- 4Filtro por restrições
- 5Ordenação por critérios
- Por que importa
- Encontra o que tem o mesmo significado, mesmo descrito com outras palavras.
- Onde aparece
- Recuperação semântica na RE/MAX
RAG (geração com recuperação)
Exemplo ilustrativo- O problema
- Modelos não conhecem os dados da empresa e inventam quando falta contexto.
- Arquitetura
- 1Consulta
- 2Representação semântica
- 3Recuperação de fontes
- 4Resposta com a fonte
- 5Avaliação de relevância
- Por que importa
- A resposta nasce de fontes verificáveis, e não de memória do modelo.
- Onde aparece
- Recuperação semântica na RE/MAX
Infraestrutura
Como a execução acontece de forma confiável.
Arquiteturas orientadas a eventos
Arquitetura proposta- O problema
- Fluxos longos com várias etapas e sistemas perdem o fio sem um registro do que aconteceu.
- Arquitetura
- 1Mudança de estado
- 2Evento registrado
- 3Assinantes reagem
- 4Estado reconstruível
- 5Auditoria
- Por que importa
- Todo passo vira evento, em ordem, e qualquer caso pode ser reconstruído.
- Onde aparece
- Registro de eventos no Subway
Máquinas de estados
Valores simulados- O problema
- Processos como cobrança e crédito têm etapas e regras de transição.
- Arquitetura
- 1Estados definidos
- 2Transições permitidas
- 3Guardas de política
- 4Ações por transição
- 5Estado absorvente
- Por que importa
- O sistema só faz o que a transição permite.
- Onde aparece
- Estados da cobrança
Execução distribuída
Arquitetura proposta- O problema
- Muitos casos em paralelo, com falhas parciais e reenvios.
- Arquitetura
- 1Fila de trabalho
- 2Execução em paralelo
- 3Idempotência
- 4Recuo exponencial
- 5Conclusão registrada
- Por que importa
- Reenvios não duplicam ações e a falha de uma instituição não trava as demais.
- Onde aparece
- Envio paralelo na Clave
Integrações
Como os agentes usam sistemas existentes.
MCP e integrações de ferramentas
Arquitetura proposta- O problema
- Agentes só são úteis se alcançam os sistemas onde o trabalho acontece, com permissão.
- Arquitetura
- 1Ferramenta descrita
- 2Permissão por finalidade
- 3Chamada pelo agente
- 4Resultado validado
- 5Rastro registrado
- Por que importa
- Um padrão de integração reduz código sob medida e mantém o controle de acesso.
- Onde aparece
- Agent OS
Segurança e governança
Como o sistema respeita limites e pessoas.
Segurança e controle de acesso
Arquitetura proposta- O problema
- Dados pessoais e financeiros exigem acesso mínimo e finalidade definida.
- Arquitetura
- 1Identidade
- 2Permissão mínima
- 3Finalidade registrada
- 4Acesso auditado
- 5Retenção limitada
- Por que importa
- Quem acessa o quê, e por quê, fica registrado e pode ser revisado.
- Onde aparece
- Governança na Clave
Governança com pessoas no ciclo
Valores simulados- O problema
- Automação sem limites decide o que não devia.
- Arquitetura
- 1Política define o limite
- 2Sistema executa dentro dele
- 3Exceção aparece
- 4Pessoa decide
- 5Decisão registrada
- Por que importa
- A autonomia tem arquitetura: o que passa do limite vai para quem tem alçada.
- Onde aparece
- Simulador de política
Avaliação
Como saber se o sistema continua certo.
Pipelines de avaliação
Arquitetura proposta- O problema
- Sem medir, uma melhoria percebida pode ser uma piora silenciosa.
- Arquitetura
- 1Conjunto de teste
- 2Execução do sistema
- 3Métricas por tarefa
- 4Comparação com a linha de base
- 5Decisão de liberar
- Por que importa
- Mudanças entram só quando a medida confirma.
- Onde aparece
- Pesquisa em avaliação
Observabilidade de IA
Arquitetura proposta- O problema
- Modelos mudam de comportamento quando os dados mudam.
- Arquitetura
- 1Rastros de execução
- 2Calibração
- 3Deriva dos dados
- 4Feedback humano
- 5Reavaliação do limiar
- Por que importa
- Três monitores (calibração, deriva e feedback humano) disparam a revisão do modelo.
- Onde aparece
- Observatory
Quer revisar a arquitetura com a nossa equipe?
Conte o ambiente e as restrições. Respondemos pelo e-mail que você informar.
Solicitar uma conversa técnica