Agente de IA para Gestão de Solicitações de Vale-Transporte

Gerar parâmetros de coleta por sistema de origem (RH, Folha, Portal do Colaborador) a partir de um intervalo de referência ou IDs de solicitações, padronizando filtros, paginação e campos requeridos.

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 dos formatos de input especificados (datas, IDs ou CPFs/matrículas) 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 pode ser um intervalo de datas, uma lista de IDs de solicitações ou uma lista de CPFs/matrículas.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .csv, .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 uma lista de payloads prontos para cada sistema de origem, contendo endpoint/rota, filtros, projeção de campos, limites de paginação, token/chave (placeholder), e identificador de correlação da coleta.
• Exemplo de Estrutura de Output:

   [{
    "endpoint": "/api/solicitacoes",
    "filtros": { "created_at": {"$gte": "2025-01-01T00:00:00Z", "$lte": "2025-01-31T23:59:59Z"} },
    "projecao": ["id_solicitacao", "id_colaborador", "cpf", "nome_colaborador"],
    "paginacao": { "page_size": 200, "page": 1 },
    "correlation_id": "123e4567-e89b-12d3-a456-426614174000"
  }] 

• Número de caracteres esperado: O output gerado deve ter um tamanho estimado em torno de 3.000 caracteres, podendo variar conforme a complexidade dos parâmetros de coleta.

1.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

1.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• 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 - Sistemas de Origem (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 - Sistemas de Origem (RF 2).

Realizar chamadas aos sistemas de origem (RH/Folha/Portal) para obter as solicitações de vale-transporte com base nos payloads preparados.

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 uma lista de payloads prontos contendo rota/endpoint, filtros, projeção de campos, paginação e correlation_id.
• 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.

2.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista de registros brutos por sistema de origem, por página, com metadados de paginação e correlation_id.
• Exemplo de Estrutura de Output:

   [{
    "sistema_origem": "RH",
    "pagina": 1,
    "dados": [{"id_solicitacao": "12345", "id_colaborador": "67890", "cpf": "12345678901"}],
    "correlation_id": "123e4567-e89b-12d3-a456-426614174000"
  }] 

• Número de caracteres esperado: O output gerado deve ter um tamanho estimado em torno de 5.000 caracteres, podendo variar conforme o volume de dados retornados.

2.3.3 Parâmetros de Geração

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

2.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Executa apenas as chamadas definidas; respeita paginação e limites; reexecuta até completar todas as páginas quando token de continuação for fornecido pelo sistema.

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 Normalização e Deduplicação de Solicitações (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Normalização e Deduplicação de Solicitações (RF 3).

Converter dados brutos de múltiplos sistemas para um esquema canônico, higienizar e deduplicar registros de solicitação.

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 registros brutos das solicitações retornados pelos sistemas de origem, com correlation_id.
• 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.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um dataset canônico de solicitações com schema unificado, indicadores de qualidade, chaves de deduplicação e relatório de normalização.
• Exemplo de Estrutura de Output:

   {
    "solicitacoes": [{"id_solicitacao": "12345", "id_colaborador": "67890", "cpf": "12345678901", "status_solicitacao": "Aprovada"}],
    "status_normalizacao": "sucesso",
    "lista_de_inconsistencias_normalizacao": []
  } 

• Número de caracteres esperado: O output gerado deve ter um tamanho estimado em torno de 8.000 caracteres, podendo variar conforme o volume e a complexidade dos dados processados.

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

3.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• 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 Preparador de Verificações Externas (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente Preparador de Verificações Externas (RF 4).

Construir consultas necessárias para validação dos dados: vínculo e elegibilidade do colaborador, políticas internas vigentes, histórico de VT, rotas/linhas e tarifas atuais.

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 um dataset canônico normalizado de solicitações com indicadores de qualidade e correlation_id.
• 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é 15.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista de consultas estruturadas por fonte (banco corporativo, cadastro de colaboradores, políticas internas, operadores de transporte) contendo parâmetros, chaves de junção e campos a recuperar.
• Exemplo de Estrutura de Output:

   [{
    "fonte": "banco_corporativo",
    "parametros": { "cpf": "12345678901" },
    "chaves_juncao": ["id_colaborador"],
    "campos": ["status_vinculo", "tipo_contrato"]
  }] 

• Número de caracteres esperado: O output gerado deve ter um tamanho estimado em torno de 4.000 caracteres, podendo variar conforme a complexidade das consultas estruturadas.

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

Realizar conexão com o banco corporativo para obter dados de colaboradores, políticas internas e histórico de vales conforme parâmetros definidos.

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 parâmetros prontos de consulta por tópico (colaborador_elegibilidade, politicas_internas, historico_vt) com chaves e colunas desejadas.
• 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é 12.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser os resultados das consultas por tópico, correlacionados por cpf/id_colaborador e correlation_id.
• Exemplo de Estrutura de Output:

   [{
    "topico": "colaborador_elegibilidade",
    "resultado": [{"cpf": "12345678901", "status_vinculo": "ativo"}],
    "correlation_id": "123e4567-e89b-12d3-a456-426614174000"
  }] 

• Número de caracteres esperado: O output gerado deve ter um tamanho estimado em torno de 6.000 caracteres, podendo variar conforme o volume de dados retornados.

5.3.3 Parâmetros de Geração

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

5.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Executar somente leitura; respeitar limites de paginação/timeout definidos nos parâmetros.

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 - Operadores de Transporte (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 - Operadores de Transporte (RF 6).

Realizar chamadas às APIs dos operadores/consórcios de transporte para validar linhas, modais, integrações e tarifas vigentes.

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 parâmetros prontos contendo origem/destino, códigos de linha/modal quando informados, data de referência e necessidade de tarifa.
• 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 dados de validação de transporte: existência de linhas, tarifa vigente, exigência de integração, tempo/trechos e códigos oficiais de linha.
• Exemplo de Estrutura de Output:

   [{
    "linha": "123",
    "tarifa": "4.50",
    "integracao": "sim",
    "tempo_trecho": "40 minutos",
    "codigo_oficial": "123456"
  }] 

• Número de caracteres esperado: O output gerado deve ter um tamanho estimado em torno de 3.000 caracteres, podendo variar conforme o volume de dados retornados.

6.3.3 Parâmetros de Geração

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

6.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Respeitar limites de rate limit; usar data de referência da competência quando fornecida.

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 Verificação e Regras de Negócio do Vale-Transporte (RF 7).

6.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 do Vale-Transporte (RF 7).

Cruzar o dataset canônico com os resultados das consultas e aplicar validações de elegibilidade, consistência de dados e cálculo do benefício.

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 um dataset canônico normalizado; resultados de consultas de colaborador, políticas internas, histórico e transporte.
• 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é 25.000 caracteres.

7.3.2 Especificação do Output

• Formato de output: O output deve conter para cada solicitação: status_validacao (aprovada/pendente/reprovada), lista_de_inconsistencias, métricas de cálculo (qtd_passagens_dia, dias_uteis, valor_tarifa, valor_bruto, coparticipacao, valor_liquido), datas de vigência e recomendações de correção quando aplicável.
• Exemplo de Estrutura de Output:

   [{
    "id_solicitacao": "12345",
    "status_validacao": "aprovada",
    "lista_de_inconsistencias": [],
    "metricas_calculo": {"qtd_passagens_dia": 2, "dias_uteis": 22, "valor_tarifa": "4.50", "valor_bruto": "198.00", "coparticipacao": "11.88", "valor_liquido": "186.12"},
    "datas_vigencia": {"inicio": "2025-02-01", "fim": "2025-02-28"},
    "recomendacoes": []
  }] 

• Número de caracteres esperado: O output gerado deve ter um tamanho estimado em torno de 10.000 caracteres, podendo variar conforme o volume e a complexidade dos dados processados.

7.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

7.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• 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 Conformidade Legal e Regulatória de VT (RF 8).

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

Ao concluir sua execução, esse agente aciona o Agente de Conformidade Legal e Regulatória de VT (RF 8).

Verificar aderência às políticas internas e regulamentos aplicáveis antes da emissão de créditos.

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 validação por solicitação com campos calculados, política aplicada e histórico relevante.
• 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 checklist de conformidade por solicitação com status_conformidade (conforme/não_conforme/pendente) e justificativas.
• Exemplo de Estrutura de Output:

   [{
    "id_solicitacao": "12345",
    "status_conformidade": "conforme",
    "justificativas": []
  }] 

• Número de caracteres esperado: O output gerado deve ter um tamanho estimado em torno de 3.000 caracteres, podendo variar conforme o volume e a complexidade dos dados processados.

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 deve ser visível para o Agente de Consolidação e Alertas para Emissão de Créditos (RF 9).

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

Ao concluir sua execução, esse agente aciona o Agente de Consolidação e Alertas para Emissão de Créditos (RF 9).

Consolidar solicitações aptas, gerar alertas de inconsistências e produzir pacote padronizado para o sistema de emissão (sem executar a emissão).

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 checklist de conformidade e resultados de validação por solicitaçã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é 15.000 caracteres.

9.3.2 Especificação do Output

• Formato de output: O output deve ser dois artefatos: (1) lista_para_emissao com registros aprovados (layout com cpf, nome, competencia, data_inicio_credito, vigencia_fim, valor_bruto, coparticipacao, valor_liquido, linha/modal, unidade); (2) relatorio_de_alertas com pendências/reprovações e ações recomendadas.
• Exemplo de Estrutura de Output:

   {
    "lista_para_emissao": [{"cpf": "12345678901", "nome": "João Silva", "competencia": "2025-02", "data_inicio_credito": "2025-02-01", "vigencia_fim": "2025-02-28", "valor_bruto": "198.00", "coparticipacao": "11.88", "valor_liquido": "186.12", "linha/modal": "123", "unidade": "Unidade A"}],
    "relatorio_de_alertas": [{"id_solicitacao": "12346", "status": "pendente", "campo_faltante": "CEP", "instrucao": "Complementar CEP"}]
  } 

• Número de caracteres esperado: O output gerado deve ter um tamanho estimado em torno de 10.000 caracteres, podendo variar conforme o volume e a complexidade dos dados processados.

9.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

9.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Pode opcionalmente preparar payload final para API de emissão, porém não executa o envio.

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 é o entregável final e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. O pacote padronizado e o relatório de alertas são os resultados que devem ser disponibilizados ao usuário.