Agente de IA para Análise de Eficiência de Rotas de Transporte

Validar, higienizar e normalizar o dataset de deslocamentos para garantir consistência, completude e comparabilidade entre registros antes da análise.

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 dados de deslocamento 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 contendo dados de deslocamento dos colaboradores.
• 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.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o dataset normalizado e validado, com registros válidos e descartados, causas de descarte e estatísticas base.
• Exemplo de Estrutura de Output:

   {
    "registros_validos": [...],
    "registros_descartados": [...],
    "causas_descarte": [{"codigo": "T01_tempo_invalido", "descricao": "Tempo total inválido", "quantidade": 10}],
    "estatisticas_base": {"n_registros": 1000, "n_colaboradores": 100, "janela_datas": "01/01/2025 a 31/01/2025", "proporcao_picos": 0.3, "meios_transporte": {"carro": 0.5, "onibus": 0.3, "a_pe": 0.2}},
    "parametros_norma": {"tempo_total_minutos": 60, "distancia_km": 20, "velocidade_media_kmh": 30, "periodo_pico_flag": true}
  } 

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

Realizar chamadas às APIs de mapas/trânsito para enriquecer o dataset com tempo_base_minutos e distancia_base_km por par origem-destino e janela temporal.

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 payload pronto para a execução de chamadas a APIs de mapas/trânsito.
• 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é 50.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo dados enriquecidos com tempo_base_minutos e distancia_base_km por par origem-destino.
• Exemplo de Estrutura de Output:

   [{"origem": {"lat": -23.5505, "lon": -46.6333}, "destino": {"lat": -23.5515, "lon": -46.6345}, "dia_semana": 1, "janela_horaria_local": ["08:00", "09:00"], "tempo_base_minutos": 15, "distancia_base_km": 5, "confianca_base": 0.9}] 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.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: O agente deverá enviar o JSON recebido para as APIs externas de mapas/trânsito e retornar os dados enriquecidos.

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 Análise de Ineficiências de Rotas (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Análise de Ineficiências de Rotas (RF 3).

Identificar padrões de ineficiência por colaborador, por par origem-destino e por coortes (meio de transporte, período, dia da semana), gerando KPIs e causas prováveis.

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 validado e enriquecido com dados de tempo_base_minutos e distancia_base_km.
• 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é 100.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com diagnóstico dos padrões de ineficiência, contendo KPIs e causas prováveis.
• Exemplo de Estrutura de Output:

   {
    "kpis_globais": {...},
    "kpis_por_coorte": {...},
    "ranking_ineficiencias": [{"chave": "colaborador_1", "tipo": "OD", "indice_ineficiencia": 0.2, "ganho_potencial_min": 10, "amostra_n": 20}],
    "causas_provaveis_por_item": {...},
    "hotspots_geograficos": [{"bbox": [-23.5505, -46.6333, -23.5515, -46.6345], "ocorrencias": 15}],
    "oportunidades_rapidas": [...]
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 15.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 Proposição de Melhorias de Rotas (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Proposição de Melhorias de Rotas (RF 4).

Gerar alternativas concretas de rota, janela de partida e política de deslocamento, com estimativa de ganho e pré-requisitos.

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 diagnóstico com padrões de ineficiência, ranking de ineficiências, hotspots e baseline/tempos por OD.
• 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é 50.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com recomendações de melhorias de rotas, contendo escopo, proposta, estimativa de ganho, impactos, restrições e como implementar.
• Exemplo de Estrutura de Output:

   [{"escopo": "colaborador", "proposta": {"tipo": "rota_alternativa", "estimativa": {"ganho_min_medio": 8, "ganho_p90": 10, "confianca": 0.8}, "impactos": {"custo_implantacao_estimado": 100, "dependencias": []}, "restricoes": {"janela": "08:00-09:00", "acessibilidade": true, "politicas": []}, "como_implementar": ["Etapa 1: Análise", "Etapa 2: Implementação"]}] 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 8.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: 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 Simulação de Impacto Operacional e Financeiro (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Simulação de Impacto Operacional e Financeiro (RF 5).

Projetar impacto agregado das propostas em tempo e custos, considerando adesão esperada e cenários.

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 recomendações de melhorias de rotas e KPIs de ineficiências, além de parâmetros de custo.
• 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é 30.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON de cenários de impacto operacional e financeiro, contendo cenario, premissas, impacto e ranking de propostas por ROI.
• Exemplo de Estrutura de Output:

   [{"cenario": "conservador", "premissas": {"taxa_adesao": 0.4, "janela_implantacao_semanas": 8}, "impacto": {"tempo_poupado_min_mes": 1000, "economia_combustivel_km_mes": 500, "economia_financeira_mensal": 2000, "ROI_implantacao": 1.5, "payback_meses": 12}}] 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 10.000 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: Utiliza lógica interna para calcular impacto operacional e financeiro.
• 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 Plano de Monitoramento e Ajuste Contínuo de Rotas (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Plano de Monitoramento e Ajuste Contínuo de Rotas (RF 6).

Definir plano operacional de acompanhamento, métricas de sucesso, thresholds de ajuste e rotas candidatas a experimentos A/B.

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 a saída consolidada dos agentes anteriores, incluindo propostas priorizadas e metas de impacto.
• 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é 50.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON do plano de monitoramento e ajuste contínuo, contendo KPIs, cadencia_coleta, rotas_em_teste_AB, regras_de_ajuste e governanca.
• Exemplo de Estrutura de Output:

   {
    "kpis_de_controle": [{"nome": "tempo_medio_por_OD", "definicao": "Tempo médio por origem-destino", "formula": "soma(tempo_total)/n", "meta": 15, "limite_alerta": 20}],
    "cadencia_coleta": {"frequencia": "semanal", "janela_analise": "mensal"},
    "rotas_em_teste_AB": [{"OD": "A-B", "variante_A": "rota_atual", "variante_B": "rota_alternativa", "criterio_sucesso": "redução de tempo", "duracao_semanas": 6}],
    "regras_de_ajuste": [{"condicao": "C02_pico_persistente", "acao": "ampliar janela"}],
    "governanca": {"responsavel": "Gerente de Operações", "rotinas": "reuniões semanais", "canais_feedback": "formulário online"}
  } 

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

6.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

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

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

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

A execução deste agente finaliza o fluxo. O plano gerado deve ser disponibilizado à equipe responsável para implementação.