Agente de IA para Relatórios de Consumo de Vale-Transporte

Receber parâmetros de personalização do relatório e padronizá-los em um schema único a ser usado por todos os agentes subsequentes.

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 JSON com parâmetros brutos 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 JSON com parâmetros brutos.
• 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 JSON de parâmetros canônicos: { periodo: {inicio, fim}, granularidade, dimensoes_agrupamento, politicas: {incluir_estornos, considerar_finais_de_semana}, creditos: {padrao_mensal, por_centro_custo}, thresholds: {outlier_percentil, taxa_utilizacao_baixa}, apresentacao: {moeda, idioma, secoes, top_n} } com defaults aplicados.
• Exemplo de Estrutura de Output:

   {
    "periodo": {
      "inicio": "2023-09-01",
      "fim": "2023-11-30"
    },
    "granularidade": "mensal",
    "dimensoes_agrupamento": ["colaborador", "centro_custo"],
    "politicas": {
      "incluir_estornos": true,
      "considerar_finais_de_semana": false
    },
    "creditos": {
      "padrao_mensal": null,
      "por_centro_custo": {}
    },
    "thresholds": {
      "outlier_percentil": 95,
      "taxa_utilizacao_baixa": 0.6
    },
    "apresentacao": {
      "moeda": "BRL",
      "idioma": "pt",
      "secoes": ["kpis", "tendencias", "insights", "recomendacoes", "tabelas"],
      "top_n": 20
    }
  }

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 1.500 caracteres.

1.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.5

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

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

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

Validar, limpar e normalizar os dados transacionais de vale-transporte para um schema padrão único.

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 um arquivo/dataset de transações e os parâmetros canônicos gerados pelo agente anterior.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .csv, .json, .xlsx.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 50.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto com: schema_padronizado (tabela normalizada), dicionario_campos, inconsistencias_detectadas (lista), registros_descartados (lista com motivo), resumo_qualidade (contagens por tipo de problema).
• Exemplo de Estrutura de Output:

   {
    "schema_padronizado": "dados_normalizados",
    "dicionario_campos": {
      "colaborador_id": "string",
      "data_transacao": "date",
      "valor": "float",
      "tipo_transacao": "string"
    },
    "inconsistencias_detectadas": ["data_invalida", "tipo_transacao_invalido"],
    "registros_descartados": ["registro_1", "registro_2"],
    "resumo_qualidade": {
      "total_registros": 1000,
      "registros_validos": 950,
      "registros_invalidos": 50
    }
  }

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 3.000 caracteres.

2.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.5

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 Cálculo de KPIs e Tendências de Consumo de VT (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Cálculo de KPIs e Tendências de Consumo de VT (RF 3).

Calcular métricas operacionais e gerenciais de consumo e produzir séries temporais conforme parâmetros.

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 o schema padronizado dos dados transacionais de vale-transporte e os parâmetros canônicos.
• 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 JSON com: kpis_globais, kpis_por_dimensao (por colaborador, centro_custo, etc.), series_temporais por granularidade, outliers (lista e critérios), flags_de_qualidade, resumo_estornos, taxa_utilizacao (quando houver informação de crédito).
• Exemplo de Estrutura de Output:

   {
    "kpis_globais": {
      "consumo_total_periodo": 10000,
      "consumo_medio_mensal": 3333.33
    },
    "kpis_por_dimensao": {
      "colaborador": {
        "123": {
          "consumo_total": 500,
          "dias_com_uso": 15
        }
      }
    },
    "series_temporais": {
      "mensal": {
        "2023-09": 3000,
        "2023-10": 3500
      }
    },
    "outliers": ["123"],
    "flags_de_qualidade": ["necessidade_de_credito_definido"],
    "resumo_estornos": {
      "volume": 100,
      "proporcao": 0.05
    },
    "taxa_utilizacao": 0.75
  }

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

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.5

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 Geração de Insights e Oportunidades de Otimização (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Insights e Oportunidades de Otimização (RF 4).

Derivar insights acionáveis a partir dos KPIs e séries temporais para suportar decisões de benefícios.

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 os KPIs e séries temporais de consumo de vale-transporte e os parâmetros canônicos.
• 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.

4.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista estruturada de insights: {titulo, descricao, impacto_estimado (qualitativo), evidencias (referências a KPIs), recomendacao, prioridade (alta|media|baixa), dimensao_afetada, periodo_referente}.
• Exemplo de Estrutura de Output:

   [
    {
      "titulo": "Oportunidade de Redução de Custos",
      "descricao": "Centros de custo com taxa de utilização abaixo do esperado.",
      "impacto_estimado": "Alto",
      "evidencias": ["taxa_utilizacao < 0.6"],
      "recomendacao": "Ajustar crédito mensal para centros de custo com baixa utilização.",
      "prioridade": "alta",
      "dimensao_afetada": "centro_custo",
      "periodo_referente": "2023-09"
    }
  ]

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

4.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.5

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 Composição de Relatório Personalizado de Consumo 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 Composição de Relatório Personalizado de Consumo de VT (RF 5).

Montar o relatório final no idioma desejado com seções, tabelas e anexos conforme parâmetros.

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 os parâmetros canônicos, KPIs e séries temporais, e a lista de insights gerados.
• 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.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório em Markdown estruturado com: capa, sumário executivo, visão geral (KPIs), tendências, insights e recomendações, tabelas (Top-N), apêndice metodológico. JSON auxiliar com tabelas para exportação (por colaborador, por centro de custo, séries temporais).
• Exemplo de Estrutura de Output:

   # Relatório de Consumo de Vale-Transporte
  
  ## Sumário Executivo
  - Consumo total no período: R$ 10.000,00
  - Média mensal de consumo: R$ 3.333,33
  
  ## Visão Geral
  ### KPIs
  - Consumo Total: R$ 10.000,00
  
  ### Tendências
  - Variação Mensal: +5%
  
  ## Insights e Recomendações
  - Ajuste de crédito necessário para centros de custo com baixa utilização.
  
  ## Apêndice Metodológico
  - Critérios de cálculo e tratamento de dados.

• Número de caracteres esperado: O Markdown gerado deve ter um tamanho estimado em 10.000 caracteres.

5.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.5

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

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