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 "Simulação de Benefícios Previdenciários", uma solução de automação projetada para realizar simulações de possíveis benefícios previdenciários com base em diferentes cenários de contribuição e tempo de serviço. 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 é permitir que os clientes simulem diversos cenários de contribuição e tempo de serviço, oferecendo uma análise clara dos resultados para facilitar a tomada de decisão.
2. Contexto e Problema
Problemas Específicos
Os clientes desejam entender como diferentes cenários de contribuição afetam seus benefícios previdenciários. Além disso, há uma necessidade de simular o impacto do tempo de serviço nos benefícios.
Problemas Identificados
- Compreensão dos Cenários: Os clientes enfrentam dificuldades para compreender como diferentes cenários de contribuição e tempo de serviço influenciam seus benefícios futuros.
- Análise de Impacto: Falta de ferramentas que ofereçam simulações claras sobre o impacto de diferentes períodos de contribuição nos benefícios previdenciários.
- Tomada de Decisão: Necessidade de uma análise clara e objetiva para auxiliar na tomada de decisão sobre o melhor momento e forma de se aposentar.
3. Impactos Esperados
A implementação deste fluxo de automação visa alcançar os seguintes resultados:
- Facilitar a compreensão dos benefícios previdenciários através de simulações detalhadas.
- Auxiliar na tomada de decisão fornecendo análises claras e objetivas sobre os cenários simulados.
- Aumentar a precisão das previsões de benefícios com base em dados consolidados e normalizados.
4. Visão Geral da Solução
O agente de IA para simulação de benefícios previdenciários permite aos clientes simular diversos cenários de contribuição e tempo de serviço, oferecendo uma análise clara dos resultados para facilitar a tomada de decisão. 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 simulação de benefícios previdenciários.
A solução consiste em um fluxo de automação composto por 3 agentes de IA. O processo inicia com a normalização e validação dos dados do segurado e termina com a análise comparativa e recomendação de cenários.
A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.
| Agentes | Função Principal |
|---|---|
Agente de Normalização e Validação de Dados do Segurado (RF 1)
| Padronizar e validar os dados brutos do segurado, consolidando períodos de contribuição e remunerações. |
Agente de Simulação de Benefícios Previdenciários (RF 2)
| Simular benefícios previdenciários possíveis sob múltiplos cenários de contribuição futura e datas-alvo. |
Agente de Análise Comparativa e Explicativa de Cenários (RF 3)
| Comparar resultados das simulações, destacar trade-offs e recomendar cenários. |
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 Normalização e Validação de Dados do Segurado
1.1 Tarefa do Agente
Padronizar e validar os dados brutos do segurado, consolidando períodos de contribuição e remunerações, calculando variáveis derivadas e produzindo um payload consistente para simulação.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um JSON com dados brutos do segurado: identificadores não sensíveis, data_de_nascimento, sexo (quando relevante à regra), data_referencia (ISO), historico_contributivo [{inicio, fim, categoria, salario_contribuicao, regime (RGPS/Outros), vinculo (CLT/MEI/Autonomo/Servidor), uf}], remuneracoes_mensais [{competencia AAAA-MM, salario_contribuicao}], lacunas_contributivas declaradas, cenarios (opcional), regulatory_profile (opcional).
# 2. Objetivo
Padronizar e validar os dados brutos do segurado, consolidando períodos de contribuição e remunerações, calculando variáveis derivadas e produzindo um payload consistente para simulação.
# 3. Regras que você deve seguir para gerar sua resposta
- Datas: validar formato ISO (AAAA-MM-DD). Se faltar dia, assumir último dia do mês para 'fim' e primeiro dia do mês para 'inicio'. Rejeitar períodos com inicio > fim.
- Sobreposição de períodos: unificar períodos contíguos ou sobrepostos de mesma natureza (mesmo regime e categoria). Manter separação quando houver mudança de regime/categoria.
- Cálculo de meses: para cada período, calcular meses_validados por competência (de AAAA-MM de inicio a fim, inclusive).
- Remuneração: normalizar moedas para BRL quando houver; se não houver taxa, marcar flag de baixa_confianca_monetaria e manter valor informado.
- Teto e piso: se regulatory_profile trouxer teto/piso por competência, aplicar cap no salario_contribuicao. Se ausente, manter valores e marcar flag 'teto_piso_desconhecidos'.
- Consistência entre períodos e remunerações: garantir que cada competência com remuneração pertença a um período ativo; competências fora de períodos geram flag 'competencia_sem_vinculo'.
- Derivadas: calcular idade_em_anos na data_referencia; total_meses_ate_referencia (somar meses_validados RGPS); total_meses_outros_regimes (se existirem).
- Categorias especiais: se houver vínculo potencialmente concomitante (ex.: CLT + MEI), não somar bases automaticamente; marcar 'possivel_concomitancia' e manter ambas bases para decisão do simulador.
- Campos obrigatórios mínimos: data_de_nascimento, data_referencia e pelo menos um período ou uma remuneração. Se ausente, definir calculavel=false e listar motivos em flags.
- Regulatory profile: se ausente, gerar 'regulatory_profile_utilizado' com placeholders e supor regras genéricas de acumulação de direito e cálculo do valor (sem afirmar enquadramentos legais); marcar 'perfil_regulatorio_default=true' e 'confianca_baixa=true'.
- Saída determinística: ordenar arrays por data e garantir chaves consistentes; não remover dados brutos, mas referenciá-los em 'pressupostos_aplicados'. 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 dados brutos do segurado 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 com dados brutos do segurado.
-
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é 15.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON normalizado contendo dados pessoais normalizados, períodos consolidados, remunerações normalizadas, total de meses até a referência, idade em anos, flags de consistência, pressupostos aplicados e perfil regulatório utilizado.
-
Exemplo de Estrutura de Output:
{ "dados_pessoais_normalizados": {}, "periodos_consolidados": [], "remuneracoes_normalizadas": [], "total_meses_ate_referencia": 0, "idade_em_anos": 0, "flags_consistencia": [], "pressupostos_aplicados": [], "regulatory_profile_utilizado": {} } - Número de caracteres esperado: O JSON final deve ser claro e estruturado, com um tamanho estimado em torno de 5.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 cálculos de meses e idade.
- 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 Simulação de Benefícios Previdenciários (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Simulação de Benefícios Previdenciários (RF 2).
RF 2. Agente de Simulação de Benefícios Previdenciários
2.1 Tarefa do Agente
Simular benefícios previdenciários possíveis sob múltiplos cenários de contribuição futura e datas-alvo, com checagem de elegibilidade e cálculo aproximado do valor do benefício conforme perfil regulatório informado.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um JSON normalizado do agente anterior contendo: periodos_consolidados, remuneracoes_normalizadas, total_meses_ate_referencia, idade_em_anos, data_referencia, regulatory_profile_utilizado, cenarios_simulacao [{id, descricao, data_aposentadoria_alvo (opcional), contribuicao_futura [{competencia AAAA-MM, base}], taxa_crescimento_anual_base (opcional), considerar_tempo_outros_regimes (bool)}].
# 2. Objetivo
Simular benefícios previdenciários possíveis sob múltiplos cenários de contribuição futura e datas-alvo, com checagem de elegibilidade e cálculo aproximado do valor do benefício conforme perfil regulatório informado.
# 3. Regras que você deve seguir para gerar sua resposta
- Construção de linha do tempo: para cada cenário, projetar competências futuras conforme contribuicao_futura ou, na ausência, extrapolar última base com taxa_crescimento_anual_base aplicando mês a mês.
- Acumulação de tempo: somar meses_validados atuais + meses projetados até a data_aposentadoria_alvo ou até atingir requisitos mínimos definidos em regulatory_profile (ex.: meses_minimos, idade_minima, sistema_de_pontos).
- Elegibilidade: avaliar requisitos do perfil regulatório recebido. Exemplos de parâmetros esperados no regulatory_profile: idade_minima, meses_contribuicao_minimos, formula_pontos (idade + tempo), datas_transicao, coeficiente_inicial e incremento_por_ano, piso_e_teto_de_beneficio, carencia_em_meses.
- Data mínima: quando data_aposentadoria_alvo não cumprir requisitos, calcular a primeira competência em que todos os requisitos são satisfeitos e retornar em elegibilidade.data_minima.
- Base de cálculo: calcular média das bases contributivas elegíveis conforme regras do regulatory_profile (ex.: média de X% maiores contribuições, ou toda a série). Se regra ausente, usar média simples das bases com flag de baixa_confianca.
- Coeficiente do benefício: aplicar coeficiente e incrementos definidos no regulatory_profile ao resultado da base de cálculo. Se parâmetros faltarem, usar coeficiente_default=0.6 e incremento_anual_default=0.02 por ano acima do mínimo e marcar baixa_confianca.
- Piso e teto: limitar valor_beneficio_estimado aos limites do regulatory_profile se fornecidos (piso_e_teto_de_beneficio). Se ausentes, não aplicar e registrar alerta.
- Concomitância: se flag 'possivel_concomitancia' existir, não somar bases automaticamente; calcular duas variantes (agregar vs. selecionar maior) e indicar qual maximiza o benefício.
- Outros regimes: considerar tempo de outros regimes apenas se considerar_tempo_outros_regimes=true; nunca estimar valores desses regimes, apenas contar tempo quando permitido.
- Sensibilidade: variar base de cálculo do cenário em ±10% e recalcular valor_beneficio_estimado para estimar impacto percentual.
- Confiabilidade: definir confianca em [alta, media, baixa] com base na completude do regulatory_profile, presença de tetos/pisos e consistência dos dados.
- Transparência: incluir regra_utilizada textual com resumo dos critérios aplicados e lista de parâmetros efetivamente utilizados; manter todas as suposições em suposicoes_globais. 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 normalizado contendo dados consolidados do segurado e cenários de simulação.
-
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 JSON com simulações detalhadas, incluindo elegibilidade, acumulação de tempo, base de cálculo, valor estimado do benefício, datas relevantes, sensibilidade, observações e confiabilidade.
-
Exemplo de Estrutura de Output:
{ "simulacoes": [ { "cenario_id": "1", "elegibilidade": {}, "acumulacao_tempo": {}, "base_calculo": {}, "valor_beneficio_estimado": 0, "datas_relevantes": {}, "sensibilidade": [], "observacoes": "", "confianca": "" } ] } - Número de caracteres esperado: O JSON final será estruturado e detalhado, com um tamanho estimado em torno de 7.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 de benefícios.
- 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 Análise Comparativa e Explicativa de Cenários (RF 3).
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Análise Comparativa e Explicativa de Cenários (RF 3).
RF 3. Agente de Análise Comparativa e Explicativa de Cenários
3.1 Tarefa do Agente
Comparar resultados das simulações, destacar trade-offs e recomendar cenários com comunicação clara para a tomada de decisão do cliente.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo um JSON com simulacoes do agente de simulação, incluindo métricas de elegibilidade, valores estimados, datas relevantes, sensibilidade e confianca. # 2. Objetivo Comparar resultados das simulações, destacar trade-offs e recomendar cenários com comunicação clara para a tomada de decisão do cliente. # 3. Regras que você deve seguir para gerar sua resposta - Critério de ranking: priorizar cenários elegíveis mais cedo (menor data_minima) ponderando valor_beneficio_estimado e confianca. Exemplo de score: (peso_data*normalizacao_data) + (peso_valor*normalizacao_valor) + (peso_confianca). Pesos padrão: 0.5, 0.4, 0.1. - Empates: desempatar por maior valor_beneficio_estimado; persistindo empate, maior confianca; persistindo, escolher com menor sensibilidade a variações (+/-10%). - Trade-offs: identificar ao menos três trade-offs relevantes (ex.: contribuir mais por X meses antecipa em Y meses, mas reduz liquidez; adiar data aumenta coeficiente em Z%). - Recomendação: gerar recomendacao_principal citando critérios objetivos (datas, valores, coeficiente, confiança) em linguagem simples e não normativa. - Transparência: incluir limitações e suposições centrais que podem alterar o resultado (teto/piso não aplicados, regras de transição não parametrizadas). - Determinismo: produzir ordenação estável com chaves explícitas e empates resolvidos conforme regra.
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 os resultados das simulações de benefícios previdenciários.
-
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é 12.000 caracteres.
3.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON contendo ranking de cenários, destaque de trade-offs, recomendação principal, resumo explicativo em texto, observações importantes e alertas críticos.
-
Exemplo de Estrutura de Output:
{ "ranking_de_cenarios": [], "destaque_de_tradeoffs": [], "recomendacao_principal": {}, "resumo_explicativo_em_texto": "", "observacoes_importantes": [], "alertas_criticos": [] } - Número de caracteres esperado: O JSON final será conciso e informativo, com um tamanho estimado em torno de 6.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 ranking e trade-offs.
- 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 JSON gerado é o resultado que deve ser disponibilizado ao usuário.