Agente de IA para Análise de Benefícios Fiscais em Investimentos

Realizar busca online para obter textos legais, instruções normativas, limites anuais e mudanças recentes relacionados a benefícios fiscais aplicáveis a planos de aposentadoria na jurisdição informada.

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 os parâmetros de busca 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: O input inicial para o fluxo é um JSON com os parâmetros de busca.
• 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.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os resultados da busca, incluindo status, jurisdição, fontes e observações.
• Exemplo de Estrutura de Output:

   {
    "search_status":"success",
    "jurisdicao":"BR",
    "data_coleta":"2025-12-14",
    "fontes":[{"url":"https://...","titulo":"...","trechos_relevantes":["...","..."],"data_publicacao":"2024-12-01"}],
    "observacoes":"Se não encontrar fonte oficial, incluir fontes secundárias identificadas."
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 2.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 além dos coletados na busca.
• Calculadora: Não utiliza.
• Busca Online: Utiliza para executar a busca de legislação fiscal.
• Sistemas Externos: Não se conecta a sistemas externos além da busca online.

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 Extração e Normalização de Benefícios Fiscais (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Extração e Normalização de Benefícios Fiscais (RF 2).

Extrair, padronizar e consolidar a legislação coletada em um catálogo estruturado de regras de benefícios fiscais aplicáveis a planos de aposentadoria.

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 o JSON gerado pelo Agente de Busca Online de Legislação Fiscal de Aposentadoria.
• 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 contendo o catálogo de benefícios fiscais estruturado, incluindo jurisdição, versão, itens e status do catálogo.
• Exemplo de Estrutura de Output:

   {
    "catalogo_beneficios":{
      "jurisdicao":"BR",
      "versao":"2025-12-14",
      "itens":[{"id":"BENEF_DED_CONTR_ANN","tipo":"deducao","descricao":"Dedução de contribuições a plano de aposentadoria","teto_anual_moeda":"BRL","teto_anual_valor":40000,"percentual_max":null,"elegibilidade":{"idade_min":null,"renda_min":null,"renda_max":null,"situacoes":["contribuinte ativo"],"documentos_requeridos":["comprovante de contribuição"]},"restricoes":["sem dedução sobre aportes acima do teto"],"referencias_legais":[{"fonte":"https://...","data":"2024-12-01"}]}]},
    "catalog_status":"ready"
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 3.500 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 além dos fornecidos no input.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 de Benefícios Fiscais para o Cliente (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 de Benefícios Fiscais para o Cliente (RF 3).

Aplicar o catálogo de benefícios fiscais ao perfil fiscal-financeiro do cliente e calcular o potencial de aproveitamento no período vigente.

3.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 2).
• Tipo do input: Este agente deve ser apto a receber como input um JSON com dados do cliente e o catálogo de benefícios fiscais estruturado.
• 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.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo a análise de benefícios fiscais, incluindo status, ano_calendario, jurisdição, benefícios aplicáveis e não aplicáveis.
• Exemplo de Estrutura de Output:

   {
    "analysis_status":"completed",
    "ano_calendario":2025,
    "jurisdicao":"BR",
    "beneficios_aplicaveis":[{"id":"BENEF_DED_CONTR_ANN","aplicavel":true,"motivo":"atende elegibilidade","limites":{"teto_anual_moeda":"BRL","teto_anual_valor":40000},"baseline":{"contribuicao_atual":20000},"capacidade_remanescente":20000,"valor_base_deducao":20000,"economia_fiscal_estimada":6000,"assumptions":["sem outras deduções conflitantes"],"riscos":["teto pode mudar em atualização normativa"]}],
    "nao_aplicaveis":[{"id":"BENEF_ISEN_IDADE","aplicavel":false,"motivo":"idade_inferior_ao_minimo"}],
    "observacoes":"Aliquota marginal usada para estimar economia."
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 4.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 além dos fornecidos no input.
• Calculadora: Utiliza lógica interna para cálculos fiscais.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 Sugestão de Estratégias de Investimento (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Sugestão de Estratégias de Investimento (RF 4).

Propor estratégias de contribuição e alocação em planos de aposentadoria que maximizem o aproveitamento dos benefícios fiscais, respeitando perfil de risco, liquidez e restrições legais.

4.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 3).
• Tipo do input: Este agente deve ser apto a receber como input dados do cliente, análise de benefícios com status completado e lista de benefícios aplicáveis.
• 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é 20.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo as estratégias de investimento sugeridas, incluindo nome, ações, alocação sugerida, benefícios alvo, impacto fiscal estimado, riscos, racional e conflitos resolvidos.
• Exemplo de Estrutura de Output:

   {
    "estrategias":[{"nome":"Maximizar dedução anual","acoes":[{"tipo":"ajuste_contribuicao","valor_adicional":20000,"moeda":"BRL","quando":"ate_2025-12-31"}],"alocacao_sugerida":{"renda_variavel":0.4,"renda_fixa":0.6},"beneficios_alvo":["BENEF_DED_CONTR_ANN"],"impacto_fiscal_estimado":6000,"racional":"usar capacidade remanescente até o teto","riscos":["volatilidade de renda variável"],"conflitos_resolvidos":["BENEF_OPCIONAL_X"]}],
    "metricas":{"economia_total_estimada":6000,"uso_percentual_tetos":1.0},
    "status":"sugerido"
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 5.000 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 além dos fornecidos no input.
• Calculadora: Utiliza lógica interna para cálculos de alocação e impacto fiscal.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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.