1. Propósito e Escopo
Este documento define todos os prompts, configurações de memória, transição entre estados e demais requisitos funcionais para o Fluxo de Agentes "Previsão de Comportamento de Crédito", uma solução de automação projetada para prever comportamentos futuros de crédito usando dados históricos. Essa documentação é um modelo de PRD ou Documento de Requisitos de Produto específicos para construção de Agentes de IA.
O objetivo principal é melhorar a tomada de decisão das instituições financeiras, fornecendo previsões precisas e atualizadas sobre o comportamento de crédito dos clientes.
2. Contexto e Problema
Cenário Atual
As instituições financeiras enfrentam desafios significativos ao prever o comportamento de crédito de seus clientes. As decisões financeiras baseadas em previsões imprecisas ou desatualizadas podem resultar em riscos financeiros consideráveis.
- Necessidade de prever comportamentos futuros de crédito com base em dados históricos para melhorar a tomada de decisão.
- Risco associado a decisões financeiras baseadas em previsões imprecisas ou desatualizadas.
Atualmente, a previsão de comportamento de crédito é um processo manual, sujeito a erros humanos e limitações na capacidade de processar grandes volumes de dados em tempo real.
Problemas Identificados
- Previsões imprecisas: A falta de modelos preditivos avançados pode levar a previsões imprecisas, impactando negativamente as decisões financeiras.
- Atualização inadequada: Modelos preditivos que não são atualizados regularmente podem se tornar obsoletos, resultando em riscos financeiros.
- Falta de relatórios preditivos: A ausência de relatórios preditivos detalhados dificulta a tomada de decisões informadas.
3. Impactos Esperados
A implementação deste fluxo de automação visa alcançar os seguintes resultados:
- Melhorar a precisão das previsões de crédito em pelo menos 90%.
- Reduzir o risco financeiro associado a decisões baseadas em previsões imprecisas.
- Fornecer relatórios preditivos detalhados que auxiliem na tomada de decisões informadas.
4. Visão Geral da Solução
O agente de IA para previsão de comportamento de crédito utiliza modelos preditivos avançados para analisar dados históricos e prever comportamentos futuros de crédito. A seguir são detalhadas todas as regras de negócio e especificações funcionais necessárias para que esse agente atue como um assistente útil e autônomo na previsão de crédito, ajudando instituições financeiras a tomar decisões informadas.
A solução consiste em um fluxo de automação composto por 3 agentes de IA. O processo inicia com a validação e padronização dos dados de crédito e termina com a geração de um relatório executivo de risco de crédito.
A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.
| Agentes | Função Principal |
|---|---|
Agente de Validação e Padronização de Dados de Crédito (RF 1)
| Validar, higienizar e padronizar dados históricos de crédito. |
Agente de Scoring e Previsão de Comportamento de Crédito (RF 2)
| Calcular probabilidade de inadimplência e fornecer recomendações de ação. |
Agente de Relatório Executivo de Risco de Crédito (RF 3)
| Gerar um relatório executivo padronizado para suporte à decisão. |
5. Protótipos
Para proporcionar uma visão clara e tangível da solução proposta, criamos protótipos interativos que demonstram tanto o fluxo de trabalho dos agentes quanto o resultado final que o cliente receberá. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Validação e Padronização de Dados de Crédito
1.1 Tarefa do Agente
Validar, higienizar e padronizar dados históricos de crédito, produzindo um dataset estruturado e pronto para scoring preditivo.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um conjunto de dados históricos de crédito. Este conjunto de dados contém informações financeiras de clientes, que são essenciais para a análise preditiva.
# 2. Objetivo
Validar, higienizar e padronizar os dados de crédito, garantindo que estejam prontos para o próximo estágio de análise preditiva.
# 3. Regras que você deve seguir para gerar sua resposta
- Assegure-se de que os dados estejam completos e em conformidade com o esquema mínimo necessário.
- Normalize os dados para garantir consistência e comparabilidade.
- Identifique e trate quaisquer discrepâncias ou valores ausentes nos dados.
- Produza um relatório de qualidade de dados que inclua métricas e correções aplicadas.
# 4. Exemplo de Output que você deve produzir
{
"standardized_data": [...],
"feature_dictionary": {...},
"data_quality_report": {...},
"data_quality_status": "ok",
"ready_for_scoring": true
} 1.3 Configurações do Agente
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 conjunto 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 na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: Conjunto de dados em JSON ou CSV tabular.
-
Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos:
.json,.csv. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 150.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON estruturado contendo os dados padronizados, um dicionário de variáveis derivadas e um relatório de qualidade dos dados.
-
Exemplo de Estrutura de Output:
{ "standardized_data": [...], "feature_dictionary": {...}, "data_quality_report": {...}, "data_quality_status": "ok", "ready_for_scoring": true } - Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 10.000 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: Utiliza lógica interna para normalizações e cálculos de qualidade dos dados.
- 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 Scoring e Previsão de Comportamento de Crédito (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Scoring e Previsão de Comportamento de Crédito (RF 2).
RF 2. Agente de Scoring e Previsão de Comportamento de Crédito
2.1 Tarefa do Agente
Calcular probabilidade de inadimplência em 12 meses, faixas de risco, métricas de perda e recomendações de ação, a partir de dados padronizados.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados padronizados de crédito, prontos para análise preditiva.
# 2. Objetivo
Calcular a probabilidade de inadimplência em 12 meses, determinar faixas de risco e fornecer recomendações de ação baseadas nos dados recebidos.
# 3. Regras que você deve seguir para gerar sua resposta
- Utilize modelos preditivos avançados para calcular a probabilidade de inadimplência.
- Classifique os clientes em faixas de risco com base em suas probabilidades de inadimplência.
- Forneça recomendações de ação para cada faixa de risco.
- Produza um resumo das previsões e métricas de perda para cada cliente.
# 4. Exemplo de Output que você deve produzir
{
"predictions": [...],
"summary": {...},
"ready_for_report": true
} 2.3 Configurações do Agente
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: Dados padronizados de crédito em formato JSON.
-
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é 50.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON contendo as previsões de inadimplência, faixas de risco e recomendações de ação.
-
Exemplo de Estrutura de Output:
{ "predictions": [...], "summary": {...}, "ready_for_report": true } - Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 8.000 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: Utiliza lógica interna para cálculos preditivos e métricas de risco.
- 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 Relatório Executivo de Risco de Crédito (RF 3).
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Relatório Executivo de Risco de Crédito (RF 3).
RF 3. Agente de Relatório Executivo de Risco de Crédito
3.1 Tarefa do Agente
Gerar um relatório executivo padronizado que sintetiza previsões e recomendações para suporte à decisão.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo previsões de crédito e um resumo das métricas de perda gerados pelo agente anterior.
# 2. Objetivo
Gerar um relatório executivo padronizado que sintetize as previsões de crédito e forneça recomendações de políticas para suporte à decisão.
# 3. Regras que você deve seguir para gerar sua resposta
- Estruture o relatório em seções claras e objetivas, destacando as principais métricas de risco e recomendações.
- Inclua um resumo executivo com os principais números e insights estratégicos.
- Forneça recomendações de políticas baseadas nas distribuições de risco observadas.
- Assegure-se de que o relatório seja claro, conciso e fácil de interpretar.
# 4. Exemplo de Output que você deve produzir
{
"executive_summary": "...",
"portfolio_kpis": {...},
"distribuicoes_por_faixa": {...},
"clientes_top_risco": [...],
"recomendacoes_de_politica": "...",
"anexos_tecnicos": "..."
} 3.3 Configurações do Agente
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: Previsões de crédito e resumo das métricas de perda em formato JSON.
-
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é 30.000 caracteres.
3.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON estruturado contendo o relatório executivo com sumário, KPIs, distribuições de risco e recomendações de política.
-
Exemplo de Estrutura de Output:
{ "executive_summary": "...", "portfolio_kpis": {...}, "distribuicoes_por_faixa": {...}, "clientes_top_risco": [...], "recomendacoes_de_politica": "...", "anexos_tecnicos": "..." } - Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 12.000 caracteres.
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: Utiliza lógica interna para cálculos de KPIs e distribuições de risco.
- 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 é o entregável final e não é passada para outros agentes internos.
3.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.