Agente de IA para Análise de Dados de Uso de Vale-Transporte

Padronizar e validar o dataset de uso de vale-transporte, garantindo consistência temporal, deduplicação e estrutura única para consumo pelos agentes analíticos 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 dataset de eventos de uso de vale-transporte 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 arquivo na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um dataset de eventos de uso de vale-transporte em formato CSV ou JSON.
• Formatos Suportados: Esse agente deve ser capaz de receber datasets nos formatos: .csv, .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 500.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado com: schema_normalizado, timezone_detectado, periodo_dados, totais, flags, definicoes_temporais, dataset_normalizado e regras_aplicadas.
• Exemplo de Estrutura de Output:

   {
    "schema_normalizado": {...},
    "timezone_detectado": "GMT-3",
    "periodo_dados": {
      "inicio_iso": "2025-01-01T00:00:00Z",
      "fim_iso": "2025-01-31T23:59:59Z"
    },
    "totais": {
      "linhas_entrada": 10000,
      "linhas_validas": 9500,
      "linhas_descartadas": 500,
      "duplicatas_removidas": 100
    },
    "flags": {
      "possui_identificador_usuario": true
    },
    "definicoes_temporais": {
      "granularidade_bucket_min": 15,
      "calendario_semana": ["seg", "ter", "qua", "qui", "sex", "sab", "dom"]
    },
    "dataset_normalizado": [...],
    "regras_aplicadas": ["Regra 1", "Regra 2", "Regra 3"]
  } 

• Número de caracteres esperado: O JSON final será detalhado, com um tamanho mínimo esperado de 10.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 Análise de Padrões de Deslocamento (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Análise de Padrões de Deslocamento (RF 2).

Identificar padrões de demanda temporal, espacial e por linha, produzindo KPIs operacionais e insumos para otimização.

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 a saída do Agente de Preparação e Qualidade dos Dados de VT.
• 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é 100.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo relatorio_padroes_markdown e kpis_padroes com os padrões de deslocamento identificados.
• Exemplo de Estrutura de Output:

   {
    "relatorio_padroes_markdown": "# Padrões de Deslocamento\n## Horários de Pico\n- Manhã: 07:00 - 09:00\n- Tarde: 17:00 - 19:00\n## Top Rotas\n1. Rota A\n2. Rota B",
    "kpis_padroes": {
      "horarios_pico": {
        "manha": "07:00 - 09:00",
        "tarde": "17:00 - 19:00"
      },
      "demanda_por_bucket": {
        "segunda": [100, 200, 150],
        "terca": [120, 210, 160]
      },
      "top_rotas": ["Rota A", "Rota B"]
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 8.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.
• Calculadora: Utiliza lógica interna para calcular KPIs e padrões.
• 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 Segmentação e Perfis de Usuários (RF 3) e o Agente de Otimização de Rotas e Oferta (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Segmentação e Perfis de Usuários (RF 3).

Derivar perfis de uso (diário, semanal, ocasional) e preferências de horário para apoiar decisões tático-operacionais.

3.3.1 Condições de Ativação

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

• O campo possui_identificador_usuario no output do Agente de Preparação e Qualidade dos Dados de VT (RF 1) é igual a true.

3.3.2 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado condicionalmente após a conclusão do agente anterior (RF 2), apenas se o campo possui_identificador_usuario for true.
• Tipo do input: Este agente deve ser apto a receber a saída do Agente de Preparação e Qualidade dos Dados de VT e do Agente de Análise de Padrões de Deslocamento.
• 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é 100.000 caracteres.

3.3.3 Especificação do Output

• Formato de output: O output deve ser um JSON contendo perfis_usuarios com a distribuição de perfis, critérios aplicados, índices de preferência horária, principais rotas por perfil e elasticidade horária qualitativa.
• Exemplo de Estrutura de Output:

   {
    "perfis_usuarios": {
      "distribuicao_perfis": {
        "diario": 0.6,
        "semanal": 0.3,
        "ocasional": 0.1
      },
      "criterios_aplicados": ["Diario: ≥ 4 dias/semana", "Semanal: 1–3 dias/semana", "Ocasional: < 4 dias/mês"],
      "indices_preferencia_horaria": {
        "diario": [0.4, 0.3, 0.2, 0.1],
        "semanal": [0.3, 0.3, 0.3, 0.1]
      },
      "principais_rotas_por_perfil": {
        "diario": ["Rota A", "Rota B"],
        "semanal": ["Rota C", "Rota D"]
      },
      "elasticidade_horaria_qualitativa": "baixa"
    }
  } 

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

3.3.4 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

3.3.5 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

3.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 Otimização de Rotas e Oferta (RF 4).

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

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

Gerar propostas de ajustes de oferta (headway, horários e configuração de rotas) para melhorar eficiência e atendimento.

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 ou RF 2).
• Tipo do input: Este agente deve ser apto a receber a saída do Agente de Análise de Padrões de Deslocamento e, se disponível, do Agente de Segmentação e Perfis de Usuários.
• 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é 100.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo propostas_otimizacao com ajustes de headway, horários, sugestões de short-turn, impacto estimado e score de priorização.
• Exemplo de Estrutura de Output:

   {
    "propostas_otimizacao": {
      "ajustes_headway": {
        "linha_1": {"pico_manha": "10 min", "entrepico": "15 min"},
        "linha_2": {"pico_tarde": "12 min", "noite": "20 min"}
      },
      "ajustes_horarios": {
        "linha_1": {"inicio_pico": "06:30", "fim_pico": "09:30"}
      },
      "sugestoes_de_short_turn": ["linha_1: paradas 1-5"],
      "impacto_estimado": {
        "tempo_espera_medio": "-10%",
        "fator_carga": "0.85"
      },
      "score_priorizacao": 0.75
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 6.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.
• Calculadora: Utiliza lógica interna para calcular ajustes de oferta e impacto.
• 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 Planejamento de Pilotos e Métricas de Sucesso (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Planejamento de Pilotos e Métricas de Sucesso (RF 5).

Converter propostas de otimização em um plano de piloto mensurável com critérios de sucesso e salvaguardas operacionais.

5.3.1 Condições de Ativação

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

• O campo score_priorizacao no output do Agente de Otimização de Rotas e Oferta (RF 4) é igual ou superior a 0.5.

5.3.2 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado condicionalmente após a conclusão do agente anterior (RF 4), apenas se houver pelo menos uma proposta com score_priorizacao igual ou superior a 0.5.
• Tipo do input: Este agente deve ser apto a receber as propostas de otimização do Agente de Otimização de Rotas e Oferta.
• 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é 100.000 caracteres.

5.3.3 Especificação do Output

• Formato de output: O output deve ser um JSON contendo plano_piloto com escopo, duração do teste, grupo-controle, KPIs alvo, metodologia de medição, critérios de sucesso, riscos e mitigação, cronograma e responsáveis.
• Exemplo de Estrutura de Output:

   {
    "plano_piloto": {
      "escopo": "Linhas 1 e 2",
      "duracao_teste": "2 semanas",
      "grupo_controle": "Linha 3",
      "KPIs_alvo": ["tempo_espera_medio", "fator_carga"],
      "metodologia_medicao": "antes-depois",
      "criterios_sucesso": "-10% tempo_espera_medio",
      "riscos_mitigacao": "Gatilho de reversão se fator_carga > 1.0",
      "cronograma": {
        "T0": "2025-01-01",
        "T1": "2025-01-08",
        "T2": "2025-01-15"
      },
      "responsaveis": ["Operador A", "Analista B"]
    }
  } 

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

5.3.4 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

5.3.5 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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

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

A execução deste agente finaliza o fluxo. O plano de piloto gerado é o resultado que deve ser disponibilizado ao usuário.