PrototipeAI | Agente de IA para Consolidação de Relatórios de Crédito

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 "Consolidação de Relatórios de Crédito", uma solução destinada a sintetizar dados de crédito de múltiplas fontes em um único relatório consolidado. 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 é transformar dados dispersos em informações consolidadas, facilitando a análise por analistas financeiros e permitindo tomadas de decisão rápidas e informadas.

2. Contexto e Problema

Cenário Atual

No cenário atual, os dados de crédito estão dispersos em múltiplas fontes, o que dificulta a análise e a tomada de decisões rápidas por parte dos analistas financeiros. A falta de um formato padronizado e consolidado dos dados representa um desafio significativo.

Problemas Identificados

Dados dispersos: A informação está espalhada em várias fontes, tornando a análise demorada e propensa a erros.
Falta de consolidação: A ausência de relatórios consolidados dificulta a visualização clara e rápida dos dados de crédito.
Necessidade de personalização: Os analistas financeiros precisam de relatórios que possam ser personalizados para atender às suas necessidades específicas.

3. Impactos Esperados

A implementação deste agente de IA visa alcançar os seguintes resultados:

Centralizar os dados de crédito em um relatório consolidado e padronizado.
Aumentar a eficiência na análise de crédito, reduzindo o tempo necessário para acessar informações críticas.
Facilitar a personalização dos relatórios de acordo com as necessidades dos analistas financeiros.

4. Visão Geral da Solução

O agente de IA para consolidação de relatórios de crédito processa dados de múltiplas fontes, aplica regras de padronização e gera um relatório consolidado para análise. 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 consolidação de relatórios de crédito que atendem às especificidades da sua empresa.

A solução consiste em um fluxo de automação composto por 5 agentes de IA, começando com a execução de chamadas às APIs de fontes de crédito e terminando com a geração de um relatório consolidado personalizável.

A execução dos agentes segue a ordem definida na tabela abaixo.

Agentes	Função Principal
`Agente de Execução de Chamada à API - Fontes de Crédito` (RF 1)	Realizar chamadas às APIs/sistemas de origem para recuperar dados de crédito necessários ao relatório consolidado.
`Agente de Harmonização e Normalização de Dados de Crédito` (RF 2)	Converter esquemas heterogêneos das fontes em um modelo de dados padronizado e coerente.
`Agente de Validação de Qualidade e Regras de Negócio` (RF 3)	Aplicar validações de integridade, consistência e regras de negócio de crédito, produzindo um dataset limpo e um relatório de qualidade.
`Agente de Consolidação e Cálculos de Portfólio de Crédito` (RF 4)	Consolidar o dataset limpo e calcular KPIs e cortes analíticos para suporte à decisão.
`Agente de Geração de Relatório Consolidado Personalizável` (RF 5)	Gerar o relatório consolidado em formato legível e personalizável para analistas financeiros, com narrativa executiva e anexos técnicos.

5. Protótipos

Para proporcionar uma visão clara e tangível da solução proposta, criamos protótipos 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.

Ver Agente na Prototipe AI

6. Requisitos Funcionais

RF 1. Agente de Execução de Chamada à API - Fontes de Crédito

1.1 Tarefa do Agente

Realizar chamadas às APIs/sistemas de origem para recuperar dados de crédito necessários ao relatório consolidado.

1.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo uma lista de requisições pronta para execução, contendo detalhes sobre as chamadas a serem realizadas às APIs de fontes de crédito.

# 2. Objetivo
Executar as chamadas de API para recuperar os dados de crédito necessários a partir das fontes especificadas.

# 3. Regras que você deve seguir para gerar sua resposta
- Utilize os detalhes fornecidos para cada requisição (base_url, endpoint, method, headers, query_params, etc.) para configurar e enviar a chamada correta.
- Registre o resultado de cada chamada no formato especificado, incluindo a data e hora de recuperação e se a paginação foi exaurida.
- Em caso de erro em uma chamada, registre o erro e continue com as próximas chamadas.

# 4. Exemplo de Output que você deve produzir
[
  {
    "fonte_id": "fonte_exemplo",
    "raw_items": [...],
    "retrieved_at_iso": "2025-12-06T04:22:00Z",
    "paginacao_exaurida": 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 uma lista de requisições 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 é uma lista de requisições configuradas para execuçã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é 50.000 caracteres.

1.3.2 Especificação do Output

Formato de output: O output deve ser uma lista de resultados por fonte no formato JSON, contendo os dados recuperados e informações adicionais, como a data de recuperação e status de paginação.

Exemplo de Estrutura de Output:

[
  {
    "fonte_id": "fonte_exemplo",
    "raw_items": [...],
    "retrieved_at_iso": "2025-12-06T04:22:00Z",
    "paginacao_exaurida": true
  }
]

Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 10.000 caracteres, podendo aumentar conforme o número de fontes e dados recuperados.

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: Realiza chamadas a APIs externas conforme especificado nas requisições.

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 Harmonização e Normalização de Dados 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 Harmonização e Normalização de Dados de Crédito (RF 2).

RF 2. Agente de Harmonização e Normalização de Dados de Crédito

2.1 Tarefa do Agente

Converter esquemas heterogêneos das fontes em um modelo de dados padronizado e coerente.

2.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um objeto com datasets por fonte contendo dados de crédito brutos.

# 2. Objetivo
Converter os dados recebidos em um modelo padronizado, garantindo a consistência e a coerência dos registros.

# 3. Regras que você deve seguir para gerar sua resposta
- Padronize chaves seguindo snake_case e datas em ISO 8601.
- Mapeie campos típicos como valor principal, saldo devedor, limite, etc., para os nomes padronizados.
- Normalize tipos de dados e valores, respeitando as regras de mapeamento e padronização definidas.
- Não invente valores. Quando ausentes, use null. Garanta que os tipos de dados sejam consistentes.

# 4. Exemplo de Output que você deve produzir
[
  {
    "borrower_id": "123456789",
    "principal_amount": 100000.00,
    "outstanding_balance": 80000.00,
    "currency": "USD",
    "retrieved_at_iso": "2025-12-06T04:22: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 um objeto com datasets por fonte contendo dados brutos de crédito.
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 array de registros normalizados no schema padronizado, preparado para validação e análise subsequente.