PrototipeAI | Agente de IA para Atualização de Tarifas de Transporte

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 o Fluxo de Agentes "Atualização de Tarifas de Transporte", uma solução de automação projetada para garantir que as tarifas de transporte público estejam sempre atualizadas e corretas nos sistemas de vale-transporte. Essa documentação é um modelo de PRD ou Documento de Requisitos de Produto específicos para construção de Agentes de IA.

O objetivo principal é coletar automaticamente as atualizações de tarifas de fontes confiáveis e oficiais e atualizar os sistemas de vale-transporte em tempo real, assegurando conformidade com as regulamentações locais.

2. Contexto e Problema

Cenário Atual

O sistema de vale-transporte enfrenta desafios significativos devido à desatualização das tarifas de transporte público, levando a erros nos créditos de vale-transporte e, consequentemente, a problemas financeiros para os usuários e empresas.

Desatualização das tarifas de transporte público, levando a erros nos créditos de vale-transporte.
Necessidade de atualização contínua e precisa das tarifas para evitar problemas financeiros.

Problemas Identificados

Erros nos créditos de vale-transporte: A desatualização das tarifas causa inconsistências nos valores creditados aos usuários.
Impacto financeiro: Erros nos créditos podem gerar prejuízos para empresas e descontentamento entre os colaboradores.
Falta de automação: O processo manual de atualização é suscetível a falhas e não acompanha a dinâmica das mudanças tarifárias.

3. Impactos Esperados

A implementação deste fluxo de automação visa alcançar os seguintes resultados:

Atualização precisa das tarifas em tempo real, eliminando erros nos créditos de vale-transporte.
Redução de impactos financeiros negativos para empresas e usuários.
Conformidade com regulamentações locais, assegurando que todas as atualizações de tarifas estejam de acordo com as normas.

4. Visão Geral da Solução

O agente de IA para atualização de tarifas de transporte coleta automaticamente as atualizações de tarifas de fontes confiáveis e oficiais e atualiza os sistemas de vale-transporte em tempo real. A seguir são detalhadas todas as regras de negócio e especificações funcionais necessárias para que esse agente atue de forma autônoma e eficiente, garantindo que as tarifas de transporte público estejam sempre corretas nos sistemas de vale-transporte.

A solução consiste em um fluxo de automação composto por 2 agentes de IA, conforme detalhado na tabela abaixo.

Agentes	Função Principal
`Agente de Coleta de Tarifas de Transporte` (RF 1)	Coletar automaticamente as atualizações de tarifas de transporte de fontes confiáveis e oficiais.
`Agente de Atualização de Sistemas de Vale-Transporte` (RF 2)	Atualizar os sistemas de vale-transporte com as novas tarifas em tempo real.

5. Protótipos

Para proporcionar uma visão clara e tangível da solução proposta, criamos protótipos interativos que demonstram tanto o fluxo de trabalho dos agentes quanto o resultado final que o cliente 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 Coleta de Tarifas de Transporte

1.1 Tarefa do Agente

Coletar automaticamente as atualizações de tarifas de transporte de fontes confiáveis e oficiais.

1.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo parâmetros de busca para identificar fontes oficiais de tarifas de transporte.

# 2. Objetivo
Coletar automaticamente as atualizações de tarifas de transporte de fontes confiáveis e oficiais.

# 3. Regras que você deve seguir para gerar sua resposta
- Identificar e listar todas as fontes oficiais confiáveis de tarifas de transporte.
- Programar verificações regulares e automáticas para coletar as atualizações de tarifas.
- Validar as informações coletadas assegurando que estão em conformidade com as regulamentações locais.
- Registrar a data e a fonte de cada atualização de tarifa coletada.

# 4. Exemplo de Output que você deve produzir
{
  "tarifas": [
    {
      "fonte": "Agência de Transportes SP",
      "data_atualizacao": "2025-11-16",
      "tarifa": 4.50
    }
  ]
}

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 parâmetros de busca via API. Na fase de testes, o fluxo será iniciado pelo envio manual dos dados, que serão enviados para o agente diretamente pela interface da Prototipe AI, para acelerar o processo de validação.
Tipo do input: Parâmetros de busca para fontes oficiais de tarifas de transporte.
Formatos Suportados: Esse agente deve ser capaz de receber parâmetros em formato JSON.
Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 2.000 caracteres.

1.3.2 Especificação do Output

Formato de output: O output deve ser um arquivo JSON contendo as tarifas atualizadas, a fonte e a data de atualização.

Exemplo de Estrutura de Output:

 {
  "tarifas": [
    {
      "fonte": "Agência de Transportes SP",
      "data_atualizacao": "2025-11-16",
      "tarifa": 4.50
    }
  ]
}

Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 500 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: Utiliza para verificar atualizações em fontes oficiais.
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 Atualização de Sistemas 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 Atualização de Sistemas de Vale-Transporte (RF 2).

RF 2. Agente de Atualização de Sistemas de Vale-Transporte

2.1 Tarefa do Agente

Atualizar os sistemas de vale-transporte com as novas tarifas em tempo real.

2.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados atualizados de tarifas de transporte.

# 2. Objetivo
Atualizar os sistemas de vale-transporte com as novas tarifas em tempo real.

# 3. Regras que você deve seguir para gerar sua resposta
- Integrar os dados de tarifas atualizados ao sistema de vale-transporte.
- Verificar se o sistema de vale-transporte aceita e processa as novas tarifas sem erros.
- Emitir uma confirmação após a atualização bem-sucedida das tarifas no sistema.
- Monitorar o sistema em tempo real para corrigir possíveis erros de atualização.

# 4. Exemplo de Output que você deve produzir
{
  "confirmacao": "Tarifas atualizadas com sucesso",
  "data_atualizacao": "2025-11-16"
}

2.3 Configurações do Agente

2.3.1 Especificação do Input

Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 1).
Tipo do input: Dados atualizados de tarifas de transporte.
Formatos Suportados: Esse agente deve ser capaz de receber dados em formato JSON.
Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 1.000 caracteres.

2.3.2 Especificação do Output

Formato de output: O output deve ser um arquivo JSON contendo a confirmação de atualização das tarifas e a data de atualização.