Operar o ciclo de vida

MLOps e LLMOps

MLOps aplica práticas de engenharia ao ciclo dados→treino→registro→deploy→monitoramento. LLMOps acrescenta prompts, contexto, retrieval, provedores, evals e traces. Não é uma ferramenta específica.

Um release de sistema de IA inclui modelo/snapshot, prompt, schemas, ferramentas, índice, políticas e código. Alterar qualquer parte pode mudar o resultado.

Serving

Serving transforma artefato em endpoint. Decisões: CPU/GPU, memória, quantização, batching, streaming, autoscaling, cold start e isolamento. Batching melhora throughput mas aumenta espera; streaming melhora percepção, não tempo total; autoscaling de GPU pode ser lento.

Para provedor externo, ainda existem rate limits, filas, timeout, circuit breaker, fallback e privacidade. Backpressure deve recusar ou degradar de modo controlado, não acumular fila sem limite.

Deploy seguro

Promova artefatos imutáveis entre ambientes. Canary envia pequena fração e compara qualidade proxy, latência, custo e erro. Shadow replica sem afetar usuário. Feature flag separa deploy de liberação. Rollback inclui índice e prompt compatíveis, não só container.

Falhas e recuperação

OOM, driver incompatível, saturação, throttling, mudança de fornecedor, índice incompleto e regressão de prompt são incidentes diferentes. Runbook define sintoma, diagnóstico, owner, mitigação e recuperação. Teste modo degradado: busca sem geração, fila assíncrona ou encaminhamento humano.

Segurança cobre imagens assinadas, SBOM, segredo efêmero, rede, isolamento, artefato confiável e acesso ao registry. Model files podem ser perigosos; use formatos seguros e origem verificada.

Evals e operação

Gates offline antecedem deploy; canário verifica produção; feedback vira dataset somente após curadoria. SLOs: disponibilidade, p95, taxa de erro, qualidade proxy, freshness e custo. Traces precisam de retenção e redaction.

Exercício e aceite

Empacote um serviço mínimo, registre versão de todos os componentes, execute carga, canário e rollback. Simule provedor indisponível e índice incompatível. Aceite: release reproduzível; health/readiness; backpressure; observabilidade; rollback ensaiado; nenhuma credencial na imagem.

Fontes

• Google Rules of ML
• MLflow Model Registry
• Kubernetes deployment concepts
• OpenTelemetry

Laboratório e caderno de evidências

Este caderno transforma o conceito do livro em uma decisão de engenharia auditável. O cenário é Publicar uma versão do sistema de IA por canário. A regra é começar pelo sistema atual — serviço monolítico atual com rollback manual — e só acrescentar complexidade quando uma avaliação previamente definida demonstrar ganho líquido.

1. Escreva o contrato da decisão

Registre em uma página: quem usa, qual decisão recebe apoio, quais entradas existem naquele instante, qual saída é permitida, qual efeito é proibido e quem responde pelo resultado. Separe sugestão, decisão e execução. Uma resposta textual pode sugerir; a API de domínio continua autorizando e registrando qualquer mudança.

Use critérios no formato dado/quando/então. Inclua caminho nominal, ausência de dados, conflito, outro tenant, dependência indisponível e tentativa adversarial. “Funciona bem” não é critério. Declare o limite de tempo, custo, dados e risco, além da condição de parada.

2. Construa o pacote mínimo de evidência

Crie um conjunto pequeno, porém representativo, antes de alterar o sistema. Cada caso tem identificador estável, origem, resposta ou comportamento esperado, risco, tags e razão da inclusão. O conjunto de desenvolvimento ajuda a iterar; um holdout separado impede otimizar contra a própria prova. Dados reais exigem minimização, controle de acesso e retenção. Quando usar casos sintéticos, identifique-os e confirme que não substituem a distribuição real.

A comparação deve manter constantes as partes que não estão sendo avaliadas. Se trocar modelo e prompt ao mesmo tempo, você não saberá a causa. Registre versões, configurações, ambiente, seeds quando aplicável e data. Preserve os piores erros como artefatos, não apenas a média.

3. Desenhe a fronteira operacional

entrada validada → componente candidato → validação externa
                 → autorização/policy → resultado observável
                 → feedback curado → avaliação de regressão

Marque onde conteúdo não confiável entra, onde identidade e permissões são resolvidas, onde segredos ficam e qual componente pode produzir efeito. O modelo não é fonte de verdade nem mecanismo de autorização. Use schema, consulta ao sistema de registro, allowlists, limites e confirmação proporcional ao risco.

Para cada dependência defina timeout, retry, idempotência, fallback e circuit breaker. Retry não é padrão para efeitos: um timeout pode ocorrer depois do sucesso. Modo degradado precisa preservar segurança e deixar claro ao usuário o que perdeu.

4. Faça uma pré-mortem

As falhas prioritárias deste livro são: OOM; fila sem limite; índice incompatível; provider throttling. Para cada uma, escreva gatilho, impacto, detecção, contenção, recuperação e teste do controle. Inclua falha acidental e abuso deliberado. Se a única defesa é “o modelo provavelmente recusará”, o controle ainda não existe.

Execute tabletop: uma pessoa opera, outra injeta a falha e uma terceira observa. O operador deve diagnosticar usando dashboards, traces e runbook, sem depender do autor. Registre lacunas e transforme recorrência em teste, política, alerta ou mudança arquitetural.

5. Meça o sistema completo

O painel mínimo acompanha p95; saturação; fila; taxa de fallback; qualidade canário. Faça cortes por versão, tipo de tarefa, risco e população relevante. Latência fim a fim inclui fila, retrieval e ferramentas. Custo é dividido por tarefa concluída, não por chamada. Qualidade em produção usa sinais curados; clique ou concordância do usuário não prova correção.

Defina SLO e orçamento de erro quando houver operação contínua. Alertas precisam de owner e ação. Telemetria passa por redaction antes de sair do processo; prompt, documento, memória ou trace completo podem conter informação pessoal, segredo ou conteúdo malicioso.

6. Libere em degraus

A sequência segura é offline, shadow, equipe interna, canário, aumento gradual e produção. Cada degrau possui gate e rollback. Feature flag separa deploy de liberação. A reversão deste cenário é: rollback coordenado de código, prompt, modelo e índice. Treine a reversão antes do incidente e verifique que dados derivados, filas e caches também retornam a estado compatível.

Mudança de modelo, prompt, índice, ferramenta, policy ou dataset é mudança de sistema. Rode regressão proporcional. Um fornecedor atualizar silenciosamente comportamento não remove sua obrigação de testar.

Matriz de aceite

Dimensão	Evidência exigida	Falha que bloqueia
valor	ganho sobre baseline em casos representativos	demo isolada sem comparação
correção	golden set, holdout e análise dos piores casos	métrica média sem cauda
segurança	testes negativos de identidade, dados e efeitos	policy apenas no prompt
privacidade	minimização, finalidade, retenção e exclusão	dado sensível em trace
operação	SLO, alerta, runbook e rollback exercitado	dependência sem timeout
governança	owner, versão, usos permitidos e revisão	sistema órfão

Exercício de competência

Entregue um repositório ou pacote reproduzível contendo contrato, diagrama de fronteiras, casos de avaliação, script de execução, relatório comparativo, threat model, dashboard mínimo e runbook. Introduza deliberadamente duas falhas da pré-mortem e demonstre detecção e recuperação. Outra pessoa deve conseguir repetir o resultado sem explicação oral.

A aprovação exige: baseline preservado; critérios definidos antes do resultado; pelo menos um caso em que o sistema se abstém; efeito sensível protegido fora do modelo; custos medidos; rollback testado; limitações e usos proibidos escritos. Se o candidato não superar o baseline com segurança, documentar “não adotar” é um resultado tecnicamente correto.

Perguntas de recuperação ativa

1. Qual afirmação deste sistema depende de evidência externa?
2. O que o modelo pode propor, mas jamais autorizar?
3. Qual mudança invalidaria o holdout?
4. Como detectaríamos a pior falha antes do usuário?
5. Qual é o caminho de retirada em menos de uma hora?

Relações

Use este caderno junto ao livro de evals para desenho estatístico, ao de segurança para cenários adversariais, ao de observabilidade para sinais e ao de UX para supervisão. A profundidade nasce da conexão entre decisão, implementação, medição e recuperação — não da quantidade de ferramentas citadas.