PrototipeAI | Agente de IA para Recarga Automática de Cartões 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 Agente de IA "Recarga Automática de Cartões de 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 é automatizar o processo de recarga de cartões de transporte, garantindo que os usuários sempre tenham saldo suficiente para uso, com base em regras predefinidas ou solicitações dos usuários.

2. Contexto e Problema

A gestão de saldo em cartões de transporte é uma tarefa rotineira que muitos usuários acabam esquecendo ou não têm tempo de realizar manualmente. Isso pode causar inconvenientes, como falta de saldo suficiente para utilizar o transporte público. Além disso, ajustar as recargas de acordo com o padrão de uso individual de cada usuário pode ser desafiador.

Falta de tempo ou esquecimento dos usuários em realizar recargas manuais nos cartões de transporte.
Necessidade de garantir que os cartões de transporte sempre tenham saldo suficiente para uso.
Dificuldade em ajustar recargas de acordo com o padrão de uso individual de cada usuário.

3. Impactos Esperados

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

Automatizar o processo de recarga de cartões de transporte, reduzindo a necessidade de intervenção manual.
Garantir saldo suficiente nos cartões de transporte para evitar interrupções no uso.
Personalizar recargas com base nos padrões de uso e preferências dos usuários.

4. Visão Geral da Solução

O agente de IA para recarga automática de cartões de transporte monitora o uso do cartão, prevê necessidades de recarga e executa recargas automáticas com base em regras predefinidas ou solicitações dos 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 eficiente e confiável na gestão de saldos de cartões de transporte.

A solução consiste em um fluxo de automação composto por 2 agentes de IA. O processo inicia com o monitoramento do uso do cartão e termina com a confirmação da recarga realizada.

Agentes	Função Principal
`Agente de Monitoramento de Uso do Cartão` (RF 1)	Monitorar o uso do cartão de transporte e prever a necessidade de recargas.
`Agente de Recarga Automática` (RF 2)	Realizar recargas automáticas com base em padrões de uso e regras personalizadas.

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 usuário experimentará. 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 Monitoramento de Uso do Cartão

1.1 Tarefa do Agente

Monitorar o uso do cartão de transporte dos usuários e prever a necessidade de recargas.

1.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados de uso do cartão de transporte em formato JSON. Estes dados incluem informações sobre o saldo atual e transações recentes.

# 2. Objetivo
Analisar os dados de uso para prever a necessidade de recargas e gerar recomendações em formato JSON.

# 3. Regras que você deve seguir para gerar sua resposta
- Analise o uso diário do cartão de transporte para identificar padrões de consumo.
- Calcule a média de uso semanal e mensal para prever necessidades futuras de recarga.
- Gere alertas para o agente de recarga automática quando o saldo projetado para os próximos dias estiver abaixo do limite mínimo definido pelo usuário.

# 4. Exemplo de Output que você deve produzir
{
  "recomendacao_recarga": {
    "necessidade_imediata": true,
    "valor_sugerido": 50.00
  }
}

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 uso do cartão de transporte 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: Dados de uso do cartão de transporte em formato JSON.
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.

1.3.2 Especificação do Output

Formato de output: O output deve ser um arquivo no formato JSON contendo recomendações de recarga.

Exemplo de Estrutura de Output:

 {
  "recomendacao_recarga": {
    "necessidade_imediata": true,
    "valor_sugerido": 50.00
  }
}

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

1.3.4 Ferramentas do Agente

Documentos: Não consulta documentos externos.
Calculadora: Utiliza lógica interna para prever necessidades de recarga.
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 Recarga Automática (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Recarga Automática (RF 2).

RF 2. Agente de Recarga Automática

2.1 Tarefa do Agente

Realizar recargas automáticas com base em padrões de uso e regras personalizadas.

2.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo recomendações de recarga em formato JSON, geradas pelo agente de monitoramento de uso do cartão.

# 2. Objetivo
Realizar recargas automáticas com base nas recomendações recebidas e confirmar a transação.

# 3. Regras que você deve seguir para gerar sua resposta
- Verifique diariamente o saldo do cartão e compare-o com o limite mínimo definido pelo usuário.
- Efetue recarga automática quando o saldo atual estiver abaixo do limite mínimo e envie notificação ao usuário.
- Integre de forma segura com o sistema de pagamento para processar a recarga e registrar a transação.

# 4. Exemplo de Output que você deve produzir
{
  "recarga_realizada": true,
  "novo_saldo": 100.00
}

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 do agente anterior (RF 1).
Tipo do input: Recomendações de recarga em formato JSON.
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é 500 caracteres.

2.3.2 Especificação do Output

Formato de output: O output deve ser um arquivo no formato JSON confirmando a recarga realizada.