Agente de IA para Integração de Dados de Vale-Refeição com ERP

Definir janela temporal, filtros e payload de consulta para recuperar transações de vale-refeição no provedor, garantindo idempotência e respeito a limites do sistema.

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 objeto 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 na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um objeto JSON contendo informações de configuração e limites.
• 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 objeto JSON contendo os parâmetros de consulta preparados, idempotency_key e outros detalhes de configuração.
• Exemplo de Estrutura de Output:

   {
    "parametros_consulta": [
      {
        "inicio": "2025-11-01T00:00:00",
        "fim": "2025-11-30T23:59:59",
        "pagina": 1,
        "tamanho": 100
      }
    ],
    "idempotency_key": "abc123",
    "headers_padrao": {
      "Accept": "application/json"
    },
    "endpoint": "https://api.vale-refeicao.com/transacoes",
    "criterios_filtro": {
      "status": ["aprovada"],
      "moeda": "BRL"
    }
  } 

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 1.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 Execução de Chamada à API - Provedor de Vale-Refeição (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 - Provedor de Vale-Refeição (RF 2).

Realizar a chamada à API do provedor de vale-refeição para obter transações no período e filtros definidos.

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 payload pronto para consulta à API.
• 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é 3.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista de páginas de resultados brutos, conforme recebido da API do provedor de vale-refeição.
• Exemplo de Estrutura de Output:

  [
    {
      "dados": [
        {
          "id": "transacao123",
          "valor": 100.00,
          "data": "2025-11-15T12:00:00",
          "status": "aprovada"
        }
      ],
      "pagina": 1,
      "total_paginas": 10
    }
  ]

• Número de caracteres esperado: O JSON gerado deve ter um tamanho aproximado de 2.000 caracteres por página de resultados.

2.3.3 Parâmetros de Geração

• Modelo: Não se aplica (uso de ferramenta)
• Temperatura: Não se aplica

2.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o payload recebido à API do provedor de vale-refeição e retornar os dados conforme recebidos.

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 Padronização e Enriquecimento de Transações (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Padronização e Enriquecimento de Transações (RF 4).

Recuperar do ERP cadastros necessários à integração: plano de contas, centros de custo, colaboradores/matrículas e parâmetros contábeis.

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).
• Tipo do input: Este agente deve ser apto a receber como input um payload pronto para consulta à API.
• 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é 3.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo os dados de cadastros recebidos do ERP.
• Exemplo de Estrutura de Output:

  {
    "contas": [
      {
        "codigo": "1234",
        "nome": "Despesa Alimentação"
      }
    ],
    "centros_custo": [
      {
        "codigo": "5678",
        "nome": "Administração"
      }
    ],
    "colaboradores": [
      {
        "id_externo": "colab001",
        "matricula": "0001",
        "centro_custo": "5678"
      }
    ],
    "parametros": {
      "conta_despesa": "1234",
      "conta_contrapartida": "4321",
      "politica_rateio": "por_colaborador"
    }
  }

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

3.3.3 Parâmetros de Geração

• Modelo: Não se aplica (uso de ferramenta)
• Temperatura: Não se aplica

3.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o payload recebido à API do ERP e retornar os dados conforme recebidos.

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 Padronização e Enriquecimento de Transações (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Padronização e Enriquecimento de Transações (RF 4).

Normalizar e deduplicar transações de vale-refeição, mapear colaboradores e centros de custo, e preparar conjunto canônico para contabilização.

4.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 e RF 3).
• Tipo do input: Este agente deve ser apto a receber como input páginas de transações do provedor e cadastros do ERP.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input combinado de até 10.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo as transações normalizadas e as inconsistências detectadas.
• Exemplo de Estrutura de Output:

  {
    "transacoes_normalizadas": [
      {
        "id_origem": "transacao123",
        "data_transacao": "2025-11-15",
        "competencia": "2025-11",
        "colaborador_id": "colab001",
        "colaborador_matricula": "0001",
        "centro_custo": "5678",
        "estabelecimento": "Restaurante A",
        "mcc": null,
        "valor_brl": 100.00,
        "moeda": "BRL",
        "status": "aprovada",
        "hash_dedup": "hash123"
      }
    ],
    "inconsistencias": [
      {
        "id_origem": "transacao456",
        "tipo": "moeda_invalida",
        "detalhe": "Moeda diferente de BRL"
      }
    ]
  }

• Número de caracteres esperado: O JSON gerado deve ter um tamanho aproximado de 3.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: Não utiliza.
• 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 Reconciliação Financeira (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Reconciliação Financeira (RF 5).

Verificar consistência das transações normalizadas com totais esperados e classificar divergências para correção.

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 transações normalizadas e totais externos esperados.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input combinado de até 5.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo os resultados da reconciliação financeira, alertas e itens para reconsulta.
• Exemplo de Estrutura de Output:

  {
    "reconciliacao": {
      "por_dia": [
        {
          "data": "2025-11-15",
          "total_transacoes": 100.00,
          "total_esperado": 100.01,
          "diferenca": 0.01,
          "status": "ok"
        }
      ],
      "sumario": {
        "total_ok": 1,
        "total_divergente": 0,
        "valor_divergente": 0.00
      }
    },
    "alertas": [],
    "itens_para_reconsulta": []
  }

• Número de caracteres esperado: O JSON gerado deve ter um tamanho aproximado de 2.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 cálculos de reconciliação.
• 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 Geração de Lançamentos Contábeis para ERP (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Lançamentos Contábeis para ERP (RF 6).

Transformar transações de vale-refeição em lançamentos contábeis/pré-notas no formato aceito pelo ERP, com idempotência.

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 transações normalizadas, cadastros do ERP e políticas de agrupamento.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input combinado de até 8.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo os lotes de lançamentos contábeis gerados, idempotency_keys e rejeições.
• Exemplo de Estrutura de Output:

  {
    "lotes": [
      {
        "lote_id": "lote123",
        "competencia": "2025-11",
        "data_lancamento": "2025-11-16",
        "linhas": [
          {
            "historico": "VR Restaurante A 2025-11-15 Colab:colab001",
            "conta_debito": "1234",
            "conta_credito": "4321",
            "centro_custo": "5678",
            "valor": 100.00,
            "referencia_externa": "transacao123"
          }
        ]
      }
    ],
    "idempotency_keys": [
      "key123"
    ],
    "rejeicoes": []
  }

• Número de caracteres esperado: O JSON gerado deve ter um tamanho aproximado 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.
• Calculadora: Utiliza lógica interna para gerar idempotency_keys.
• 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 Execução de Chamada à API - ERP (Envio de Lançamentos) (RF 7).

6.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 - ERP (Envio de Lançamentos) (RF 7).

Enviar os lotes de lançamentos gerados ao ERP, preservando idempotência.

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 lotes de lançamentos contábeis e idempotency_keys.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input combinado de até 5.000 caracteres.

7.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo os retornos da API do ERP para cada lote enviado.
• Exemplo de Estrutura de Output:

  {
    "retornos": [
      {
        "lote_id": "lote123",
        "status_http": 200,
        "protocolo": "protocolo123",
        "erros": []
      }
    ]
  }

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

7.3.3 Parâmetros de Geração

• Modelo: Não se aplica (uso de ferramenta)
• Temperatura: Não se aplica

7.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar os lotes de lançamentos à API do ERP e retornar os dados conforme recebidos.

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 Monitoramento e Correção de Inconsistências (RF 8).

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

Ao concluir sua execução, esse agente aciona o Agente de Monitoramento e Correção de Inconsistências (RF 8).

Consolidar inconsistências detectadas, propor correções automatizáveis e sinalizar itens que exigem intervenção humana.

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 inconsistências detectadas, resultados de reconciliação e retornos do ERP.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input combinado de até 7.000 caracteres.

8.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo resumo de inconsistências, propostas de correção e itens que exigem intervenção humana.
• Exemplo de Estrutura de Output:

  {
    "resumo": {
      "qtd_inconsistencias": 5,
      "qtd_pendentes_humanas": 2,
      "valor_pendente": 1500.00
    },
    "propostas_correcao": [
      {
        "tipo": "reconsulta",
        "detalhes": {
          "inicio": "2025-11-01T00:00:00",
          "fim": "2025-11-30T23:59:59"
        }
      }
    ],
    "itens_humanos": [
      {
        "id_origem": "transacao789",
        "motivo": "mapeamento",
        "recomendacao": "Verificar centro de custo"
      }
    ],
    "proximas_janelas_reprocesso": [
      {
        "inicio": "2025-12-01T00:00:00",
        "fim": "2025-12-31T23:59:59"
      }
    ]
  }

• Número de caracteres esperado: O JSON gerado deve 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: Não utiliza.
• 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 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 para análise e ações corretivas.