PrototipeAI | Agente de IA para Planejamento de Rotas de Transporte Público

1. Propósito e Escopo

Este documento define todos os prompts, configurações de memória, transição entre estados, ferramentas como chamadas a sistemas externos e demais requisitos funcionais para a criação de um agente de IA que sugere rotas de transporte público otimizadas. Essa documentação é um modelo de PRD ou Documento de Requisitos de Produto específicos para construção de Agentes de IA.

O objetivo do agente é auxiliar usuários de vale-transporte a planejarem suas rotas de forma eficiente, utilizando dados de trânsito em tempo real e horários de transporte público.

2. Contexto e Problema

Cenário Atual

Usuários de transporte público enfrentam dificuldades para planejar rotas eficientes devido a problemas como:

Dificuldade em acessar informações atualizadas sobre trânsito e horários de transporte público.
Necessidade de otimizar o uso de vale-transporte com base em rotas mais eficientes.

A ausência de informações em tempo real e a falta de integração entre diferentes meios de transporte público agravam esses problemas, resultando em rotas ineficientes e perda de tempo.

Problemas Identificados

Falta de informações atualizadas: Os usuários não conseguem acessar dados atualizados de trânsito e horários de transporte.
Planejamento ineficiente: A dificuldade em planejar rotas otimizadas resulta em viagens mais longas e desconfortáveis.
Uso inadequado do vale-transporte: Sem informações precisas, os usuários podem esgotar seus créditos de forma ineficaz.

3. Impactos Esperados

A implementação deste agente de IA visa alcançar os seguintes resultados:

Reduzir o tempo de viagem dos usuários ao sugerir rotas otimizadas com base em dados de trânsito em tempo real.
Melhorar a experiência do usuário ao fornecer informações atualizadas e integradas de transporte público.
Otimizar o uso do vale-transporte ao sugerir rotas que maximizam a eficiência dos créditos.

4. Visão Geral da Solução

O agente de IA para planejamento de rotas de transporte público analisa dados de trânsito em tempo real e integra informações de horários de transporte público para sugerir rotas otimizadas aos usuários. A seguir são detalhadas todas as regras de negócio e especificações funcionais necessárias para que esse agente atue como um assistente útil e autônomo no planejamento de rotas de transporte público.

A solução consiste em um fluxo de automação composto por um agente de IA. O processo inicia com a análise dos dados de trânsito e termina com a sugestão de rotas otimizadas para os usuários.

A execução do agente é linear, seguindo a ordem definida na tabela abaixo.

Agente	Função Principal
`Agente de Análise de Dados de Trânsito` (RF 1)	Analisar dados de trânsito em tempo real para otimizar rotas de transporte público.

5. Protótipos

Para proporcionar uma visão clara e tangível da solução proposta, criamos protótipos interativos que demonstram o fluxo de trabalho do agente e o resultado final que o usuário receberá. Explore os links abaixo para entender melhor a solução em ação.

Ver Agente na Prototipe AI

6. Requisitos Funcionais

RF 1. Agente de Análise de Dados de Trânsito

1.1 Tarefa do Agente

Analisar dados de trânsito em tempo real para otimizar rotas de transporte público, integrando informações de horários de ônibus e outros meios de transporte público.

1.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados de trânsito em tempo real e informações de horários de ônibus e outros meios de transporte público.

# 2. Objetivo
Analisar esses dados para sugerir rotas de transporte público otimizadas, levando em consideração o uso eficiente do vale-transporte e possíveis imprevistos no trânsito.

# 3. Regras que você deve seguir para gerar sua resposta
- Analise os dados de trânsito em tempo real para identificar congestionamentos e condições das vias.
- Integre informações de horários de ônibus, metrôs e outros meios de transporte público para planejar rotas mais rápidas e eficientes.
- Proponha rotas alternativas quando houver alterações ou imprevistos no trânsito, garantindo que o usuário chegue ao destino no menor tempo possível.
- Considere as restrições de uso do vale-transporte ao sugerir rotas, priorizando opções que maximizem o uso eficiente dos créditos disponíveis.
- Atualize as sugestões de rota em tempo real, conforme novas informações de trânsito e transporte público forem recebidas.
- Garanta que as informações de horários de ônibus e metrôs estejam sempre atualizadas para evitar atrasos inesperados.

1.3 Configurações do Agente

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 dados de trânsito em tempo real via API. Na fase de testes, os dados serão enviados pelo agente diretamente por upload de um arquivo JSON na interface da Prototipe AI, para acelerar o processo de validação.
Tipo do input: O input inicial para o fluxo é um conjunto de dados de trânsito em tempo real e horários de transporte público.
Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .json.
Número de caracteres esperado: Este agente deve ter capacidade para processar um input de dados com até 50.000 caracteres.

1.3.2 Especificação do Output

Formato de output: O output deve ser um conjunto de dados em formato JSON, contendo as rotas de transporte público otimizadas e alternativas em caso de imprevistos.

Exemplo de Estrutura de Output:

 {
  "optimized_routes": [
    {
      "route": "Rota 1",
      "duration": "45 minutos",
      "transfers": "2",
      "cost": "R$ 4,40"
    }
  ],
  "alternative_routes": [
    {
      "route": "Rota Alternativa 1",
      "duration": "50 minutos",
      "transfers": "1",
      "cost": "R$ 4,40"
    }
  ]
}

Número de caracteres esperado: O JSON gerado deve ter um tamanho aproximado de 2.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: Utiliza lógica interna para calcular a duração e o custo das rotas.
Busca Online: Utiliza para obter informações atualizadas de trânsito e horários de transporte público.
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 não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo, entregando as rotas otimizadas para o usuário.

Agente de IA para Planejamento de Rotas de Transporte Público