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 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+.
O nome da política fica no cabeçalho. Toda política é de CPF ou de CNPJ; o tipo de documento é imutável depois de criada.Cada condição precisa de uma fonte declarada nas Fontes de dados. Se faltar, o editor mostra o aviso Fontes das regras e não salva até você declarar a fonte ou remover a condição. Ver Cada condição precisa de uma fonte declarada.
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ê salvar.
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.
Análises disparadas antes do salvamento continuam rastreáveis à versão antiga da política. A tela de resultado sempre mostra qual versão rodou.

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.
As opções com comitê exigem Parecer IA ativo na política, habilitado pela GYRA+. Em esteiras, quem define o papel do comitê é a etapa Decisão.

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

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