Agente de IA para Controle de Saldos de Vale-Refeição

Realizar chamada à API do sistema de benefícios para obter saldos atuais e movimentações (créditos/débitos) de vale-refeição por usuário no período especificado.

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 payload pronto 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 payload contendo parâmetros de consulta à API.
• Formatos Suportados: Esse agente deve ser capaz de receber payloads nos formatos: .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 a resposta bruta das APIs com arrays de saldos por usuário e transações no período solicitado, incluindo metadados de paginação e carimbos de data/hora.
• Exemplo de Estrutura de Output:

   {
    "saldos": [ ... ],
    "transacoes": [ ... ],
    "metadados": { ... }
  } 

• Número de caracteres esperado: O output deverá ter um tamanho variável, dependendo do número de usuários e transações, mas estima-se que seja em torno de 20.000 caracteres.

1.3.3 Parâmetros de Geração

• Modelo: Não aplicável (uso de ferramenta)
• Temperatura: Não aplicável

1.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 payload recebido para a API externa e retornar a resposta bruta.

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

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

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

Normalizar as respostas das APIs em um modelo canônico e consolidar base por usuário/período, preparando dados para análise.

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 dados brutos de saldos e transações retornados pela API, além de parâmetros de política.
• 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 de até 20.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON canônico com: usuarios[{id, saldo_atual, saldo_antes_periodo, total_creditos_periodo, total_debitos_periodo, transacoes_normalizadas[], pendencias[], data_corte_aplicada, saldo_esperado_calculado}].
• Exemplo de Estrutura de Output:

   {
    "usuarios": [ ... ],
    "transacoes_normalizadas": [ ... ],
    "pendencias": [ ... ]
  } 

• Número de caracteres esperado: O output deverá ter um tamanho variável, mas estima-se que seja em torno de 15.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: Utiliza lógica interna para cálculos de normalização.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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

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

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

Identificar divergências de saldo, anomalias transacionais e condições de não conformidade por usuário.

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 um dataset canônico consolidado por usuário/período, parâmetros de política e tolerâncias.
• 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 de até 15.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com inconsistencias[{usuario_id, tipo, codigo_regra, descricao, valor_discrepancia, severidade, auto_ajustavel, referencias (ids_transacoes), recomendacao}]. Também incluir resumo_por_usuario com flags e contadores.
• Exemplo de Estrutura de Output:

   {
    "inconsistencias": [ ... ],
    "resumo_por_usuario": [ ... ]
  } 

• Número de caracteres esperado: O output deverá ter um tamanho variável, mas estima-se que seja em torno 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 documentos externos.
• Calculadora: Utiliza lógica interna para identificação de inconsistências.
• 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 Planejamento de Ajustes de Saldo (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Planejamento de Ajustes de Saldo (RF 4).

Transformar inconsistências auto-ajustáveis em instruções de ajuste idempotentes e seguras.

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 uma lista de inconsistências detectadas, dataset canônico por usuário, parâmetros de política de ajustes.
• 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 de até 15.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON ajustes_planejados[{usuario_id, operacao: credito|debito, valor, motivo, codigo_regra_origem, idempotency_key, data_execucao_planejada, observacao, referencias (ids_transacoes)}] e sumário por severidade.
• Exemplo de Estrutura de Output:

   {
    "ajustes_planejados": [ ... ],
    "sumario_por_severidade": [ ... ]
  } 

• Número de caracteres esperado: O output deverá ter um tamanho variável, mas estima-se que seja em torno de 10.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: Utiliza lógica interna para planejamento de ajustes.
• 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 Execução de Chamada à API - Efetivação de Ajustes (RF 5).

4.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 - Efetivação de Ajustes (RF 5).

Realizar chamadas à API do sistema de benefícios para efetivar créditos e débitos planejados.

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 um payload pronto com lote de ajustes.
• 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 de até 10.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser a resposta da API por ajuste com status (sucesso/falha), identificadores de operação no sistema origem e mensagens de erro quando aplicável.
• Exemplo de Estrutura de Output:

   {
    "ajustes_executados": [ ... ],
    "status": "sucesso/falha",
    "mensagens_de_erro": [ ... ]
  } 

• Número de caracteres esperado: O output deverá ter um tamanho variável, mas estima-se que seja em torno de 5.000 caracteres.

5.3.3 Parâmetros de Geração

• Modelo: Não aplicável (uso de ferramenta)
• Temperatura: Não aplicável

5.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 payload recebido para a API externa e retornar a resposta.

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 Execução de Chamada à API - Reconsulta de Saldos Pós-Ajuste (RF 6).

5.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 - Reconsulta de Saldos Pós-Ajuste (RF 6).

Reconsultar a API de benefícios para obter os saldos atuais após a efetivação dos ajustes.

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 um payload pronto contendo parâmetros para reconsulta de saldos.
• 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 de até 10.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser os saldos atuais por usuário imediatamente após a execução dos ajustes, com timestamps e metadados.
• Exemplo de Estrutura de Output:

   {
    "saldos_atuais": [ ... ],
    "timestamps": [ ... ],
    "metadados": { ... }
  } 

• Número de caracteres esperado: O output deverá ter um tamanho variável, mas estima-se que seja em torno de 10.000 caracteres.

6.3.3 Parâmetros de Geração

• Modelo: Não aplicável (uso de ferramenta)
• Temperatura: Não aplicável

6.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 payload recebido para a API externa e retornar a resposta.

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 Reconciliação Pós-Ajuste (RF 7).

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

Ao concluir sua execução, esse agente aciona o Agente de Reconciliação Pós-Ajuste (RF 7).

Comparar saldos reconsultados com os saldos esperados após os ajustes para confirmar a efetividade e apontar pendências.

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 saldos pós-ajuste retornados pela API, ajustes executados com status e dataset canônico original do período.
• 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 de até 15.000 caracteres.

7.3.2 Especificação do Output

• Formato de output: O output deve ser o resultado de reconciliação por usuário: reconciliado=true/false, diferenca_residual, causas prováveis, próximos passos (reconsulta, novo ajuste, abrir ticket).
• Exemplo de Estrutura de Output:

   {
    "reconciliacao": [ ... ],
    "proximos_passos": [ ... ]
  } 

• Número de caracteres esperado: O output deverá ter um tamanho variável, mas estima-se que seja em torno de 10.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: Utiliza lógica interna para reconciliação de saldos.
• 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 Relatório de Saldos de Vale-Refeição (RF 8).

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

Ao concluir sua execução, esse agente aciona o Agente de Relatório de Saldos de Vale-Refeição (RF 8).

Gerar relatório regular e padronizado com status dos saldos, inconsistências detectadas, ajustes executados e reconciliação.

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 resultados de detecção, planejamento, execução e reconciliação; parâmetros de período de referência; metadados de execução.
• 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 de até 20.000 caracteres.

8.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório JSON contendo: KPIs (usuários avaliados, com inconsistência, % auto-ajustados, valor ajustado líquido), lista detalhada por usuário, pendências, violações de política, e histórico sintetizado do período.
• Exemplo de Estrutura de Output:

   {
    "sumario_kpis": { ... },
    "detalhes_por_usuario": [ ... ],
    "pendencias": [ ... ],
    "conformidade": { ... },
    "metadados": { ... }
  } 

• Número de caracteres esperado: O output deverá ter um tamanho variável, mas estima-se que seja em torno de 20.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: Utiliza lógica interna para geração de relatórios.
• 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 relatório gerado é o resultado que deve ser disponibilizado ao usuário.