1. Propósito e Escopo
Este documento define todos os prompts, configurações de memória, transição entre estados, consulta a documentos e demais requisitos funcionais para o Agente de IA para Otimização de Ofertas de Crédito, uma solução projetada para personalizar e otimizar ofertas de crédito baseadas em perfis de consumidores. 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 é analisar perfis de crédito para personalizar e otimizar ofertas de crédito, maximizando a aceitação pelos consumidores e assegurando a conformidade com as normas de crédito.
2. Contexto e Problema
Cenário Atual
As instituições financeiras enfrentam desafios ao tentar personalizar ofertas de crédito para consumidores, devido à variedade de perfis de crédito e às constantes mudanças nas condições de mercado e regulamentações. Problemas específicos incluem:
- Personalização de ofertas de crédito com base em perfis individuais.
- Otimização das ofertas para maximizar a aceitação pelos consumidores.
- Ajuste de ofertas em tempo real com base em novos dados.
Atualmente, a personalização e otimização de ofertas de crédito são processos manuais e demorados, que não conseguem acompanhar a velocidade das mudanças no comportamento do consumidor e nas condições de mercado.
Problemas Identificados
- Falta de personalização: As ofertas de crédito muitas vezes não refletem as necessidades e perfis individuais dos consumidores, resultando em baixas taxas de aceitação.
- Processo manual demorado: A análise manual de perfis de crédito é lenta e não consegue acompanhar as mudanças rápidas no mercado.
- Conformidade regulatória: Garantir que todas as ofertas de crédito estejam em conformidade com as normas de crédito é um desafio constante.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Aumentar a personalização das ofertas de crédito para refletir melhor os perfis individuais dos consumidores.
- Reduzir o tempo de processamento para personalizar e otimizar ofertas de crédito.
- Assegurar conformidade com as normas de crédito em todas as ofertas.
- Melhorar a taxa de aceitação das ofertas de crédito pelos consumidores.
4. Visão Geral da Solução
O agente de IA para otimização de ofertas de crédito analisa perfis de crédito para personalizar e otimizar ofertas, maximizando a aceitação pelos consumidores e assegurando a conformidade com as normas 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 personalização e otimização de ofertas de crédito.
A solução consiste em um fluxo de automação composto por 3 agentes de IA. O processo inicia com a personalização das ofertas e termina com o ajuste em tempo real com base em novos dados.
A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo. O fluxo inclui etapas condicionais que são executadas apenas se critérios específicos forem atendidos, conforme detalhado após a tabela.
| Agentes | Função Principal |
|---|---|
Agente de Personalização de Ofertas de Crédito (RF 1)
| Personalizar ofertas de crédito com base em perfis individuais de consumidores. |
Agente de Otimização de Ofertas de Crédito (RF 2)
| Otimizar ofertas de crédito para maximizar a aceitação pelos consumidores. |
Agente de Ajuste em Tempo Real (RF 3)
| Ajustar ofertas de crédito em tempo real com base em novos dados. |
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 Personalização de Ofertas de Crédito
1.1 Tarefa do Agente
Personalizar ofertas de crédito com base em perfis individuais de consumidores.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um JSON detalhado com informações do perfil de crédito do consumidor, histórico de crédito, comportamento bancário, políticas de crédito e contexto regulatório.
# 2. Objetivo
Personalizar ofertas de crédito com base nos dados recebidos, assegurando que as ofertas estejam em conformidade com as normas de crédito.
# 3. Regras que você deve seguir para gerar sua resposta
- Aplicar modelos de personalização para ajustar ofertas de crédito.
- Monitorar a resposta dos consumidores para ajustar estratégias de oferta.
- Assegurar que as ofertas estejam em conformidade com as normas de crédito.
# 4. Exemplo de Output que você deve produzir
JSON offers_result {
consumer_id,
currency,
locale,
elegibilidade_global: {status: elegivel|condicional|inelegivel|pendente_info, motivos[]},
ofertas: [{offer_id, codigo_produto, valor, prazo_meses, parcela_estimativa, cet_anual_percent, juros_nominal_anual_percent, tarifas {iof, tarifa_fixa, tarifa_percentual_valor}, custo_total, condicoes_precedentes[], validade_iso, risk_tier, dti_apos_percent, limites_atingidos[], compliance_check {teto_juros_ok, politica_ok, idade_ok, renda_ok, pep_sancoes_hold (bool), consentimento_ok}, explicacoes_chave[], pricing_basis {score, tier, spread_base_bps, cap_regulatorio_percent}, status: proposto|recusado_politica|alternativo}],
alternativas_sugeridas[] (se inelegivel),
campos_pendentes[],
auditoria {gerado_em_iso, versao_politica, versao_precificacao}
} 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 JSON com informações detalhadas do perfil 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 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 detalhadas do perfil de crédito do consumidor.
-
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é 10.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um arquivo no formato JSON contendo o resultado da personalização das ofertas de crédito.
-
Exemplo de Estrutura de Output:
{ "consumer_id": "12345", "currency": "BRL", "locale": "pt-BR", "elegibilidade_global": { "status": "elegivel", "motivos": [] }, "ofertas": [ { "offer_id": "offer_001", "codigo_produto": "prod_123", "valor": 10000, "prazo_meses": 24, "parcela_estimativa": 450, "cet_anual_percent": 12.5, "juros_nominal_anual_percent": 11.0, "tarifas": { "iof": 300, "tarifa_fixa": 100, "tarifa_percentual_valor": 1.5 }, "custo_total": 11000, "condicoes_precedentes": [], "validade_iso": "2025-12-31", "risk_tier": "B", "dti_apos_percent": 30, "limites_atingidos": [], "compliance_check": { "teto_juros_ok": true, "politica_ok": true, "idade_ok": true, "renda_ok": true, "pep_sancoes_hold": false, "consentimento_ok": true }, "explicacoes_chave": ["score no tier B", "DTI projetado 30% < limite 35%"], "pricing_basis": { "score": 750, "tier": "B", "spread_base_bps": 150, "cap_regulatorio_percent": 30 }, "status": "proposto" } ], "alternativas_sugeridas": [], "campos_pendentes": [], "auditoria": { "gerado_em_iso": "2025-12-06T15:08:00Z", "versao_politica": "1.0", "versao_precificacao": "1.0" } } - Número de caracteres esperado: O JSON de output deve ter um tamanho estimado em torno de 5.000 caracteres.
1.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
1.3.4 Ferramentas do Agente
- Documentos: Consulta documentos externos para verificar conformidade regulatória.
- Calculadora: Utiliza lógica interna para cálculos de DTI e CET.
- 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 Otimização de Ofertas 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 Otimização de Ofertas de Crédito (RF 2).
RF 2. Agente de Otimização de Ofertas de Crédito
2.1 Tarefa do Agente
Otimizar ofertas de crédito para maximizar a aceitação pelos consumidores.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um JSON com as ofertas personalizadas geradas pelo agente anterior e dados de resposta agregados.
# 2. Objetivo
Otimizar as ofertas de crédito para maximizar a aceitação pelos consumidores, balanceando aceitação, margem e risco.
# 3. Regras que você deve seguir para gerar sua resposta
- Objetivo composto: score_ranqueamento = w1*prob_aceitacao + w2*margem_esperada - w3*risco_proxy + w4*affordability, usando pesos de politicas_otimizacao.
- Estimativas por segmento: obter prob_aceitacao e margem_esperada do segmento mais específico disponível.
- Guardrails de ajuste: limitar ajustes a |apr| <= ajuste_max_apr_bps, |valor| <= ajuste_max_valor_percent do valor atual.
# 4. Exemplo de Output que você deve produzir
JSON optimized_offers {
"consumer_id": "12345",
"ranking": [
{
"offer_id": "offer_001",
"ordem": 1,
"ajuste": {"apr_bps": -10, "valor": 0, "prazo": 0},
"oferta_final": {"valor": 10000, "prazo_meses": 24, "cet_anual_percent": 12.4, "parcela_estimativa": 445},
"score_ranqueamento": 0.85,
"estimativas": {"prob_aceitacao": 0.9, "margem_esperada": 0.15, "risco_proxy": 0.05},
"adjustment_reason": "aumentar_aceitacao",
"compliance_revalidada": {"teto_juros_ok": true, "politica_ok": true}
}
],
"escolhida": {"offer_id": "offer_001"},
"estrategia": {"exploracao": false},
"explicacao_otimizacao": "Ajuste realizado para maximizar a aceitação mantendo a margem esperada.",
"auditoria": {"dados_usados": "2025-12-06T15:08:00Z", "gerado_em_iso": "2025-12-06T15:08:00Z"}
} 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 do agente anterior (RF 1).
- Tipo do input: Este agente deve ser apto a receber como input um JSON contendo as ofertas personalizadas e dados de resposta agregados.
-
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é 10.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um arquivo no formato JSON contendo o resultado da otimização das ofertas de crédito.
-
Exemplo de Estrutura de Output:
{ "consumer_id": "12345", "ranking": [ { "offer_id": "offer_001", "ordem": 1, "ajuste": {"apr_bps": -10, "valor": 0, "prazo": 0}, "oferta_final": {"valor": 10000, "prazo_meses": 24, "cet_anual_percent": 12.4, "parcela_estimativa": 445}, "score_ranqueamento": 0.85, "estimativas": {"prob_aceitacao": 0.9, "margem_esperada": 0.15, "risco_proxy": 0.05}, "adjustment_reason": "aumentar_aceitacao", "compliance_revalidada": {"teto_juros_ok": true, "politica_ok": true} } ], "escolhida": {"offer_id": "offer_001"}, "estrategia": {"exploracao": false}, "explicacao_otimizacao": "Ajuste realizado para maximizar a aceitação mantendo a margem esperada.", "auditoria": {"dados_usados": "2025-12-06T15:08:00Z", "gerado_em_iso": "2025-12-06T15:08:00Z"} } - Número de caracteres esperado: O JSON de output deve ter um tamanho estimado em torno de 4.000 caracteres.
2.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
2.3.4 Ferramentas do Agente
- Documentos: Não consulta.
- Calculadora: Utiliza lógica interna para cálculos de otimização.
- 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 Ajuste em Tempo Real (RF 3).
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Ajuste em Tempo Real (RF 3).
RF 3. Agente de Ajuste em Tempo Real
3.1 Tarefa do Agente
Ajustar ofertas de crédito em tempo real com base em novos dados.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um JSON com novos eventos e a oferta atual a ser ajustada.
# 2. Objetivo
Ajustar ofertas de crédito em tempo real com base nos novos dados recebidos, assegurando que as ofertas permanecem em conformidade com as normas de crédito.
# 3. Regras que você deve seguir para gerar sua resposta
- Classificação de eventos: mapear tipo em categorias e severidade.
- Gatilhos de ação: definir ação como recalcular, manter ou suspender com base na severidade do evento.
- Princípios de proteção ao consumidor: não piorar CET ou parcela sem justificativa de risco.
# 4. Exemplo de Output que você deve produzir
JSON real_time_adjustment {
"offer_id_original": "offer_001",
"revisao": 2,
"evento_classificado": {"tipo": "bureau_update", "severidade": "alta", "campos_afetados": ["score"]},
"acao": "recalcular",
"oferta_atualizada": {"valor": 10000, "prazo_meses": 24, "cet_anual_percent": 12.6, "parcela_estimativa": 448, "dti_apos_percent": 31, "compliance_check": {"teto_juros_ok": true, "politica_ok": true}, "explicacoes_ajuste": ["score atualizado"]},
"auditoria": {"recebido_em_iso": "2025-12-06T15:08:00Z", "processado_em_iso": "2025-12-06T15:08:00Z", "motivo_decisao": "score atualizado", "diffs": [{"campo": "score", "de": "750", "para": "730"}]}
} 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: Este agente deve ser apto a receber como input um JSON contendo novos eventos e a oferta atual a ser ajustada.
-
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 arquivo no formato JSON contendo o resultado do ajuste em tempo real da oferta de crédito.
-
Exemplo de Estrutura de Output:
{ "offer_id_original": "offer_001", "revisao": 2, "evento_classificado": {"tipo": "bureau_update", "severidade": "alta", "campos_afetados": ["score"]}, "acao": "recalcular", "oferta_atualizada": {"valor": 10000, "prazo_meses": 24, "cet_anual_percent": 12.6, "parcela_estimativa": 448, "dti_apos_percent": 31, "compliance_check": {"teto_juros_ok": true, "politica_ok": true}, "explicacoes_ajuste": ["score atualizado"]}, "auditoria": {"recebido_em_iso": "2025-12-06T15:08:00Z", "processado_em_iso": "2025-12-06T15:08:00Z", "motivo_decisao": "score atualizado", "diffs": [{"campo": "score", "de": "750", "para": "730"}]} } - Número de caracteres esperado: O JSON de output deve ter um tamanho estimado em torno de 3.000 caracteres.
3.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
3.3.4 Ferramentas do Agente
- Documentos: Não consulta.
- Calculadora: Utiliza lógica interna para cálculos de ajuste.
- 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 é 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 JSON gerado é o resultado que deve ser disponibilizado ao usuário.