Estabilidade

Documento

POLITICA_AI.md

# POLITICA DE USO DE IA (OPENAI) - NUTRIA / ESTABILIDADE

## Objetivo

Padronizar o uso de IA generativa na plataforma para garantir qualidade tecnica, rastreabilidade e seguranca.

Esta politica define quando usar IA, quando nao usar, e quais controles sao obrigatorios.

## Principio geral

Compute local, narrativa via API.

- Calculos, modelos estatisticos e regras criticas ficam no codigo local (R/Python/SQL).
- IA via API e usada para narrativa tecnica, estruturacao textual e organizacao de resultados.

## Escopo de uso permitido

Usar IA por API em modulos que geram narrativa, incluindo:

- redacao tecnica de relatorios;
- sumarizacao de resultados;
- estruturacao de conteudo em JSON para automacao;
- sugestoes de riscos, planos de mitigacao e proximos passos;
- apoio textual em contexto regulatorio e analitico.

## Escopo de uso nao permitido (sem excecao de governanca)

Nao usar IA por API para:

- substituir calculo principal de estabilidade e inferencia estatistica;
- substituir criterio tecnico decisorio final;
- emitir decisao regulatoria/final sem revisao humana;
- enviar dados sensiveis sem anonimizar quando aplicavel.

## Controles obrigatorios

Para todo modulo que usar IA por API:

1. Registrar modelo usado, timestamp e identificador de resposta quando disponivel.
2. Definir limite de saida (`max_output_tokens`) adequado ao modulo.
3. Usar prompt tecnico fixo (tom tecnico, objetivo, sem linguagem promocional).
4. Manter historico por usuario (quando aplicavel).
5. Permitir exportacao da conversa/saida (txt, md ou json).
6. Exigir revisao humana antes de uso oficial do texto em documento final.

## Classificacao do resultado da IA

Toda saida de IA deve ser tratada como:

"rascunho tecnico assistido por IA"

Documento oficial somente apos revisao e aprovacao do responsavel tecnico.

## Privacidade e seguranca

- Usar chave API via variavel de ambiente (`OPENAI_API_KEY`), nunca hardcoded.
- Evitar expor segredo em logs, telas ou repositorio.
- Minimizar envio de dados para o necessario ao objetivo da tarefa.
- Em caso de incidente de exposicao de chave, rotacionar imediatamente.

## Parametrizacao padrao recomendada

- Modelo padrao geral: familia nao-codex para modulos narrativos.
- Tom: tecnico, direto, em portugues.
- Limite de saida: alto o suficiente para relatorio, sem excesso desnecessario.
- Bloqueio de consultas triviais em modulos tecnicos (quando fizer sentido de produto).

## Aplicacao imediata no projeto

Esta politica passa a valer para:

- modulo `Consulta AI`;
- script de relatorio automatizado em `analises/estabilidade/zinco/Automatiza.R` quando usar API;
- novos modulos com narrativa tecnica.

## Governanca

Responsavel tecnico do modulo valida:

- aderencia desta politica;
- qualidade tecnica da narrativa;
- coerencia com dados e resultados locais.