Agente de IA para Análise de Tendências em Dados de Crédito

Padronizar e validar o dataset de crédito, garantindo esquema canônico, datas e valores consistentes, e gerando um relatório de qualidade de dados para o fluxo analítico.

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 arquivo de dados de crédito 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 arquivo na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um arquivo de dados de crédito contendo informações essenciais para análise.
• Formatos Suportados: Esse agente deve ser capaz de receber dados de crédito nos formatos: .csv, .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de dados com até 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo o dataset padronizado e um relatório de qualidade de dados, conforme as regras especificadas.
• Exemplo de Estrutura de Output:

   {
    "dataset_padronizado": [
      {
        "cliente_id": "12345",
        "contrato_id": "67890",
        "data_concessao_iso": "2025-01-01",
        "data_vencimento_iso": "2025-12-31",
        "data_pagamento_iso": null,
        "valor_credito_decimal": 1000.00,
        "valor_pago_decimal": 0.00,
        "status_normalizado": "em_atraso",
        "produto": "consumo",
        "canal": "online",
        "score_risco_normalizado": 750
      }
    ],
    "data_quality_report": {
      "registros_totais": 1000,
      "registros_validos": 950,
      "registros_descartados": 50,
      "campos_nulos_por_coluna": {
        "data_pagamento_iso": 100
      },
      "duplicidades_detectadas": 5,
      "outliers_sinalizados": 10,
      "intervalos_datas_invalidos": 3,
      "mapeamento_status_usado": {
        "inad": "inadimplente",
        "default": "inadimplente",
        "em atraso": "em_atraso",
        "late": "em_atraso"
      }
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser conciso e informativo, com um tamanho estimado em torno de 5.000 caracteres, podendo variar conforme a complexidade dos dados.

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 subsequente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Cálculo de Métricas e Séries Temporais (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Cálculo de Métricas e Séries Temporais (RF 2).

Gerar séries temporais e métricas agregadas de crédito e risco em diferentes janelas e segmentos para suportar análise de tendências.

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 objeto JSON contendo o dataset padronizado e o relatório de qualidade de dados gerado pelo agente anterior.
• 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 dados com até 50.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo séries temporais e métricas agregadas de crédito e risco, conforme as regras especificadas.
• Exemplo de Estrutura de Output:

   {
    "metrics_bundle": {
      "series_temporais": [
        {
          "data_referencia": "2025-01-01",
          "concessoes_qtd": 100,
          "concessoes_valor": 1000000.00,
          "ticket_medio": 10000.00,
          "taxa_inadimplencia": 0.05,
          "taxa_atraso_30": 0.10,
          "recuperacao_valor": 500000.00,
          "recuperacao_ratio": 0.50
        }
      ],
      "segmentacoes": {
        "produto": {
          "consumo": {
            "concessoes_qtd": 50,
            "concessoes_valor": 500000.00,
            "ticket_medio": 10000.00,
            "taxa_inadimplencia": 0.04,
            "taxa_atraso_30": 0.08,
            "recuperacao_valor": 250000.00,
            "recuperacao_ratio": 0.50
          }
        }
      }
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser conciso e informativo, com um tamanho estimado em torno de 8.000 caracteres, podendo variar conforme a complexidade dos dados.

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 subsequente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Detecção de Tendências e Padrões (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Detecção de Tendências e Padrões (RF 3).

Identificar tendências, sazonalidades, anomalias e padrões de risco/retorno nas séries e segmentações calculadas.

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 objeto JSON contendo as séries temporais e métricas agregadas geradas pelo agente anterior.
• 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 dados com até 30.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo listas de tendências, sazonalidades, anomalias e padrões de segmentação, conforme as regras especificadas.
• Exemplo de Estrutura de Output:

   {
    "trends_insights": {
      "tendencias": [
        {
          "metric_id": "taxa_inadimplencia",
          "direcao": "alta",
          "periodo_inicio": "2025-01-01",
          "periodo_fim": "2025-03-31",
          "variacao_percentual": 0.10,
          "variacao_absoluta": 0.02,
          "consistencia": 0.80,
          "magnitude": "media",
          "justificativa_textual": "Aumento consistente na taxa de inadimplência devido a...",
          "evidencias": ["2025-01-01", "2025-02-01", "2025-03-01"],
          "confidence_score": 0.85
        }
      ]
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser conciso e informativo, com um tamanho estimado em torno de 10.000 caracteres, podendo variar conforme a complexidade dos dados.

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

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

3.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Geração de Insights e Recomendações Estratégicas (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Insights e Recomendações Estratégicas (RF 4).

Transformar tendências e padrões em insights executivos e recomendações priorizadas para decisão estratégica.

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 múltiplos artefatos como input, incluindo tendências, séries temporais e métricas agregadas.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de dados com até 20.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório em Markdown, além de um objeto JSON contendo recomendações priorizadas, conforme as regras especificadas.
• Exemplo de Estrutura de Output:

   {
    "recommendations_pack": {
      "recomendacoes": [
        {
          "id": "rec_001",
          "descricao": "Ajustar políticas de crédito para reduzir inadimplência.",
          "metrica_impactada": "taxa_inadimplencia",
          "direcao_esperada": "baixa",
          "segmento_alvo": "consumo",
          "janela_execucao_sugerida": "2025-04-01 a 2025-06-30",
          "impacto_estimado_categoria": "alto",
          "facilidade_execucao": "media",
          "prioridade_score": 80,
          "premissas": "Baseado em dados históricos de inadimplência.",
          "riscos": "Viés de cobertura pode afetar precisão.",
          "indicadores_de_monitoramento": "taxa_inadimplencia, volume_concessoes",
          "proxima_acao_clara": "Revisar critérios de concessão de crédito."
        }
      ]
    }
  } 

• Número de caracteres esperado: O relatório e o JSON gerado devem ser concisos e informativos, com um tamanho estimado em torno de 15.000 caracteres, podendo variar conforme a complexidade dos dados.

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 subsequente.
• Visibilidade da Resposta: A resposta gerada por este agente é o entregável final e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. O relatório e as recomendações geradas devem ser disponibilizados ao usuário.