Agente de IA para Consolidação de Dados de Faturamento

20 de December de 2025 • Tempo de leitura: 5 min

Como criar um agente de IA que consolida dados de faturamento de múltiplas fontes.

Biblioteca de Prompts e Agentes

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 Dados de Faturamento", uma solução de automação projetada para consolidar dados de faturamento de múltiplas fontes, facilitando a análise e o fechamento contábil mensal. 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 um formato padrão, facilitando a análise e o fechamento contábil mensal.

2. Contexto e Problema

Cenário Atual

As empresas enfrentam desafios significativos na consolidação de dados de faturamento devido à dispersão de informações em múltiplas fontes. Essa fragmentação dificulta a análise e o fechamento contábil mensal, resultando em processos manuais demorados e propensos a erros.


Problemas Identificados

  • Dispersão de dados: Os dados de faturamento estão dispersos em diversas fontes, dificultando a consolidação e análise.
  • Complexidade no fechamento contábil: A falta de consolidação de dados aumenta a complexidade e o tempo necessário para o fechamento contábil mensal.

3. Impactos Esperados

A implementação deste fluxo de automação visa alcançar os seguintes resultados:

  • Reduzir o tempo de fechamento contábil em pelo menos 50%.
  • Aumentar a precisão dos dados consolidados, minimizando erros manuais.
  • Facilitar a análise dos dados de faturamento, proporcionando insights mais rápidos e precisos.

4. Visão Geral da Solução

O agente de IA para consolidação de dados de faturamento consolida informações de múltiplas fontes em um formato padrão, facilitando a análise e o fechamento contábil mensal. 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 dados de faturamento.

A solução consiste em um fluxo de automação composto por 8 agentes de IA. O processo inicia com a preparação de parâmetros de coleta de dados e termina com a geração de visões para o fechamento contábil.

A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.

Agentes Função Principal
Agente de Preparação de Parâmetros de Coleta (RF 1) Receber a lista de fontes de faturamento e produzir parâmetros prontos para coleta.
Agente de Execução de Chamada à API (RF 2) Realizar chamadas às APIs das fontes para obter dados brutos de faturamento.
Agente de Execução de Consultas em Banco de Dados (RF 3) Executar consultas parametrizadas em bancos de dados das fontes para obter dados brutos.
Agente de Execução de Consulta a Documento (RF 4) Realizar leitura/extração de dados de documentos de faturamento.
Agente de Padronização e Mapeamento de Esquema (RF 5) Transformar registros brutos em um esquema canônico de faturamento.
Agente de Consolidação, Deduplicação e Reconciliação Primária (RF 6) Unificar registros padronizados, remover duplicidades e reconciliar totais básicos.
Agente de Validação de Qualidade para Fechamento (RF 7) Executar checagens determinísticas para assegurar que o consolidado atende aos requisitos mínimos.
Agente de Geração de Visões para Fechamento Contábil (RF 8) Produzir saídas organizadas para análise e fechamento mensal.

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.

Ver Agente na Prototipe AI

6. Requisitos Funcionais

RF 1. Agente de Preparação de Parâmetros de Coleta

1.1 Tarefa do Agente

Receber a lista de fontes de faturamento e produzir parâmetros prontos para coleta (APIs, bases de dados e documentos/arquivos).

1.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo uma lista de fontes de faturamento. Esta lista contém informações sobre APIs, bancos de dados e documentos que precisam ser acessados para coleta de dados.

# 2. Objetivo
Produzir parâmetros prontos para a coleta de dados de faturamento, organizando-os por tipo de fonte.

# 3. Regras que você deve seguir para gerar sua resposta
- Normalize o período de coleta e garanta que todos os parâmetros necessários para a execução estejam presentes.
- Gere identificadores únicos para cada fonte e prepare as instruções de coleta divididas por tipo de fonte.
- Inclua campos de erro e pendências para itens que não estejam prontos para execução.

# 4. Exemplo de Output que você deve produzir
{
  "api_payloads": [
    {
      "fonte_id": "api_123",
      "periodo_normalizado": "2025-12-01/2025-12-31",
      "pronto_para_execucao": true
    }
  ],
  "db_queries": [
    {
      "fonte_id": "db_456",
      "periodo_normalizado": "2025-12-01/2025-12-31",
      "pronto_para_execucao": true
    }
  ],
  "doc_queries": [
    {
      "fonte_id": "doc_789",
      "periodo_normalizado": "2025-12-01/2025-12-31",
      "pronto_para_execucao": false,
      "pendencias": ["caminho não informado"]
    }
  ]
}
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 a lista de fontes de faturamento 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 contendo a lista de fontes de faturamento.
  • 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.

1.3.2 Especificação do Output

  • Formato de output: O output deve ser um JSON contendo listas separadas de parâmetros prontos para execução por tipo de fonte.
  • Exemplo de Estrutura de Output: 
     {
  "api_payloads": [
    {
      "fonte_id": "api_123",
      "periodo_normalizado": "2025-12-01/2025-12-31",
      "pronto_para_execucao": true
    }
  ],
  "db_queries": [
    {
      "fonte_id": "db_456",
      "periodo_normalizado": "2025-12-01/2025-12-31",
      "pronto_para_execucao": true
    }
  ],
  "doc_queries": [
    {
      "fonte_id": "doc_789",
      "periodo_normalizado": "2025-12-01/2025-12-31",
      "pronto_para_execucao": false,
      "pendencias": ["caminho não informado"]
    }
  ]
}
  • Número de caracteres esperado: O JSON final 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.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não se conecta a sistemas externos.

1.3.5 Memória

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), Agente de Execução de Consultas em Banco de Dados (RF 3), e Agente de Execução de Consulta a Documento (RF 4) conforme as listas de parâmetros geradas.

RF 2. Agente de Execução de Chamada à API

2.1 Tarefa do Agente

Realizar chamadas às APIs das fontes para obter dados brutos de faturamento do período definido.

2.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo uma lista de parâmetros de API prontos para execução, incluindo endpoints, headers e query_params.

# 2. Objetivo
Executar chamadas às APIs de cada fonte de faturamento para coletar dados brutos do período especificado.

# 3. Regras que você deve seguir para gerar sua resposta
- Realize as chamadas às APIs conforme os parâmetros fornecidos e registre o status de execução para cada uma.
- Em caso de falha, registre o erro e continue com a próxima chamada.

# 4. Exemplo de Output que você deve produzir
{
  "api_results": [
    {
      "fonte_id": "api_123",
      "status_execucao": "sucesso",
      "total_registros": 500
    }
  ]
}
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), se houver parâmetros de API prontos para execução.
  • Tipo do input: Este agente deve ser apto a receber um JSON contendo parâmetros de API prontos 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 até 5.000 caracteres.

2.3.2 Especificação do Output

  • Formato de output: O output deve ser um JSON contendo os resultados das chamadas às APIs, incluindo status e total de registros.
  • Exemplo de Estrutura de Output: 
     {
  "api_results": [
    {
      "fonte_id": "api_123",
      "status_execucao": "sucesso",
      "total_registros": 500
    }
  ]
}
  • Número de caracteres esperado: O JSON final deve ter 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

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

Ao concluir sua execução, esse agente aciona o Agente de Padronização e Mapeamento de Esquema (RF 5).

RF 3. Agente de Execução de Consultas em Banco de Dados

3.1 Tarefa do Agente

Executar consultas parametrizadas em bancos de dados das fontes para obter dados brutos de faturamento.

3.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo uma lista de parâmetros de consultas a banco de dados prontos para execução.

# 2. Objetivo
Executar consultas em bancos de dados para coletar dados brutos de faturamento do período especificado.

# 3. Regras que você deve seguir para gerar sua resposta
- Execute as consultas conforme os parâmetros fornecidos e registre o status de execução para cada uma.
- Em caso de falha, registre o erro e continue com a próxima consulta.

# 4. Exemplo de Output que você deve produzir
{
  "db_results": [
    {
      "fonte_id": "db_456",
      "status_execucao": "sucesso",
      "total_registros": 1000
    }
  ]
}
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 1), se houver parâmetros de consultas a banco de dados prontos para execução.
  • Tipo do input: Este agente deve ser apto a receber um JSON contendo parâmetros de consultas a banco de dados prontos 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 até 5.000 caracteres.

3.3.2 Especificação do Output

  • Formato de output: O output deve ser um JSON contendo os resultados das consultas a banco de dados, incluindo status e total de registros.
  • Exemplo de Estrutura de Output: 
     {
  "db_results": [
    {
      "fonte_id": "db_456",
      "status_execucao": "sucesso",
      "total_registros": 1000
    }
  ]
}
  • Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 1.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

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

Ao concluir sua execução, esse agente aciona o Agente de Padronização e Mapeamento de Esquema (RF 5).

RF 4. Agente de Execução de Consulta a Documento

4.1 Tarefa do Agente

Realizar leitura/extração de dados de documentos e arquivos de faturamento do período definido.

4.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo uma lista de parâmetros para leitura de documentos prontos para execução.

# 2. Objetivo
Realizar a leitura de documentos de faturamento para coletar dados brutos do período especificado.

# 3. Regras que você deve seguir para gerar sua resposta
- Realize a leitura dos documentos conforme os parâmetros fornecidos e registre o status de execução para cada um.
- Em caso de falha, registre o erro e continue com a próxima leitura.

# 4. Exemplo de Output que você deve produzir
{
  "doc_results": [
    {
      "fonte_id": "doc_789",
      "status_execucao": "sucesso",
      "total_registros": 200
    }
  ]
}
4.3 Configurações do Agente

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 1), se houver parâmetros de leitura de documentos prontos para execução.
  • Tipo do input: Este agente deve ser apto a receber um JSON contendo parâmetros de leitura de documentos prontos 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 até 5.000 caracteres.

4.3.2 Especificação do Output

  • Formato de output: O output deve ser um JSON contendo os resultados das leituras de documentos, incluindo status e total de registros.
  • Exemplo de Estrutura de Output: 
     {
  "doc_results": [
    {
      "fonte_id": "doc_789",
      "status_execucao": "sucesso",
      "total_registros": 200
    }
  ]
}
  • Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 1.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.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não se conecta a sistemas externos.

4.3.5 Memória

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

Ao concluir sua execução, esse agente aciona o Agente de Padronização e Mapeamento de Esquema (RF 5).

RF 5. Agente de Padronização e Mapeamento de Esquema

5.1 Tarefa do Agente

Transformar registros brutos heterogêneos em um esquema canônico de faturamento.

5.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo registros brutos de múltiplas fontes, incluindo APIs, bancos de dados e documentos.

# 2. Objetivo
Transformar esses registros em um formato canônico padronizado para faturamento.

# 3. Regras que você deve seguir para gerar sua resposta
- Aplique mapeamentos e transformações necessárias para padronizar os dados.
- Registre quaisquer problemas encontrados durante a padronização.

# 4. Exemplo de Output que você deve produzir
{
  "dataset_padronizado": [
    {
      "source_system": "api",
      "invoice_number": "12345",
      "net_amount": 100.00
    }
  ]
}
5.3 Configurações do Agente

5.3.1 Especificação do Input

  • Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão dos agentes anteriores (RF 2, RF 3, RF 4).
  • Tipo do input: Este agente deve ser apto a receber registros brutos de múltiplas fontes.
  • 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.

5.3.2 Especificação do Output

  • Formato de output: O output deve ser um JSON contendo registros padronizados no esquema canônico.
  • Exemplo de Estrutura de Output: 
     {
  "dataset_padronizado": [
    {
      "source_system": "api",
      "invoice_number": "12345",
      "net_amount": 100.00
    }
  ]
}
  • Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno 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 documentos externos.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não se conecta a sistemas externos.

5.3.5 Memória

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

Ao concluir sua execução, esse agente aciona o Agente de Consolidação, Deduplicação e Reconciliação Primária (RF 6).

RF 6. Agente de Consolidação, Deduplicação e Reconciliação Primária

6.1 Tarefa do Agente

Unificar registros padronizados de múltiplas fontes, remover duplicidades e reconciliar totais básicos por nota.

6.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo registros padronizados de múltiplas fontes.

# 2. Objetivo
Consolidar esses registros, removendo duplicidades e reconciliando totais básicos.

# 3. Regras que você deve seguir para gerar sua resposta
- Remova duplicidades e registre quaisquer conflitos encontrados.
- Reconcile totais básicos por nota e registre as métricas de consolidação.

# 4. Exemplo de Output que você deve produzir
{
  "consolidado_transacoes": [
    {
      "unique_id": "api:12345:001",
      "net_amount": 100.00
    }
  ],
  "relatorio_consolidacao": {
    "total_entradas": 100,
    "total_unicas": 98
  }
}
6.3 Configurações do Agente

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 registros padronizados de múltiplas fontes.
  • 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 um JSON contendo transações consolidadas e um relatório de consolidação.
  • Exemplo de Estrutura de Output: 
     {
  "consolidado_transacoes": [
    {
      "unique_id": "api:12345:001",
      "net_amount": 100.00
    }
  ],
  "relatorio_consolidacao": {
    "total_entradas": 100,
    "total_unicas": 98
  }
}
  • Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 3.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 documentos externos.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não se conecta a sistemas externos.

6.3.5 Memória

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

Ao concluir sua execução, esse agente aciona o Agente de Validação de Qualidade para Fechamento (RF 7).

RF 7. Agente de Validação de Qualidade para Fechamento

7.1 Tarefa do Agente

Executar checagens determinísticas para assegurar que o consolidado atende aos requisitos mínimos do fechamento mensal.

7.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo transações consolidadas e um relatório de consolidação.

# 2. Objetivo
Validar a qualidade dos dados consolidados para garantir que atendem aos requisitos de fechamento mensal.

# 3. Regras que você deve seguir para gerar sua resposta
- Execute checagens de obrigatoriedade, faixas e sinais, e consistência de soma.
- Registre quaisquer erros, avisos ou inconsistências encontradas.

# 4. Exemplo de Output que você deve produzir
{
  "quality_report": {
    "erros_totais": 5,
    "avisos_totais": 2,
    "aprovado_para_fechamento": true
  }
}
7.3 Configurações do Agente

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 transações consolidadas e um relatório de consolidaçã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é 5.000 caracteres.

7.3.2 Especificação do Output

  • Formato de output: O output deve ser um JSON contendo um relatório de qualidade com erros, avisos e aprovação para fechamento.
  • Exemplo de Estrutura de Output: 
     {
  "quality_report": {
    "erros_totais": 5,
    "avisos_totais": 2,
    "aprovado_para_fechamento": true
  }
}
  • Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno 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 documentos externos.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não se conecta a sistemas externos.

7.3.5 Memória

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Visões para Fechamento Contábil (RF 8).

RF 8. Agente de Geração de Visões para Fechamento Contábil

8.1 Tarefa do Agente

Produzir saídas organizadas para análise e fechamento mensal a partir do consolidado validado.

8.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo transações consolidadas validadas e um relatório de qualidade.

# 2. Objetivo
Gerar saídas organizadas para análise e fechamento contábil mensal.

# 3. Regras que você deve seguir para gerar sua resposta
- Produza tabelas detalhadas, receitas por conta e centro de custo, e um resumo mensal.
- Inclua um manifest.json com metadados do processo de fechamento.

# 4. Exemplo de Output que você deve produzir
{
  "pacote_saida": {
    "tabela_detalhada": [
      {
        "invoice_number": "12345",
        "net_amount": 100.00
      }
    ],
    "manifest.json": {
      "status": "aprovado",
      "total_registros": 100
    }
  }
}
8.3 Configurações do Agente

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 transações consolidadas validadas e um relatório de qualidade.
  • 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 um JSON contendo saídas organizadas para análise e fechamento contábil mensal.
  • Exemplo de Estrutura de Output: 
     {
  "pacote_saida": {
    "tabela_detalhada": [
      {
        "invoice_number": "12345",
        "net_amount": 100.00
      }
    ],
    "manifest.json": {
      "status": "aprovado",
      "total_registros": 100
    }
  }
}
  • Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno 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 documentos externos.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não se conecta a sistemas externos.

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 gerada por este agente é 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 JSON gerado é o resultado que deve ser disponibilizado ao usuário.

Posts Relacionados

© 2025 prototipe.ai. Todos os direitos reservados.