> ## Documentation Index
> Fetch the complete documentation index at: https://developers.gyramais.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Pareceres GYRA+ IA

> Todas as seções do relatório chegam analisadas. Um agente especialista por domínio lê os dados no contexto real do negócio e entrega parecer, score e nível de risco.

<Info>
  **Resumo:** nos relatórios **COMPLETO** e **COMPLETO+**, cada seção não chega só com dados: chega com um **parecer**. Um agente de IA especialista naquele domínio lê a seção no contexto real do negócio analisado e devolve **texto do parecer**, **score de 0 a 10**, **nível de risco** e **destaques**. São 21 seções cobertas, e está **incluído no relatório**, sem custo adicional. É a diferença entre receber uma lista de processos e receber a leitura de um advogado sobre aqueles processos.
</Info>

## O problema que isso resolve

Um relatório de crédito completo devolve centenas de campos. Processos judiciais, endividamento bancário mês a mês, certidões, quadro societário, protestos, exposição em mídia. O dado está todo lá, e é justamente esse o problema: **o dado bruto transfere o trabalho de interpretação para você**.

Trinta processos trabalhistas são muitos? Depende. Para uma transportadora com 400 funcionários é o esperado; para uma consultoria com 12, é um sinal. Um imobilizado alto é má gestão de capital ou é a natureza do setor? Concentração em conta garantida é estresse de caixa ou é como aquele segmento sempre operou?

**A resposta é sempre "depende do negócio".** É exatamente isso que o parecer resolve: cada agente recebe o contexto real da empresa ou pessoa antes de opinar, e avalia a seção contra o que é normal para aquele porte, aquele setor e aquele perfil.

***

## Como funciona

```mermaid theme={null}
flowchart TB
  A["Seção do relatório<br/>termina de processar"] --> B["Agente especialista<br/>daquele domínio"]
  C["Contexto do negócio<br/>porte, setor, relevância,<br/>padrões esperados"] --> B
  D["Objetivo da política<br/>o que está sendo decidido"] --> B
  B --> E["Parecer<br/>texto + score + risco + destaques"]
```

O parecer é reativo por seção: assim que **uma** seção fecha, o agente dela já roda. Você não espera o relatório inteiro para começar a ler análise.

### O contexto vem primeiro

Antes de qualquer parecer, um **agente-mãe** analisa a seção de informações básicas com busca na web e monta o **contexto do negócio**: o que a empresa faz de fato, porte real, relevância no setor e quais padrões são esperados para esse perfil. Só depois os demais agentes rodam, cada um já sabendo com quem está lidando.

<Tip>
  Essa ordem é o que separa um parecer útil de um resumo genérico. Sem contexto, um agente só consegue dizer "existem 30 processos". Com contexto, ele diz se 30 processos são muitos **para essa empresa**. Nenhuma seção é analisada sem o contexto pronto.
</Tip>

***

## O que você recebe

Cada seção analisada devolve quatro coisas:

<CardGroup cols={2}>
  <Card title="Parecer" icon="file-lines">
    O texto. A leitura crítica da seção escrita como um especialista do domínio escreveria: o que importa, o que é ruído, e o que isso significa para a decisão.
  </Card>

  <Card title="Score de 0 a 10" icon="gauge">
    A nota do agente naquele domínio, por uma **rubrica determinística**: a mesma empresa com os mesmos dados gera o mesmo score.
  </Card>

  <Card title="Nível de risco" icon="triangle-exclamation">
    `LOW`, `MEDIUM`, `HIGH` ou `CRITICAL`. Serve para ordenar a fila da mesa e cortar por régua sem ler o texto.
  </Card>

  <Card title="Destaques" icon="list-check">
    Os pontos estruturados que sustentam o parecer. É o que vira badge na tela e filtro na sua integração.
  </Card>
</CardGroup>

Na API, os quatro chegam juntos em [`GET /report/{id}/insights`](/api-reference/report/get-reportinsights):

```json theme={null}
{
  "section": "PROCESSES",
  "score": 6,
  "riskLevel": "MEDIUM",
  "parecer": "A empresa figura em 4 processos trabalhistas, volume compatível com o porte e o setor de atuação. Nenhum deles é execução, e o valor agregado representa menos de 2% do faturamento estimado...",
  "highlights": ["4 processos trabalhistas ativos", "Sem execuções fiscais"],
  "at": "2026-07-30T14:22:03.881Z"
}
```

***

## Seções com parecer

São **21 seções** cobertas. Cada uma tem um agente com a régua do seu domínio:

| Seção                   | `sectionType`                | O que o agente avalia                                                                                                                                                          |
| ----------------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Informações Básicas     | `BASIC_INFORMATION`          | **Agente-mãe.** Retrato atualizado do negócio com busca na web: o que faz de fato, porte real, relevância e padrões esperados. Produz o contexto que alimenta todos os outros. |
| Localização             | `LOCATION`                   | Coerência entre a fachada, o endereço e o negócio declarado. Usa as imagens do local.                                                                                          |
| Vínculos Societários    | `RELATIONS`                  | Quadro societário, grupo econômico, grau dos vínculos e comparação de CNAE e endereço com a empresa principal.                                                                 |
| Processos Judiciais     | `PROCESSES`                  | Natureza, polo, matéria e materialidade dos processos, ponderados pelo porte.                                                                                                  |
| Certidões               | `CERTIFICATES`               | Regularidade fiscal, trabalhista e FGTS, e o peso real de cada irregularidade.                                                                                                 |
| Licenças e Autorizações | `LICENSES_AUTHORIZATIONS`    | Licenças obrigatórias para a atividade exercida e o que a ausência de cada uma implica.                                                                                        |
| PEP                     | `PEP`                        | Exposição política e o vínculo concreto com a operação.                                                                                                                        |
| Sanções                 | `SANCTIONS`                  | Listas restritivas nacionais e internacionais, com leitura de severidade.                                                                                                      |
| Exposição em Mídia      | `MEDIA_EXPOSURE`             | Notícias relevantes, sentimento e risco reputacional recente.                                                                                                                  |
| Antecedente Criminal    | `CRIMINAL_RECORD`            | Antecedentes e mandados de prisão. Só em relatórios de PF.                                                                                                                     |
| Programas Sociais       | `SOCIAL_ASSISTANCE_PROGRAMS` | Perfil de renda e capacidade a partir de benefícios sociais. Só em relatórios de PF.                                                                                           |
| Score                   | `SCORE`                      | O score de bureau lido no contexto do negócio, não como número solto.                                                                                                          |
| SCR                     | `SCR`                        | Mix de produtos bancários, concentração por modalidade e o que indica sobre o uso de crédito.                                                                                  |
| Resumo SCR              | `SCR_SUMMARY`                | Evolução do endividamento, tendência e sinais de estresse financeiro.                                                                                                          |
| Pefin                   | `PEFIN`                      | Restritivos de credores não financeiros, com leitura de recorrência e materialidade.                                                                                           |
| Refin                   | `REFIN`                      | Restritivos de instituições financeiras.                                                                                                                                       |
| Protestos               | `PROTESTS`                   | Protestos em cartório, volume, valores e janela temporal.                                                                                                                      |
| Cheques sem Fundo       | `BAD_CHECK`                  | Ocorrências e o que sinalizam sobre a gestão de caixa.                                                                                                                         |
| Dívidas Vencidas        | `PAST_DUE_DEBT`              | Dívidas em aberto e seu peso relativo.                                                                                                                                         |
| Análise Financeira      | `BALANCE_SHEET`              | Balanço, DRE e mais de 30 indicadores lidos como um analista financeiro leria, com as particularidades do setor.                                                               |
| Setor                   | `SECTOR`                     | Panorama macro e setorial, com perspectiva de curto, médio e longo prazo.                                                                                                      |

<Note>
  As seções de PF (`CRIMINAL_RECORD`, `SOCIAL_ASSISTANCE_PROGRAMS`) só existem em relatórios de CPF, e a Análise Financeira depende do envio do balanço. O parecer aparece nas seções que o relatório efetivamente gerou.
</Note>

***

## Disponibilidade

| Tipo de relatório | Pareceres                              |
| ----------------- | -------------------------------------- |
| **COMPLETO**      | Incluído, todas as seções do relatório |
| **COMPLETO+**     | Incluído, todas as seções do relatório |
| ESSENCIAL         | Não incluído                           |

Não é add-on nem consumo à parte: nesses relatórios os pareceres **já vêm por padrão**, sem custo adicional e sem configuração. Se a sua política gera relatório COMPLETO ou COMPLETO+, as seções já estão chegando analisadas.

<Tip>
  O parecer também é o insumo do [Comitê de Crédito IA](/concepts/comite-de-credito). Sete agentes especialistas e um Presidente leem o **conjunto** dos pareceres e devolvem uma decisão de crédito com justificativa e condições. Parecer é a leitura de uma seção; comitê é a decisão sobre todas elas.
</Tip>

***

## Onde aparece

* **No toolbox**, dentro da própria seção analisada, em bloco destacado com o score e o nível de risco em badge.
* **Na API**, em [`GET /report/{id}/insights`](/api-reference/report/get-reportinsights), que devolve só os pareceres, sem os payloads pesados de integração. Aceita `?section=` para trazer um só.
* **No PDF exportado**, integrado ao corpo da seção correspondente.
* **Em tempo real**, cada parecer é publicado assim que fica pronto, sem esperar o relatório inteiro.

### Estado do parecer

Cada seção carrega o estado do seu parecer, útil para saber se vale a pena consultar de novo:

| Estado            | Significado                                                              |
| ----------------- | ------------------------------------------------------------------------ |
| `PENDING`         | Na fila.                                                                 |
| `WAITING_CONTEXT` | A seção está pronta, esperando o contexto do negócio ficar disponível.   |
| `PROCESSING`      | O agente está analisando.                                                |
| `DONE`            | Pronto. É o único estado que aparece em `GET /report/{id}/insights`.     |
| `SKIPPED`         | Pulado, tipicamente porque o contexto do negócio não pôde ser produzido. |
| `ERROR`           | A análise falhou naquela seção.                                          |

***

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="O parecer substitui o analista?">
    Não. É um copiloto. Ele faz a leitura de primeira camada com a régua de um especialista, para o analista gastar o tempo dele no julgamento de apetite e nos casos limítrofes, não em ler 200 linhas de processo.
  </Accordion>

  <Accordion title="O score do parecer é o mesmo Score da política?">
    Não. O score do parecer vai de **0 a 10** e é a nota do agente **naquela seção**. O [Score](/concepts/score) da política vai de 1 a 1000 e é o resultado do motor de regras sobre o relatório todo. São coisas diferentes com propósitos diferentes.
  </Accordion>

  <Accordion title="A IA pode inventar informação?">
    Os agentes trabalham apenas com os dados da própria seção mais o contexto do negócio. Quando falta informação para concluir, o agente **declara a lacuna** em vez de preencher. O único com acesso à web é o agente-mãe, e para pessoa física ele só usa um achado externo se conseguir confirmar a identidade por duas âncoras independentes.
  </Accordion>

  <Accordion title="O mesmo relatório gera sempre o mesmo parecer?">
    O score segue uma rubrica determinística, então a mesma empresa com os mesmos dados gera o mesmo score. O texto pode variar na redação, mas não na conclusão.
  </Accordion>

  <Accordion title="Dá para adaptar os pareceres à política interna da minha instituição?">
    No parecer por seção, não. Essa customização existe na camada do [Comitê de Crédito IA](/concepts/comite-de-credito), nos planos Business e Enterprise, onde você escreve instruções próprias por agente.
  </Accordion>
</AccordionGroup>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Comitê de Crédito IA" icon="users" href="/concepts/comite-de-credito">
    Como os pareceres viram uma decisão de crédito.
  </Card>

  <Card title="Consultar Pareceres (API)" icon="file-lines" href="/api-reference/report/get-reportinsights">
    Buscar os pareceres sem os dados brutos.
  </Card>

  <Card title="Seções do Relatório" icon="layout-panel-top" href="/concepts/secoes">
    Catálogo completo das seções e o que cada uma entrega.
  </Card>

  <Card title="Tipos de Relatório" icon="layer-group" href="/docs/tipos-relatorios">
    Diferença entre ESSENCIAL, COMPLETO e COMPLETO+.
  </Card>
</CardGroup>
