Agente de IA para Emissão de Relatórios de Crédito Personalizados

Definir escopo da coleta, mapear fontes e preparar os parâmetros/payloads para recuperação de dados financeiros e históricos de transações.

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 identificador do cliente e escopo do período 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 conjunto de dados estruturados (JSON) contendo o identificador do cliente, escopo do período, consentimentos vigentes, lista de fontes disponíveis e preferências de relatório.
• Formatos Suportados: Esse agente deve ser capaz de receber dados estruturados no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 10.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON com: fontes_selecionadas[], parâmetros_por_fonte{}, campos_requeridos[], chaves_de_conciliacao[], e payloads_prontos_para_execucao[].
• Exemplo de Estrutura de Output:

   {
    "fontes_selecionadas": ["banco_A", "banco_B"],
    "parâmetros_por_fonte": {
      "banco_A": {
        "filtros": {
          "excluir_status": ["reversed", "cancelled"],
          "incluir_status": ["posted", "settled"]
        }
      }
    },
    "campos_requeridos": ["identificador_conta", "moeda", "valor", "data_transacao"],
    "chaves_de_conciliacao": ["hash1", "hash2"],
    "payloads_prontos_para_execucao": [
      {
        "endpoint": "https://api.bancoA.com/transactions",
        "headers": {"Authorization": "Bearer token"},
        "query_params": {"page_size": 100},
        "estrategia_paginacao": "cursor"
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 1.500 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: Não utiliza.
• 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 Execução de Chamada à API (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Execução de Chamada à API (RF 2).

Realizar chamadas às APIs das fontes mapeadas para obter dados financeiros e históricos de transações.

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 objeto JSON com payloads prontos para execução, contendo endpoint, headers, query_params e estratégia de paginaçã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 até 10.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo arrays de transacoes, limites, saldos e metadados de paginação por fonte.
• Exemplo de Estrutura de Output:

   {
    "dados_brutos_por_fonte": {
      "banco_A": {
        "transacoes": [...],
        "limites": [...],
        "saldos": [...],
        "metadados_paginacao": {...}
      }
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Faz chamadas a sistemas externos para recuperar dados financeiros.

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 Consolidação e Normalização de Dados Financeiros (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Consolidação e Normalização de Dados Financeiros (RF 3).

Normalizar e unificar os dados brutos em um esquema canônico, deduplicando e enriquecendo com métricas base.

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 objeto JSON com dados brutos por fonte, campos requeridos, chaves de conciliação e metadados de coleta.
• 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 até 20.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo o dataset canônico com: contas[], transacoes[], saldos_por_conta[], limites_por_conta[], e data_quality_summary.
• Exemplo de Estrutura de Output:

   {
    "dataset_canonico": {
      "contas": [...],
      "transacoes": [...],
      "saldos_por_conta": [...],
      "limites_por_conta": [...],
      "data_quality_summary": {...}
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 10.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.
• Calculadora: Utiliza lógica interna para normalização e cálculo de métricas financeiras.
• 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 Análise de Risco de Crédito (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Análise de Risco de Crédito (RF 4).

Produzir análise de risco, métricas e insights com base no dataset canônico.

4.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 3).
• Tipo do input: Este agente deve ser apto a receber como input um objeto JSON com o dataset canônico, contendo contas, transacoes, saldos, limites e data_quality_summary.
• 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 até 10.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON com analise_credito contendo: indicadores_chave, sinais_de_alerta[], capacidade_pagamento, comportamento_pagamento, limites_sugeridos, faixas_de_risco, justificativas.
• Exemplo de Estrutura de Output:

   {
    "analise_credito": {
      "indicadores_chave": {...},
      "sinais_de_alerta": [...],
      "capacidade_pagamento": {...},
      "comportamento_pagamento": {...},
      "limites_sugeridos": {...},
      "faixas_de_risco": {...},
      "justificativas": "..."
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado 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.
• Calculadora: Utiliza lógica interna para cálculos de risco e métricas financeiras.
• 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 deve ser visível para o Agente de Geração de Relatório Base (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Relatório Base (RF 5).

Transformar a análise em um relatório base estruturado.

5.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 4).
• Tipo do input: Este agente deve ser apto a receber como input um objeto JSON com a analise_credito, dataset_canonico e preferências de seção e idioma.
• 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 até 10.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON com relatorio_base contendo metadados (versao, data_geracao), sumario_execucao, seções padrão e anexos-tabelas.
• Exemplo de Estrutura de Output:

   {
    "relatorio_base": {
      "metadados": {
        "versao": "1.0.0",
        "data_geracao": "2025-12-05"
      },
      "sumario_execucao": "...",
      "secoes": {
        "perfil_financeiro": "...",
        "analise_risco": "...",
        "indicadores_chave": "...",
        "recomendacoes": "...",
        "anexos": "..."
      }
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.000 caracteres.

5.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

5.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para formatação e organização de dados financeiros.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

5.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 Personalização de Relatórios (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Personalização de Relatórios (RF 6).

Ajustar conteúdo, granularidade e formato conforme preferências e necessidades do cliente.

6.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 5).
• Tipo do input: Este agente deve ser apto a receber como input um objeto JSON com o relatorio_base e preferencias_cliente (idioma, formato_saida, nivel_detalhe, secoes_habilitadas[], mascaramento_dados, estilo_visual).
• 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 até 10.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser o relatorio_personalizado no formato solicitado (JSON, PDF-estruturado, Markdown) com seções e nível de detalhe ajustados.
• Exemplo de Estrutura de Output:

   {
    "relatorio_personalizado": {
      "capa": "...",
      "sumario_execucao": "...",
      "secoes": {
        "perfil_financeiro": "...",
        "analise_risco": "..."
      }
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.000 caracteres.

6.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

6.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

6.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 Verificação de Conformidade e Privacidade (RF 7).

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

Ao concluir sua execução, esse agente aciona o Agente de Verificação de Conformidade e Privacidade (RF 7).

Garantir aderência a requisitos de privacidade, consentimento e conformidade regulatória antes da disponibilização.

7.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 6).
• Tipo do input: Este agente deve ser apto a receber como input um objeto JSON com o relatorio_personalizado, metadados de consentimento, políticas aplicáveis (LGPD/privacidade), regras de compartilhamento.
• 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 até 10.000 caracteres.

7.3.2 Especificação do Output

• Formato de output: O output deve ser o relatorio_validado com campos de conformidade: consentimento_ok, pii_mascarada, escopo_dado_ok, restricoes_compartilhamento[].
• Exemplo de Estrutura de Output:

   {
    "relatorio_validado": {
      "consentimento_ok": true,
      "pii_mascarada": true,
      "escopo_dado_ok": true,
      "restricoes_compartilhamento": ["uso_interno", "cliente"]
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.000 caracteres.

7.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

7.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

7.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 Atualização e Versionamento de Relatórios (RF 8).

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

Ao concluir sua execução, esse agente aciona o Agente de Atualização e Versionamento de Relatórios (RF 8).

Atualizar relatórios periodicamente para refletir mudanças nas circunstâncias financeiras, mantendo versionamento e diffs.

8.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 7).
• Tipo do input: Este agente deve ser apto a receber como input um objeto JSON com o relatorio_validado atual, dataset_canonico_atual, relatorio_anterior (opcional), política_de_atualizacao (periodicidade, janelas).
• 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 até 10.000 caracteres.

8.3.2 Especificação do Output

• Formato de output: O output deve ser o relatorio_atualizado com versao_incrementada, delta_metrico, status_atualizacao e change_log atualizado.
• Exemplo de Estrutura de Output:

   {
    "relatorio_atualizado": {
      "versao_incrementada": "1.1.0",
      "delta_metrico": {...},
      "status_atualizacao": "atualizado",
      "change_log": [...]
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 3.000 caracteres.

8.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

8.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para cálculos de versionamento e diferenças métricas.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

8.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 (relatorio_atualizado) é o entregável final e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. O relatório atualizado é o resultado que deve ser disponibilizado ao usuário.