Skip to main content
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 gera uma nova versão automaticamente, com diff e autor. Esta página cobre o fluxo de edição e as mecânicas de versionamento e reversão.

​
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 Política de Crédito, Políticas, clicar na política que você quer editar. O editor abre com o estado atual.
2

Entrar em modo edição

Toggle Editar no cabeçalho. Enquanto em edição, as alterações ficam em um rascunho não publicado, a política em produção continua rodando a versão anterior para quem disparar análise.
3

Fazer as alterações

Tudo que pode ser editado:O menu Configurar política, à esquerda, tem as seis etapas. Tudo que pode ser editado:
  • Fontes de dados: Relatório base (nível e tipo de documento), bureau de crédito, SCR, e as fontes adicionais Cenprot (protestos nacionais, ver Protestos) e Núclea (indicadores de transações reais, PJ), 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 alçada: objetivo da política, decisão automática, quem pode alterar análises e o Comitê de Crédito IA (ver abaixo).
O nome da política e o produto vinculado ficam no cabeçalho. O tipo de documento (PF ou PJ) é imutável depois de criada.
Trocar o Relatório base para um nível menor pode remover variáveis que as suas condições e fórmulas já usam. O editor sinaliza o que quebra antes de você publicar.
4

Ver o diff

Botão Ver alterações mostra, lado a lado, o que mudou em relação à versão publicada: regras adicionadas, removidas, alteradas, fórmulas antes/depois.
5

Publicar

Clicar em Publicar. A nova versão passa a ser a vigente imediatamente. Qualquer análise disparada a partir desse momento usa a nova versão.
Análises disparadas antes da publicação continuam rastreáveis à versão antiga da política. A tela de resultado sempre mostra qual versão rodou.

​
Comitê de Crédito IA

No bloco Comitê de Crédito IA você escolhe se o comitê é convocado sozinho ao fim da análise:
  • Não convocar automaticamente: o comitê só roda pelo botão Convocar Comitê dentro do relatório, ou por POST /report/{id}/committee. É o modo manual.
  • Convocar comitê e sugerir decisão: o comitê roda sozinho e sugere; aprovar ou negar continua com o analista.
  • Convocar comitê e decisão automática: o comitê roda sozinho e aplica a decisão no status do relatório.
Com Usar resultado da política no relatório ativo, o comitê só é convocado quando a política aprova.

​
Instruções adicionais dos agentes

Disponível nos planos Business e Enterprise. Fale com atendimento@gyramais.com para habilitar na sua organização.
Com o recurso habilitado, o bloco do comitê exibe um campo de texto por agente (Cadastral, Societário, Financeiro, Comportamental, Jurídico, Macro e Setorial, Compliance e Presidente). É onde você registra as orientações da sua instituição: apetite de risco, critérios do setor que você opera e política interna. Pontos práticos:
  • 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 da publicação 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

Toda publicação gera uma nova versão da política. Cada relatório gerado registra a versão da política que rodou na análise, o que permite rastrear qualquer decisão ao conjunto exato de regras vigentes no momento. Na tela da política, a aba Histórico lista todas as versões publicadas com autor, data e o que mudou. A consulta do histórico é feita apenas pelo toolbox (não exposta via API).

​
Boas práticas

Uma mudança por publicação

Facilita entender o impacto. Evite empilhar 10 ajustes numa única publicação.

Descrição sempre preenchida

O campo descrição na publicação é o commit message da política. Futuro você agradece.

Testar antes de publicar

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 dois usuários editam a mesma política ao mesmo tempo, o último a publicar sobrescreve. A tela alerta se outra edição está em curso.
  • 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 a publicação até você remover ou desabilitar.
  • Fórmulas com variáveis inexistentes bloqueiam o salvar. Se uma variável referenciada sumiu, corrija antes de publicar.

​
Perguntas frequentes

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.
Não. Todas as versões ficam salvas indefinidamente, com diff completo.
Na aba Histórico, selecionar duas versões (checkbox) e clicar em Comparar. Mostra o diff acumulado entre as duas.
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.
Administradores e gestores de crédito veem. Analistas veem apenas a versão vigente.

​
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.