Skip to main content
Resumo: o Comitê de Crédito IA reproduz um comitê humano. Depois que a GYRA+ gera os pareceres por seção e a política de crédito conclui, sete agentes especialistas analisam o caso em paralelo (cada um no seu domínio) e um Presidente reconcilia tudo numa decisão única, com justificativa, condições, registro de divergência e nível de alçada. O comitê pode rodar automaticamente (configurado na política) ou ser convocado manualmente no relatório ou via API. Nos planos Business e Enterprise, sua instituição adiciona instruções próprias aos agentes, para o comitê deliberar com o apetite e a política interna da casa.

​
Onde o comitê entra

O comitê é a última camada da análise. Ele não lê dado cru: lê o que as camadas anteriores já processaram. Isso tem duas consequências práticas:
  1. O comitê só roda depois que os pareceres por seção e a política terminam. Não existe comitê no meio do processamento.
  2. O comitê não substitui a política. A política continua sendo a régua da casa; o comitê traz a leitura qualitativa que a regra numérica não captura, e (dependendo do modo) sugere ou aplica a decisão.
Não confunda com os Pareceres GYRA+ IA. O parecer é a leitura de uma seção isolada. O comitê é a deliberação sobre o conjunto dos pareceres, e produz uma decisão.

​
Os agentes

Sete especialistas rodam em paralelo, cada um enxergando apenas os pareceres do seu domínio. Depois, o Presidente lê os sete e decide.
O agente Cadastral é o único com acesso a busca na web. Ele pesquisa a razão social ou o nome antes de opinar, para montar um retrato atualizado do que a empresa faz de fato, porte real e notoriedade recente. Os demais agentes trabalham exclusivamente com os dados do relatório.

​
O que cada agente devolve

Cada especialista produz uma opinião estruturada:
  • score (0 a 10) no domínio dele;
  • resumo: uma frase executiva com a posição e o motivo;
  • parecer: a deliberação completa;
  • redFlags: alertas classificados como CRITICAL ou WARNING;
  • positiveFactors: fatores que sustentam a operação;
  • recommendation: APPROVE, APPROVE_WITH_RESTRICTION, REJECT ou ESCALATE;
  • confidence (0 a 1) e infoGaps: o que faltou de informação para decidir com mais segurança.

​
A decisão do Presidente

O Presidente devolve uma decisão para o relatório: Junto da decisão vêm:
  • resumo e reasoning: a justificativa executiva e a completa;
  • proximaAcao: o próximo passo recomendado ao analista;
  • conditions: ressalvas para aprovar (garantia adicional, redução de limite, etc.);
  • dissentLog: registro de divergência, quais agentes discordaram e como. É o que torna a decisão auditável;
  • monitoringItems: o que acompanhar depois do desembolso;
  • limitReview: avaliação do limite, taxa e prazo sugeridos pela política, com status ADEQUADO, REVISAR ou SEM_PARAMETROS;
  • confidence: confiança agregada da deliberação.

​
Quando o comitê é convocado

​
As três configurações da política

Na edição da política de crédito, o bloco Comitê de Crédito IA oferece três opções, e você escolhe uma:

1. Não convocar automaticamente

O comitê não roda sozinho. Ele só delibera quando alguém convoca: pelo botão Convocar Comitê dentro do relatório, ou por POST /report/{id}/committee. É o modo em que o comitê fica sob demanda, para você levar a comitê só os casos que quiser.

2. Convocar comitê e sugerir decisão

O comitê roda sozinho assim que a análise fecha e sugere a decisão. Aprovar ou negar continua com o analista, pela tela do relatório ou por POST /report/analyze. A deliberação entra como recomendação, não muda o status do relatório.

3. Convocar comitê e decisão automática

O comitê roda sozinho e aplica a decisão do Presidente no status do relatório, sem passar por um humano. Só APPROVED e REJECTED são aplicados; REQUIRES_ALCADA e NEEDS_INFO ficam registrados como sugestão e continuam esperando um analista.
Não existe uma opção chamada “manual” na lista. Quem cumpre esse papel é a primeira delas, Não convocar automaticamente: o comitê fica disponível no relatório, mas só delibera se for convocado.
A diferença entre a segunda e a terceira é só quem assina a decisão: nas duas o comitê roda sozinho, mas na segunda ele recomenda e na terceira ele decide.

​
Origem da convocação (trigger)

Toda deliberação registra de onde veio, no campo trigger:
Convocação manual sempre entra como sugestão. Mesmo numa política em Convocar comitê e decisão automática, uma deliberação convocada pelo botão ou pela API não altera o status do relatório: a decisão volta a ser do analista. Só o gatilho automático dessa política aplica o status.

​
Pré-requisitos

O comitê só delibera quando todas estas condições valem:
1

A política habilita o pipeline de parecer

Sem parecer por seção não há insumo para o comitê. Políticas sem o pipeline de parecer nunca convocam comitê.
2

Os pareceres por seção terminaram

O relatório precisa estar com a geração de pareceres concluída. Se alguma seção falhou, o comitê ainda roda, os agentes declaram o que faltou em infoGaps em vez de inventar.
3

A política de crédito concluiu

Se o relatório tem política associada, o resultado dela precisa ter chegado.
4

Não há outra deliberação em andamento

Enquanto o status estiver RUNNING, uma nova convocação é recusada.

​
Quando o comitê é pulado

Se a política está com “Usar resultado da política no relatório” ativo e a política rejeitou o caso, o comitê não é convocado e o status fica SKIPPED. Política rejeitada não vai a comitê. Um relatório com status SKIPPED ainda pode ser levado a comitê manualmente.

​
Estados da deliberação

Reconvocar é permitido a partir de DONE, ERROR e SKIPPED. Nunca por cima de RUNNING.

​
Como usar pela API

Convocar

POST /report/{id}/committee

Consultar pareceres

GET /report/{id}/insights

Consultar deliberação

GET /committee/deliberations/{reportId}
O fluxo típico de uma integração com comitê manual:
Registre o webhook COMMITTEE_FINISHED em vez de fazer polling. O payload é fino de propósito (decisão + síntese); o detalhe completo você busca em GET /report/{id}/insights ou GET /committee/deliberations/{reportId}.

​
Instruções da sua instituição nos agentes

Disponível nos planos Business e Enterprise. Fale com atendimento@gyramais.com para habilitar na sua organização.
Cada agente do comitê tem um prompt-base GYRA+ (não editável) e um campo de instruções adicionais que a sua instituição escreve. Com o recurso habilitado, o bloco Instruções adicionais dos agentes aparece na edição da política de crédito, com um campo por agente, incluindo o Presidente. É onde entram o apetite de risco, os critérios do setor e a política interna da casa. Exemplos do que costuma ser escrito:
  • No Financeiro: “Para transportadoras, considerar imobilizado alto como característica do setor, não como má gestão de capital.”
  • No Jurídico: “Nossa alçada tolera execuções fiscais abaixo de 5% do faturamento anual; acima disso, escalar.”
  • No Comportamental: “Concentração acima de 60% em conta garantida é sinal de estresse na nossa carteira.”
  • No Presidente: “Operações acima de R$ 500 mil sempre exigem alçada, mesmo com parecer favorável.”

​
O que as instruções podem e não podem fazer

As instruções são complementares. Elas calibram a análise, mas nunca sobrepõem as regras do GYRA+: Ao salvar, o texto passa por uma validação anti-injeção: instruções que tentam fazer o agente ignorar regras anteriores, mudar o formato da resposta ou aprovar/negar incondicionalmente são recusadas com uma mensagem explicando o motivo. Reescreva como orientação de análise. O limite é de 4.000 caracteres por agente, e deixar o campo vazio remove a customização e volta ao comportamento padrão.
Cada deliberação registra qual versão de prompt cada agente usou. Isso permite auditar a relação entre uma mudança de instrução e o comportamento das decisões seguintes.

​
Perguntas frequentes

Só na terceira configuração, Convocar comitê e decisão automática, e apenas quando a decisão do Presidente for APPROVED ou REJECTED. Nas outras duas, e em toda convocação manual, o comitê sugere e o analista decide.
Sim. Reconvocar a partir de DONE, ERROR ou SKIPPED gera uma nova deliberação com trigger: "RERUN". Não é possível reconvocar enquanto uma deliberação está RUNNING.
Os sete agentes rodam em paralelo. Na maioria dos casos a deliberação fecha em menos de um minuto.
O comitê ainda delibera com o que existe. Os agentes declaram explicitamente o que faltou em infoGaps, e o Presidente pode devolver NEEDS_INFO se a lacuna for determinante.
A deliberação fica no relatório na plataforma e disponível por API. Para o conteúdo do PDF, consulte Relatório.

​
Próximos passos

Política de Crédito

Onde o modo do comitê é configurado.

Convocar o Comitê (API)

Disparar a deliberação pela API.

Webhooks e Tempo Real

Receber COMMITTEE_FINISHED sem polling.

Pareceres GYRA+ IA

Os pareceres por seção que alimentam o comitê.