1
💾 O que persistir: inputs, outputs, custos
Persistencia Total significa armazenar todos os dados de cada interacao com IA.
Dados que devem ser persistidos
📥 Inputs
- • Request original
- • Contexto coletado
- • Persona injetada
- • Preferencias aplicadas
📤 Outputs
- • Resposta bruta da IA
- • JSON estruturado
- • Artefatos gerados
- • Metadados de processamento
💰 Custos
- • Tokens de entrada
- • Tokens de saida
- • Custo em USD
- • Modelo utilizado
2
🗃️ Estrutura de banco de dados
-- Tabela principal de execucoes
CREATE TABLE ai_executions (
id UUID PRIMARY KEY,
created_at TIMESTAMP DEFAULT NOW(),
user_id UUID REFERENCES users(id),
-- Input
request_raw TEXT,
context_data JSONB,
persona_id UUID REFERENCES personas(id),
preferences JSONB,
-- Output
response_raw TEXT,
response_structured JSONB,
artifact_urls TEXT[],
-- Costs
model_used VARCHAR(100),
tokens_input INTEGER,
tokens_output INTEGER,
cost_usd DECIMAL(10,6),
-- Metadata
duration_ms INTEGER,
status VARCHAR(50),
error_message TEXT
);3
📊 Audit trail completo
O audit trail permite reconstruir qualquer decisao tomada pelo sistema.
Para cada execucao, podemos responder:
- •Quem: Qual usuario fez a solicitacao?
- •O que: Qual foi o request exato?
- •Quando: Timestamp preciso da execucao
- •Como: Qual persona e preferencias foram usadas?
- •Resultado: O que a IA retornou?
- •Custo: Quanto custou essa execucao?
4
🔍 Rastreabilidade de decisoes
Com persistencia total, cada artefato pode ser rastreado ate sua origem.
Cenario: Auditor questiona um documento gerado
Resposta: Sistema mostra:
- → Request original que gerou o documento
- → Contexto que estava disponivel
- → Persona que foi usada (e por que)
- → Resposta bruta da IA
- → Como foi transformado em documento final
5
📈 Aprendizado acumulativo
Dados persistidos permitem analise e melhoria continua.
Analises possiveis
- •Quais personas performam melhor?
- •Quais requests geram mais erros?
- •Qual o custo medio por tipo de tarefa?
- •Quais usuarios mais utilizam?
Melhorias derivadas
- •Ajustar personas com base em feedback
- •Otimizar prompts que geram erros
- •Realocar budget por tarefa
- •Treinar usuarios com dificuldades
6
🔐 Seguranca e retencao
Boas praticas de seguranca
Criptografia
Dados sensiveis criptografados at-rest e in-transit
Controle de Acesso
RBAC para limitar quem ve os dados
Anonimizacao
PII removido ou mascarado quando necessario
Retencao
Politicas claras de quanto tempo manter
💡 LGPD e Compliance
Persistencia total nao significa reter para sempre. Defina politicas de retencao alinhadas com LGPD e requisitos regulatorios do seu setor.
📝 Resumo do Modulo
✓Persistir tudo - Inputs, outputs e custos
✓Audit trail - Reconstruir qualquer decisao
✓Aprendizado - Dados geram insights
✓Seguranca - Criptografia e politicas de retencao