Agente de IA para Análise de Custos de Transporte

Validar, higienizar e padronizar dados de uso de vale-transporte, preparando um dataset confiável para 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 arquivo CSV de dados 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 CSV na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um arquivo CSV contendo dados de uso de vale-transporte.
• Formatos Suportados: Esse agente deve ser capaz de receber arquivos no formato: .csv.
• 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 arquivo JSON contendo: schema_padronizado, linhas_normalizadas[], linhas_rejeitadas[] e estatísticas_preliminares.
• Exemplo de Estrutura de Output:

  {
    "schema_padronizado": {...},
    "linhas_normalizadas": [...],
    "linhas_rejeitadas": [...],
    "estatisticas_preliminares": {...}
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 10.000 caracteres, variando conforme o número de linhas e complexidade dos dados.

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 Custos e Eficiência de VT (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 Custos e Eficiência de VT (RF 2).

Calcular KPIs, padrões de custo e eficiência a partir dos dados normalizados de vale-transporte.

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 arquivo JSON contendo dados normalizados de uso de vale-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é 10.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo JSON contendo KPIs globais, KPIs por usuário, KPIs por trajeto, distribuições, anomalias detectadas e achados chave.
• Exemplo de Estrutura de Output:

  {
    "kpis_globais": {...},
    "kpis_por_usuario": {...},
    "kpis_por_trajeto": {...},
    "distribuicoes": {...},
    "anomalias_detectadas": [...],
    "achados_chave": [...]
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 15.000 caracteres, dependendo da quantidade de dados analisados.

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: Utiliza lógica interna para cálculos de KPIs e anomalias.
• 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 Oportunidades e Estratégias de Redução de Despesas 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 Oportunidades e Estratégias de Redução de Despesas de VT (RF 3).

Traduzir achados analíticos em oportunidades concretas de economia e estratégias de otimizaçã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 como input um arquivo JSON contendo KPIs e achados analíticos.
• 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.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo JSON contendo oportunidades de economia, cada uma com descrição, evidência, estratégia sugerida e outros detalhes.
• Exemplo de Estrutura de Output:

  {
    "oportunidades": [
      {
        "descricao": "Reduzir uso de VT nos finais de semana",
        "evidencia": "20% de uso em finais de semana",
        "estrategia_sugerida": "Reforçar política de uso e auditoria",
        "tipo": "quick_win",
        "estimativa_economia_percentual": "2–8%",
        "impacto": "medio",
        "esforco_implantacao": "baixo",
        "riscos": "resistência à mudança",
        "pre_requisitos": "comunicação interna",
        "owner_recomendado": "RH/Benefícios"
      }
    ]
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 12.000 caracteres, dependendo do número de oportunidades identificadas.

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: Utiliza lógica interna para calcular estimativas de economia e impacto.
• 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 de Relatório Executivo de VT (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Relatório Executivo de VT (RF 4).

Gerar relatório final claro e acionável para stakeholders, com sumário executivo, KPIs e plano de ação priorizado.

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 arquivo JSON contendo KPIs, achados e oportunidades de economia.
• 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.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório em formato Markdown estruturado com sumário executivo, KPIs, análises, oportunidades e próximos passos.
• Exemplo de Estrutura de Output:

  **Sumário Executivo**
  - Custo Total: R$ xxx.xxx
  - Economia Estimada: xx%
  - Top 3 Alavancas: A, B, C
  
  **KPIs-Chave**
  - Custo Médio Mensal por Usuário: R$ xxx
  
  **Oportunidades Priorizadas**
  | Descrição | Tipo | Economia Estimada | Impacto | Esforço | Riscos | Owner |
  |-----------|------|-------------------|---------|---------|--------|-------|
  | Reduzir uso de VT nos finais de semana | Quick Win | 5% | Médio | Baixo | Resistência à mudança | RH/Benefícios |
  
  **Próximos Passos**
  - [ ] Implementar quick wins em 30 dias
  - [ ] Revisar política de uso de VT em 90 dias

• Número de caracteres esperado: O relatório final terá um tamanho aproximado de 30.000 caracteres, dependendo da quantidade de informações e detalhes incluídos.

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: Utiliza lógica interna para cálculos de economia 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 agentes subsequentes.
• Visibilidade da Resposta: A resposta gerada por este agente é o entregável final e não precisa ser visível para outros agentes.

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