Agente de IA para Integração de Sistemas Financeiros

27 de November de 2025 • Tempo de leitura: 5 min

Como criar um agente de IA que facilita a integração de sistemas financeiros com APIs de bureaus de crédito.

1. Propósito e Escopo

Este documento define todos os prompts, configurações de memória, transição entre estados, ferramentas como chamadas a sistemas externos e demais requisitos funcionais para o Agente de IA de Integração de Sistemas Financeiros. 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 é facilitar a integração de sistemas financeiros com APIs de bureaus de crédito, identificando e corrigindo incompatibilidades de dados e formatos.

2. Contexto e Problema

Cenário Atual

Empresas que lidam com dados financeiros enfrentam desafios ao integrar seus sistemas com APIs de bureaus de crédito. As principais dificuldades incluem:

  • Incompatibilidades de dados entre sistemas financeiros.
  • Erros de formato nos dados trocados entre APIs.

A falta de padronização e a complexidade dos formatos de dados resultam em integrações falhas, que podem afetar a eficiência e a precisão das operações financeiras.


Problemas Identificados

  • Incompatibilidades de Dados: As diferenças nos formatos de dados entre sistemas e APIs geram erros de integração.
  • Erros de Formatação: Erros nos dados trocados podem levar a falhas no processo de integração e na análise de crédito.

3. Impactos Esperados

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

  • Reduzir incompatibilidades de dados entre sistemas financeiros e APIs de bureaus de crédito.
  • Automatizar a correção de erros de formato nos dados trocados.
  • Melhorar a eficiência das operações de integração financeira.

4. Visão Geral da Solução

O agente de IA para integração de sistemas financeiros valida dados antes da integração, sugere correções automáticas para incompatibilidades e fornece relatórios detalhados para acompanhamento. 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 integração de sistemas financeiros com APIs de bureaus de crédito.

A solução é composta por três agentes de IA que trabalham em sequência para garantir a compatibilidade dos dados e a correção de erros:

Agentes Função Principal
Agente de Validação de Dados Financeiros (RF 1) Validar dados antes da integração para garantir compatibilidade.
Agente de Correção de Incompatibilidades (RF 2) Sugerir correções automáticas para incompatibilidades detectadas.
Agente de Relatórios de Integração (RF 3) Fornecer relatórios de integração para acompanhamento.

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 Validação de Dados Financeiros

1.1 Tarefa do Agente

Validar dados antes da integração para garantir compatibilidade.

1.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados financeiros em formato JSON para integração com APIs de bureaus de crédito.

# 2. Objetivo
Validar os dados para garantir compatibilidade, identificando e reportando incompatibilidades encontradas.

# 3. Regras que você deve seguir para gerar sua resposta
- Verifique se a estrutura dos dados recebidos está conforme o padrão esperado, garantindo que todos os campos necessários estejam presentes e sigam o formato correto.
- Valide os tipos de dados para cada campo, assegurando que estejam corretos e correspondam às especificações do sistema de destino.
- Identifique e reporte campos obrigatórios ausentes, detalhando a natureza da ausência e o impacto potencial na integração.

# 4. Exemplo de Output que você deve produzir
{
  "status": "validação concluída",
  "incompatibilidades": [
    {
      "campo": "data_nascimento",
      "problema": "Formato de data incorreto",
      "impacto": "Impossível validar idade do cliente"
    }
  ]
} 
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 dados financeiros em JSON 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 arquivo JSON na interface da Prototipe AI, para acelerar o processo de validação.
  • Tipo do input: O input inicial para o fluxo é um arquivo JSON contendo dados financeiros.
  • Formatos Suportados: Esse agente deve ser capaz de receber dados 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 um JSON contendo o status da validação e uma lista de incompatibilidades encontradas.
  • Exemplo de Estrutura de Output:
     {
      "status": "validação concluída",
      "incompatibilidades": [
        {
          "campo": "data_nascimento",
          "problema": "Formato de data incorreto",
          "impacto": "Impossível validar idade do cliente"
        }
      ]
    } 
  • Número de caracteres esperado: O JSON gerado deve ser conciso, com 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.
  • 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 Correção de Incompatibilidades (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Correção de Incompatibilidades (RF 2).

RF 2. Agente de Correção de Incompatibilidades

2.1 Tarefa do Agente

Sugerir correções automáticas para incompatibilidades detectadas.

2.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um JSON com uma lista de incompatibilidades detectadas nos dados financeiros.

# 2. Objetivo
Sugerir correções automáticas para cada incompatibilidade encontrada.

# 3. Regras que você deve seguir para gerar sua resposta
- Para campos com tipo de dado incorreto, sugira a conversão para o tipo correto, especificando a alteração necessária e justificativa.
- Para campos ausentes, sugira valores padrão baseados em dados históricos ou padrões estabelecidos, com uma lógica de seleção clara.
- Para incompatibilidades de formato, sugira o formato correto baseado nas especificações da API de destino, descrevendo as etapas para a correção.

# 4. Exemplo de Output que você deve produzir
{
  "sugestoes": [
    {
      "campo": "data_nascimento",
      "sugestao": "Converter para o formato YYYY-MM-DD",
      "justificativa": "Formato requerido pela API de destino"
    }
  ]
} 
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 JSON contendo a lista de incompatibilidades detectadas nos dados financeiros.
  • 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.

2.3.2 Especificação do Output

  • Formato de output: O output deve ser um JSON contendo sugestões de correção para cada incompatibilidade encontrada.
  • Exemplo de Estrutura de Output:
     {
      "sugestoes": [
        {
          "campo": "data_nascimento",
          "sugestao": "Converter para o formato YYYY-MM-DD",
          "justificativa": "Formato requerido pela API de destino"
        }
      ]
    } 
  • Número de caracteres esperado: O JSON gerado deve ser conciso, com um tamanho estimado em torno de 1.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: Não utiliza.
  • 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 Relatórios de Integração (RF 3).

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

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

RF 3. Agente de Relatórios de Integração

3.1 Tarefa do Agente

Fornecer relatórios de integração para acompanhamento.

3.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados de integração processados e corrigidos.

# 2. Objetivo
Gerar um relatório em markdown detalhando o processo de integração e correções aplicadas.

# 3. Regras que você deve seguir para gerar sua resposta
- Liste todas as incompatibilidades detectadas e suas correções, detalhando as ações tomadas e justificativas.
- Inclua estatísticas sobre o número de registros processados e corrigidos, fornecendo uma visão clara do impacto das correções.
- Destaque quaisquer problemas não corrigidos automaticamente, sugerindo revisão manual e possíveis soluções alternativas.

# 4. Exemplo de Output que você deve produzir
**Relatório de Integração de Dados Financeiros**

- **Incompatibilidades Corrigidas:**
  - Campo: data_nascimento
    - Correção: Converter para o formato YYYY-MM-DD
    - Justificativa: Formato requerido pela API de destino

- **Estatísticas:**
  - Registros processados: 1000
  - Correções aplicadas: 50

- **Problemas Restantes:**
  - Nenhum problema restante detectado. 
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 dados de integração processados e corrigidos.
  • 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.

3.3.2 Especificação do Output

  • Formato de output: O output deve ser um relatório em markdown detalhando o processo de integração e correções aplicadas.
  • Exemplo de Estrutura de Output:
     **Relatório de Integração de Dados Financeiros**
    
    - **Incompatibilidades Corrigidas:**
      - Campo: data_nascimento
        - Correção: Converter para o formato YYYY-MM-DD
        - Justificativa: Formato requerido pela API de destino
    
    - **Estatísticas:**
      - Registros processados: 1000
      - Correções aplicadas: 50
    
    - **Problemas Restantes:**
      - Nenhum problema restante detectado. 
  • Número de caracteres esperado: O relatório gerado deve ser claro e informativo, com um tamanho estimado em torno de 3.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: Não utiliza.
  • 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 relatório gerado é o resultado que deve ser disponibilizado ao usuário.

© 2025 prototipe.ai. Todos os direitos reservados.