Agente de IA para Otimização de Limites de Crédito

Validar o payload inicial, normalizar parâmetros e sinalizar condições de bloqueio antes das consultas externas.

1.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente é o ponto de partida do fluxo e deve ser acionado pelo envio de um JSON com informações de clientes via API. Na fase de testes, o fluxo será iniciado pelo envio manual dos dados, que serão enviados para o agente diretamente por upload do JSON na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um JSON contendo informações de clientes, documentos e janela de meses para análise.
• Formatos Suportados: Esse agente deve ser capaz de receber dados no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 10.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo as validações e normalizações realizadas.
• Exemplo de Estrutura de Output:

   {"clientes_validos": ["C123", "C987"], "clientes_sem_documento": ["C987"], "documentos_normalizados": {"C123": {"cpf_cnpj": "00000000000"}}, "janela_meses": 12, "execucao_autorizada": true} 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 500 caracteres.

1.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

1.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

1.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente Preparador de Consulta - Histórico Interno de Pagamentos (RF 2).

1.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente Preparador de Consulta - Histórico Interno de Pagamentos (RF 2).

Preparar o payload para recuperar do sistema interno o histórico de faturas/pagamentos e utilização de crédito.

2.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 1).
• Tipo do input: Este agente deve ser apto a receber como input um JSON contendo clientes válidos e a janela de meses para análise.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 5.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON preparado para a consulta ao sistema interno.
• Exemplo de Estrutura de Output:

   {"endpoint": "payments_core_historico", "params": {"clientes": ["C123", "C987"], "janela_meses": 12, "campos": ["faturas", "pagamentos", "dias_em_atraso", "limite_atual", "utilizacao_media", "saldo_em_aberto", "parcelamentos_ativos", "acordos_quitacao", "maior_faturamento_medio_6m", "utilizacao_pico_3m"]}} 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 400 caracteres.

2.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

2.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

2.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Execução de Chamada à API - Histórico Interno de Pagamentos (RF 3).

2.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Execução de Chamada à API - Histórico Interno de Pagamentos (RF 3).

Realizar chamada à API do Sistema de Faturamento/ERP para obter histórico interno.

3.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 2).
• Tipo do input: Este agente deve ser apto a receber como input um JSON preparado para consulta ao sistema interno.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 5.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o histórico interno obtido da API.
• Exemplo de Estrutura de Output:

   {"clientes": [{"id": "C123", "faturas": [...], "pagamentos": [...], "dias_em_atraso": 0, "limite_atual": 500000, "utilizacao_media": 0.42, "saldo_em_aberto": 120000, "parcelamentos_ativos": 1, "acordos_quitacao": 0, "maior_faturamento_medio_6m": 300000, "utilizacao_pico_3m": 0.88}], "meta": {"janela_meses": 12}} 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 1.000 caracteres.

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: Não se aplica (uso de ferramenta)

3.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o JSON recebido para a API do Sistema de Faturamento/ERP e retornar o histórico interno como resposta.

3.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente Preparador de Consulta - Histórico de Crédito Externo (RF 4).

3.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente Preparador de Consulta - Histórico de Crédito Externo (RF 4).

Preparar o payload para consulta ao bureau de crédito externo.

4.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 3).
• Tipo do input: Este agente deve ser apto a receber como input um JSON com clientes válidos e documentos normalizados.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 5.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON preparado para consulta ao bureau de crédito externo.
• Exemplo de Estrutura de Output:

   {"endpoint": "bureau_credito_hist", "params": {"identificadores": [{"id":"C123","cpf_cnpj":"00000000000"}], "campos": ["score", "faixa_score", "ocorrencias_negativacao", "data_ultima_negativacao", "consultas_recursos", "limites_externos"], "janela_meses": 12, "omitidos_por_falta_documento": ["C987"]}} 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 400 caracteres.

4.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

4.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

4.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Execução de Chamada à API - Bureau de Crédito (RF 5).

4.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Execução de Chamada à API - Bureau de Crédito (RF 5).

Executar consulta ao bureau de crédito para obter dados externos.

5.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 4).
• Tipo do input: Este agente deve ser apto a receber como input um JSON preparado para consulta ao bureau de crédito externo.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 5.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados externos obtidos do bureau de crédito.
• Exemplo de Estrutura de Output:

   {"clientes": [{"id":"C123","score": 712, "faixa_score": "alto", "ocorrencias_negativacao": 0, "data_ultima_negativacao": null, "consultas_recursos": 3, "limites_externos": 800000}], "meta": {"janela_meses": 12}} 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 1.000 caracteres.

5.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: Não se aplica (uso de ferramenta)

5.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o JSON recebido para a API do bureau de crédito e retornar os dados externos como resposta.

5.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Consolidação de Dados por Cliente (RF 6).

5.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Consolidação de Dados por Cliente (RF 6).

Unificar retornos internos e do bureau em um único perfil padronizado por cliente.

6.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 5).
• Tipo do input: Este agente deve ser apto a receber dois JSONs: um com o histórico interno e outro com o histórico do bureau de crédito.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input combinado de até 10.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o perfil padronizado por cliente.
• Exemplo de Estrutura de Output:

   {"clientes": [{"id":"C123","limite_atual":500000,"utilizacao_media":0.42,"dias_em_atraso":0,"score_bureau":712,"faixa_score":"alto","negativado":false,"data_ultima_negativacao": null,"consultas_ultimos_12m":3,"limites_externos":800000}], "meta": {"faltando_documento": ["C987"], "clientes_sem_dados_internos": [], "clientes_sem_dados_bureau": [], "incerteza_nivel": {"C123":"baixo","C987":"medio"}}} 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 1.500 caracteres.

6.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

6.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

6.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Modelagem Preditiva de Risco e Capacidade (RF 7).

6.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Modelagem Preditiva de Risco e Capacidade (RF 7).

Estimar PD (probabilidade de inadimplência), classe de risco e capacidade de ajuste de limite com base em heurísticas determinísticas.

7.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 6).
• Tipo do input: Este agente deve ser apto a receber como input um JSON consolidado com perfis padronizados de clientes.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 5.000 caracteres.

7.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo as estimativas de PD, classe de risco e capacidade de ajuste de limite.
• Exemplo de Estrutura de Output:

   {"clientes": [{"id":"C123","pd_estimado":0.06,"classe_risco":"baixo","capacidade_incremento_pct":0.25,"observacoes":["utilizacao_saudavel","sem_atrasos_12m"]}], "meta": {"metodologia":"heuristica_regra","versao":"1.1"}} 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 800 caracteres.

7.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

7.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

7.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Política de Crédito e Regras de Ajuste de Limite (RF 8).

7.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Política de Crédito e Regras de Ajuste de Limite (RF 8).

Converter a capacidade estimada em recomendação de ajuste de limite respeitando políticas e salvaguardas.

8.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 7).
• Tipo do input: Este agente deve ser apto a receber como input um JSON com estimativas de PD, classe de risco e capacidade de ajuste de limite.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 5.000 caracteres.

8.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo as recomendações de ajuste de limite e justificativas.
• Exemplo de Estrutura de Output:

   {"clientes": [{"id":"C123","limite_atual":500000,"acao":"aumentar","novo_limite":625000,"ajuste_pct":0.25,"classe_risco":"baixo","pd_estimado":0.06,"justificativa":["Regra_PD_baixo","Utilizacao_saudavel","Sem_atrasos_12m"]}], "politicas_aplicadas":["faixa_por_risco","tetos_operacionais","compat_externos","arredondamento_50"]} 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 1.000 caracteres.

8.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

8.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

8.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente Gerador de Relatório de Suporte à Decisão (RF 9).

8.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente Gerador de Relatório de Suporte à Decisão (RF 9).

Produzir relatório executivo em markdown com sumário e seções por cliente contendo evidências, risco e cálculo de ajuste.

9.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 8).
• Tipo do input: Este agente deve ser apto a receber como input um JSON de decisão com recomendações e políticas aplicadas.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 5.000 caracteres.

9.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório em markdown contendo sumário e seções por cliente.
• Exemplo de Estrutura de Output:

   # Relatório de Ajuste de Limites
  
  - Período analisado: 
  - Total de clientes avaliados: N
  - Distribuição por ação: {aumentar:x, manter:y, reduzir:z}
  - Média ponderada de ajuste: 
  - % clientes com bloqueio por pisca-alerta: 
  
  ## Recomendações por Cliente
  
  ### Cliente C123
  - Limite atual: 5.000,00
  - Ação recomendada: aumentar para 6.250,00 (+25%)
  - Classe de risco: baixo (PD: 6%)
  - Evidências: utilização média saudável, sem atrasos em 12m, score bureau alto
  - Regras acionadas: Regra_PD_baixo; faixa_por_risco; compat_externos; arredondamento_50
  
  ## Casos para revisão manual
  - C987: bloqueio_pisca_alerta (atraso >30d)
   

• Número de caracteres esperado: O relatório gerado deve ter um tamanho estimado em torno de 2.000 caracteres.

9.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

9.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

9.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta gerada por este agente é o entregável final e não é passada para outros agentes internos.

9.3.6 Regras de Orquestração e Transição

A execução deste agente finaliza o fluxo. O relatório gerado é o resultado que deve ser disponibilizado ao usuário.