Agente de IA para Integração de Dados de Transporte com Folha de Pagamento

Construir parâmetros padronizados para coleta e processamento dos créditos de transporte na competência alvo.

1.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente é o ponto de partida do fluxo e deve ser acionado pelo envio dos dados da competência alvo 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 contendo informações da competência alvo e detalhes da empresa.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 10.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os parâmetros padronizados para a coleta de dados de transporte.
• Exemplo de Estrutura de Output:

   {
    "payload_api_transporte": {
      "empresa_id": "string",
      "periodo": {
        "inicio": "YYYY-MM-DD",
        "fim": "YYYY-MM-DD"
      }
    },
    "parametros_bd_folha": {
      "competencia": "AAAA-MM",
      "empresa_id": "string"
    },
    "metadados_execucao": {
      "id_execucao": "uuid",
      "competencia": "AAAA-MM",
      "timestamp_inicializacao": "ISO-8601"
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho aproximado 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 - Coleta de Créditos de Transporte (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 - Coleta de Créditos de Transporte (RF 2).

Realizar chamada à API do sistema de transporte para obter os créditos de VT no período solicitado.

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 JSON contendo os parâmetros padronizados para a coleta de dados de transporte.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 1.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados de créditos de transporte coletados.
• Exemplo de Estrutura de Output:

   {
    "dados_transporte_raw": [
      {
        "colaborador_id_externo": "string",
        "cpf": "string",
        "matricula": "string",
        "data_credito": "YYYY-MM-DD",
        "valor": number,
        "linha": "string",
        "operadora": "string",
        "cidade": "string",
        "chave_lancamento": "string"
      }
    ],
    "fonte": "api_transporte",
    "id_execucao": "uuid"
  } 

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

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 documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o JSON recebido para a API do sistema de transporte e retornar os dados coletados.

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 Execução de Consultas em Banco de Dados - Cadastro de Folha (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Execução de Consultas em Banco de Dados - Cadastro de Folha (RF 3).

Obter cadastro de colaboradores e mapeamentos necessários à integração (matrícula, CPF, centro de custo, rubricas) a partir do banco da folha/RH.

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 JSON contendo os parâmetros para a consulta ao banco de dados da folha/RH.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 1.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o cadastro de colaboradores obtido do banco de dados da folha/RH.
• Exemplo de Estrutura de Output:

   {
    "cadastro_folha": [
      {
        "colaborador_id": "string",
        "cpf": "string",
        "matricula": "string",
        "situacao": "ATIVO|AFASTADO|DESLIGADO",
        "data_admissao": "YYYY-MM-DD",
        "data_desligamento": "YYYY-MM-DD|null",
        "centro_custo": "string",
        "rubrica_padrao_vt": "string"
      }
    ],
    "id_execucao": "uuid"
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho aproximado de 5.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 documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá realizar consultas ao banco de dados da folha/RH para obter as informações necessárias.

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 Normalização e Enriquecimento de Dados (RF 4).

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

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

Normalizar formatos, padronizar identificadores e enriquecer créditos de transporte com dados do cadastro da folha.

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 JSONs contendo dados de créditos de transporte e cadastro de colaboradores.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (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 JSON contendo os dados normalizados e enriquecidos.
• Exemplo de Estrutura de Output:

   {
    "dados_vt_normalizados": [
      {
        "cpf": "string",
        "matricula": "string",
        "colaborador_id": "string|null",
        "data_competencia": "AAAA-MM",
        "data_credito": "YYYY-MM-DD",
        "valor": number,
        "operadora": "string|null",
        "cidade": "string|null",
        "chave_lancamento_origem": "string",
        "idempotency_key": "string"
      }
    ],
    "inconsistencias_preliminares": [
      {
        "referencia": "chave_lancamento_origem",
        "tipo": "IDENTIFICADOR_NAO_ENCONTRADO|FORMATO_INVALIDO|DUPLICADO",
        "detalhe": "string"
      }
    ],
    "id_execucao": "uuid"
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho aproximado de 7.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

• 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 e Regras de Negócio de VT (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Verificação e Regras de Negócio de VT (RF 5).

Aplicar validações de elegibilidade e consistência antes da integração com a folha, classificando cada registro.

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 JSON contendo dados de créditos de transporte normalizados e enriquecidos.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (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 JSON contendo os registros classificados após a aplicação das validações de elegibilidade e consistência.
• Exemplo de Estrutura de Output:

   {
    "itens_classificados": [
      {
        "idempotency_key": "string",
        "status": "APROVADO|PENDENTE|REPROVADO",
        "motivos": ["string"],
        "valor_aprovado": number,
        "rubrica_codigo": "string",
        "observacoes": "string|null"
      }
    ],
    "resumo_validacoes": {
      "total": number,
      "aprovados": number,
      "pendentes": number,
      "reprovados": number,
      "valor_total_aprovado": number
    },
    "aprovacao_auto_permitida": true,
    "criterios_gate": {
      "max_pendente_perc": 0.05,
      "max_reprovado_perc": 0.01
    },
    "id_execucao": "uuid"
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho aproximado de 7.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

• 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 Lote de Integração para Folha (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 Lote de Integração para Folha (RF 6).

Transformar itens aprovados em um payload idempotente para lançamento na folha de pagamento.

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 JSON contendo os registros classificados para geração do payload.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 7.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o payload idempotente para lançamento na folha de pagamento.
• Exemplo de Estrutura de Output:

   {
    "payload_integracao_folha": {
      "competencia": "AAAA-MM",
      "lancamentos": [
        {
          "matricula": "string",
          "rubrica": "string",
          "valor": number,
          "centro_custo": "string|null",
          "idempotency_key": "string",
          "observacoes": "string|null"
        }
      ]
    },
    "lancamentos_previos_resumo": {
      "quantidade": number,
      "valor_total": number
    },
    "id_execucao": "uuid"
  } 

• Número de caracteres esperado: O JSON gerado deve 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 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

• 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 - Envio de Lançamentos à Folha (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 - Envio de Lançamentos à Folha (RF 7).

Realizar chamada à API do sistema de folha para registrar os lançamentos de VT aprovados.

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 JSON contendo o payload idempotente para lançamento na folha de pagamento.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (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 o resultado do envio dos lançamentos à folha de pagamento.
• Exemplo de Estrutura de Output:

   {
    "resultado_envio": {
      "aceitos": [
        {
          "idempotency_key": "string",
          "protocolo": "string"
        }
      ],
      "rejeitados": [
        {
          "idempotency_key": "string",
          "erro": "string",
          "codigo": "string"
        }
      ]
    },
    "id_execucao": "uuid"
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho aproximado de 3.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 documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o JSON recebido para a API do sistema de folha e retornar o resultado do envio.

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 Reconciliação e Relatório de Auditoria (RF 8).

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

Ao concluir sua execução, esse agente aciona o Agente de Reconciliação e Relatório de Auditoria (RF 8).

Conciliar o que foi gerado versus o que foi aceito pela folha e produzir relatório de auditoria e controle de qualidade.

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 JSONs contendo os lançamentos enviados à folha e o resultado do envio.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input combinado de até 10.000 caracteres.

8.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o relatório de auditoria e controle de qualidade.
• Exemplo de Estrutura de Output:

   {
    "relatorio_auditoria": {
      "competencia": "AAAA-MM",
      "totais": {
        "gerados": number,
        "enviados": number,
        "aceitos": number,
        "rejeitados": number,
        "pendentes": number,
        "reprovados": number,
        "valor_total_gerado": number,
        "valor_total_aceito": number
      },
      "discrepancias": [
        {
          "idempotency_key": "string",
          "motivo": "REJEICAO_API|NAO_ENVIADO|DIVERGENCIA_VALOR",
          "detalhe": "string"
        }
      ],
      "amostra_controle": [
        "idempotency_key",
        "idempotency_key"
      ]
    },
    "status_integracao": "CONCLUIDA|CONCLUIDA_COM_PENDENCIAS|FALHA",
    "id_execucao": "uuid"
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho aproximado de 5.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 relatório de auditoria gerado é o resultado que deve ser disponibilizado ao usuário.