Resumo: editar uma política é o trabalho contínuo de calibração: ajustar thresholds à medida que os resultados reais aparecem, adicionar regras novas quando o risco muda, corrigir fórmulas de precificação. Toda edição que afeta a decisão gera uma nova versão automaticamente, com histórico. Esta página cobre o fluxo de edição e as mecânicas de versionamento.
Quando editar
- Calibrar thresholds a partir de casos reais (taxa de aprovação baixa demais, falsos negativos, default inesperado).
- Adicionar regra para cobrir um cenário novo (ex: novo tipo de restritivo, nova fonte disponível).
- Ajustar precificação (taxa, prazo, valor aprovado) em resposta a mudança de funding ou apetite.
- Desabilitar regra que está gerando ruído sem valor discriminante.
Pré-requisitos
- Papel de administrador ou gestor de crédito.
- Política já existe (criada do zero ou clonada de template).
Fluxo
1
Abrir a política
Em Motor de crédito, Políticas, clicar na política que você quer editar. O editor abre com o estado atual.
2
Fazer as alterações
Enquanto você não salva, as alterações ficam só no seu navegador, e a política continua rodando a versão salva para quem disparar análise.O menu Configurar política, à esquerda, tem as seis etapas. Tudo que pode ser editado:
- Fontes de dados: Onde a política é usada (Relatório ou Esteira), Relatório base (nível ou, no uso Esteira, Nenhum, para camada), bureau de crédito, SCR, e as fontes adicionais Cenprot (protestos nacionais, ver Protestos), Núclea (indicadores de transações reais, PJ), as consultas adicionais de bureau e os Indicadores do SCR, além de Balanço patrimonial e Bases externas.
- Minhas variáveis: criar, editar e remover as fórmulas reutilizáveis (
#nome). - Condições: adicionar, remover, desabilitar, ajustar campo, operador, valor e o veredito ou a pontuação.
- Classificação de risco: ligar ou desligar a pontuação e ajustar as faixas de score e seus vereditos.
- Precificação: as fórmulas de limite, taxa e prazo. Ver Precificação.
- Decisão e inteligência: objetivo da política, quem pode sobrepor a decisão, Rota por resultado e Quem revisa (ver abaixo). O Parecer IA aparece só como status: quem liga é a GYRA+.
3
Salvar
Assim que há alteração, a barra de salvar aparece, com as opções de salvar ou descartar. Ao salvar, a política passa a valer imediatamente: qualquer análise disparada a partir desse momento usa a versão nova.Numa política de uso Esteira, depois de salvar, o editor diz em quais esteiras ela está e o que a conferência de cada uma acusou. Uma política usada por esteira ativa não pode ser desativada nem excluída enquanto a esteira estiver ativa.
Comitê de Crédito IA
Em Decisão e inteligência, Quem revisa define o papel do comitê nos resultados que vão para revisão:- Analista: um analista decide. O comitê só roda pelo botão Convocar Comitê dentro do relatório, ou por
POST /report/{id}/committee. - Comitê IA recomenda, analista decide: o comitê roda sozinho e sugere; aprovar ou negar continua com o analista.
- Comitê IA decide: o comitê roda sozinho e aplica a decisão no status do relatório.
Instruções adicionais dos agentes
Recurso habilitado por organização. Fale com
atendimento@gyramais.com para habilitar. Sem ele, o bloco não aparece e a API recusa ler ou gravar as instruções com 403: A customização dos prompts do Comitê não está habilitada para esta organização.- As instruções complementam o conhecimento do agente, não substituem o prompt-base da GYRA+.
- Elas não podem alterar o formato da resposta, a soberania da política de crédito, as regras de compliance nem o idioma. Texto que tente isso é recusado no salvamento, com a explicação do motivo.
- Limite de 4.000 caracteres por agente. Campo vazio remove a customização e volta ao padrão.
- O botão Salvar instruções é independente do salvamento da política: as instruções valem para as próximas deliberações assim que salvas.
- Cada deliberação registra qual versão de instrução cada agente usou, o que permite auditar o efeito de uma mudança.
Versionamento
A versão sobe 0,01 a cada salvamento que muda algo que afeta a decisão: condições, faixas de risco, fórmulas de preço, fontes de dados, add-ons, rota por resultado, quem revisa e onde a política é usada. Mudanças que não mexem na decisão, como nome, ligar ou desligar, objetivo, parecer e permissões, salvam sem versão nova. Cada relatório registra a versão da política que rodou, o que permite rastrear qualquer decisão ao conjunto exato de regras vigentes no momento. Editar ou excluir uma variável sua (#nome) sobe, na mesma hora, a versão de todas as políticas ativas que usam aquela variável. Pela API, a resposta traz a lista em policyVersions, com policyId, a versão anterior (from) e a nova (to). Se a política que você está editando é uma delas, o editor acompanha a versão nova e o seu próximo salvamento funciona normalmente.
O ícone Histórico de versões, no cabeçalho da política, abre o Histórico de alterações, com o que foi adicionado, removido e editado. A consulta do histórico é feita apenas pelo toolbox (não exposta via API).
Boas práticas
Uma mudança por salvamento
Facilita entender o impacto. Evite empilhar 10 ajustes numa única versão.
Declare a fonte antes da regra
Ligue a fonte em Fontes de dados antes de escrever a condição que depende dela.
Testar antes de salvar
Ao menos 1 caso
APPROVED, 1 DENIED e 1 limítrofe.Janela de observação
Depois de alterar threshold crítico, observe as próximas 20 a 50 análises antes de consolidar.
Limitações e considerações
- Edição concorrente: se outra pessoa salvou a política depois que você abriu, o seu salvamento é recusado com a mensagem Você está tentando salvar uma versão nova da política a partir de uma versão desatualizada. Use Descartar e sincronizar para carregar a versão atual e refazer a sua alteração. Pela API, o mesmo caso devolve
409("Conflito de versões"). - Tipo de documento imutável. PF não vira PJ. Para mudar, duplique e edite a cópia.
- Nível de relatório impacta campos disponíveis. Reduzir o nível (ex: de COMPLETO para ESSENCIAL) invalida regras que usam campos SCR; o editor bloqueia o salvamento até você remover ou desabilitar.
- Fórmulas com variáveis inexistentes bloqueiam o salvar. Se uma variável referenciada sumiu, corrija antes de salvar.
Perguntas frequentes
Posso editar uma política que está em uso por um lote em processamento?
Posso editar uma política que está em uso por um lote em processamento?
Pode. O lote em curso continua usando a versão vigente no momento em que foi disparado. Só novas análises pegam a versão nova.
Existe limite de versões por política?
Existe limite de versões por política?
Não. Todas as versões ficam registradas.
Mudei só o nome da política e a versão não subiu.
Mudei só o nome da política e a versão não subiu.
Correto. A versão só sobe quando a mudança afeta a decisão. Nome, ligar ou desligar, parecer e permissões não mudam o resultado da análise.
Desabilitei uma regra, mas ela ainda aparece no breakdown das análises antigas.
Desabilitei uma regra, mas ela ainda aparece no breakdown das análises antigas.
Correto. Análises antigas são rastreáveis à versão da política que rodou no momento. A regra não é apagada, só deixa de avaliar em análises futuras.
Qualquer usuário vê o histórico?
Qualquer usuário vê o histórico?
Quem acessa Políticas: administradores e gestores de crédito. Coordenadores e analistas não abrem o editor de políticas.
Próximos passos
Criar Política
Do zero, quando nenhum template serve.
Usar Templates
Partir de um template pronto.
Precificação
Fórmulas de prazo, taxa e valor.
Interpretar Resultado
Calibrar thresholds a partir do breakdown.

