Agente de IA para Integração de Sistemas de Vale-Refeição

Consolidar configurações e esquemas de origem (RH) e destino (vale-refeição) em um mapeamento padronizado e gerar os parâmetros/payloads para as próximas etapas do fluxo.

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 com as configurações de integração 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 JSON 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 as configurações de integração dos sistemas de RH e VR.
• 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.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo o mapeamento padronizado e os parâmetros/payloads gerados para as próximas etapas do fluxo.
• Exemplo de Estrutura de Output:

   {"mapping_id":"map_2025_11_29_1121","parametros_busca_rh": {"url":"https://api.rh.com/employees","query":{"updated_since":"{{ultima_execucao}}","fields":["employee_id","cpf","nome","matricula","centro_custo","carga_horaria","situacao","data_admissao","data_demissao","beneficios.vr.*"]}}, "parametros_busca_vr": {"url":"https://api.vr.com/accounts","query":{"fields":["account_id","cpf","status","valor_mensal","empresa_unidade","ultimo_update"]}}, "regras_transformacao_normalizadas": [{"origem":"centro_custo","destino":"empresa_unidade","padrao":"UPPER_TRIM"}], "regras_filtragem": {"incluir_somente_elegiveis_vr": true, "excluir_desligados": true}}

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado 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 Execução de Chamada à API - Consulta RH (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 - Consulta RH (RF 2).

Realizar chamada à API do Sistema de RH para obter a lista de colaboradores e seus dados de elegibilidade de VR.

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 com os parâmetros de busca para a API do Sistema de RH.
• 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é 2.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados dos colaboradores obtidos da API do Sistema de RH.
• Exemplo de Estrutura de Output:

   {"dados_rh":[{"employee_id":"123","cpf":"00000000000","nome":"Fulano","situacao":"ATIVO","centro_custo":"Filial A","beneficios":{"vr":{"elegivel":true,"valor":850}}}], "carimbo_tempo":"2025-11-29T11:21:00Z"}

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 3.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 Execução de Chamada à API - Consulta Estado Atual no VR (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 Chamada à API - Consulta Estado Atual no VR (RF 3).

Realizar chamada à API do provedor de Vale-Refeição para obter o estado atual das contas/benefícios.

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 com os parâmetros de busca para a API do provedor de Vale-Refeiçã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é 2.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados das contas/benefícios obtidos da API do provedor de Vale-Refeição.
• Exemplo de Estrutura de Output:

   {"dados_vr":[{"account_id":"vr_987","cpf":"00000000000","status":"ATIVO","valor_mensal":850,"empresa_unidade":"FILIAL A","ultimo_update":"2025-11-01"}], "carimbo_tempo":"2025-11-29T11:21:05Z"}

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado 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 deve ser visível para o Agente de Normalização e Validação 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 Validação de Dados (RF 4).

Normalizar, limpar e validar os dados retornados do RH e do VR, preparando-os para conciliação.

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 um JSON combinando os dados retornados do RH e do VR.
• 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 dados normalizados e validados, prontos para a etapa de conciliação.
• Exemplo de Estrutura de Output:

   {"dados_rh_norm":[{"chave":"cpf:00000000000","cpf":"00000000000","elegivel_vr":true,"valor":"850","unidade":"FILIAL A","status_colaborador":"ATIVO"}], "dados_vr_norm":[{"chave":"cpf:00000000000","cpf":"00000000000","status":"ATIVO","valor":"850","unidade":"FILIAL A"}], "relatorio_validacao": {"faltantes":["cpf"], "formatacoes_corrigidas":["centro_custo->empresa_unidade"], "registros_descartados":0}}

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 3.500 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 Conciliação e Geração de Delta (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Conciliação e Geração de Delta (RF 5).

Comparar os dados normalizados do RH e do VR e gerar o delta: inclusões, atualizações e desativações a serem aplicadas no VR.

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 os dados normalizados do RH e do VR.
• 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é 4.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o delta gerado, incluindo as ações de inclusão, atualização e desativação a serem aplicadas no VR.
• Exemplo de Estrutura de Output:

   {"delta": {"incluir":[{"cpf":"11122233344","valor":"850","unidade":"FILIAL B","status_destino":"ATIVAR"}], "atualizar":[{"cpf":"00000000000","alteracoes":{"valor":{"de":"750","para":"850"}}}], "desativar":[{"cpf":"55566677788","status_destino":"DESATIVAR"}]}, "delta_existe": true, "metricas": {"total_incluir":1,"total_atualizar":1,"total_desativar":1}}

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 3.500 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 Preparação de Payload de Atualização para VR (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Preparação de Payload de Atualização para VR (RF 6).

Transformar o delta em payloads compatíveis com a API de atualização em lote do provedor de VR.

6.3.1 Condições de Ativação

Este agente é acionado somente se a seguinte condição for atendida:

• O campo delta_existe no output do Agente de Conciliação e Geração de Delta (RF 5) for igual a true.

6.3.2 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 5), caso o delta exista.
• Tipo do input: Este agente deve ser apto a receber como input um JSON contendo o delta gerado pelo agente anterior.
• 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.500 caracteres.

6.3.3 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os payloads de atualização para a API do provedor de VR.
• Exemplo de Estrutura de Output:

   {"payload_atualizacao": {"url":"https://api.vr.com/accounts/bulk","body": {"ativar":[{"cpf":"11122233344","valor":"850","unidade":"FILIAL B"}], "atualizar":[{"cpf":"00000000000","valor":"850"}], "desativar":[{"cpf":"55566677788"}]}, "headers": {"Content-Type":"application/json"}}, "payload_pronto": true}

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

6.3.4 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

6.3.5 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.6 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 - Atualização VR (RF 7).

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

Ao concluir sua execução, esse agente aciona o Agente de Execução de Chamada à API - Atualização VR (RF 7).

Realizar chamada à API do provedor de VR para aplicar ativações, atualizações e desativações em lote.

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 os payloads de atualização para a API do provedor de VR.
• 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.

7.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o resultado da chamada à API do provedor de VR.
• Exemplo de Estrutura de Output:

   {"resultado_api": {"status":"200","sucesso": true, "resumo": {"ativados":1,"atualizados":1,"desativados":1}, "erros": []}, "atualizacao_executada": true}

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

• 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 Pós-Atualização (RF 8).

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

Ao concluir sua execução, esse agente aciona o Agente de Verificação Pós-Atualização (RF 8).

Auditar o retorno da API e, se necessário, solicitar nova consulta de confirmação para garantir que os dados no VR espelham o delta aplicado.

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 um JSON contendo o resultado da chamada à API do provedor de VR.
• 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é 2.500 caracteres.

8.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo a verificação do retorno da API e recomendações de ação caso necessário.
• Exemplo de Estrutura de Output:

   {"verificacao": {"status":"OK","divergencias": [], "recomendacao":"nenhuma"}, "falhas_ou_anomalias_detectadas": false}

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.500 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 deve ser visível para o Agente de Monitoramento e Geração de Alertas (RF 9).

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

Ao concluir sua execução, esse agente aciona o Agente de Monitoramento e Geração de Alertas (RF 9).

Consolidar métricas do ciclo, identificar padrões de falhas/atrasos e preparar payload de alerta para o time responsável.

9.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 8).
• Tipo do input: Este agente deve ser apto a receber como input um JSON contendo as métricas do ciclo e o resultado da verificação pós-atualizaçã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é 2.500 caracteres.

9.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o alerta consolidado para o time responsável.
• Exemplo de Estrutura de Output:

   {"alerta": {"tipo":"ALERTA","titulo":"Integração VR-RH - Resultado do ciclo","mensagem_curta":"Resumo do processamento e anomalias","detalhes": {"metricas":{"incluir":1,"atualizar":1,"desativar":1}, "divergencias":[], "erros_validacao":[]}, "destinatarios":["time-rh@empresa.com","time-ti@empresa.com"]}, "alerta_pronto": true}

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

9.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

9.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.

9.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 - Disparo de Alerta (RF 10).

9.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 - Disparo de Alerta (RF 10).

Enviar o alerta consolidado para o canal definido (e-mail, Slack, webhook de incidentes).

10.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 9).
• Tipo do input: Este agente deve ser apto a receber como input um JSON contendo o alerta consolidado para o time responsável.
• 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é 2.000 caracteres.

10.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o resultado do envio do alerta para o canal definido.
• Exemplo de Estrutura de Output:

   {"envio_alerta": {"sucesso": true, "protocolo":"ALT-20251129-1121"}}

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

10.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

10.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.

10.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.

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

A execução deste agente finaliza o fluxo. O resultado do envio do alerta é o resultado que deve ser disponibilizado ao usuário.