1. Propósito e Escopo
Este documento define todos os prompts, configurações de memória, transição entre estados e demais requisitos funcionais para o Fluxo de Agentes "Análise de Uso de Vale-Transporte", uma solução de automação projetada para otimizar a distribuição de créditos de vale-transporte e detectar possíveis fraudes ou abusos. 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 é transformar dados de uso de vale-transporte em informações analíticas que possam ser usadas para melhorar a eficiência na distribuição de créditos e aumentar a segurança contra fraudes.
2. Contexto e Problema
Cenário Atual
As empresas enfrentam desafios significativos na gestão de vale-transporte devido à falta de análise de uso detalhada. Isso resulta em:
- Ineficiência na distribuição de créditos de vale-transporte.
- Risco elevado de fraudes ou abusos no uso de vale-transporte sem monitoramento adequado.
- Dificuldade em identificar padrões de uso anormais ou suspeitos.
Atualmente, a falta de um sistema automatizado para análise de dados de uso de vale-transporte impede uma gestão eficiente e segura dos créditos distribuídos aos colaboradores.
Problemas Identificados
- Ineficiência na distribuição de créditos: Sem uma análise adequada, a distribuição de créditos de vale-transporte pode não refletir as necessidades reais dos colaboradores.
- Risco de fraudes: A ausência de monitoramento pode levar ao uso indevido dos créditos, resultando em perdas financeiras.
- Dificuldade em detectar padrões anormais: Sem ferramentas adequadas, identificar comportamentos suspeitos ou anormais no uso de vale-transporte é um desafio.
3. Impactos Esperados
A implementação deste fluxo de automação visa alcançar os seguintes resultados:
- Otimizar a distribuição de créditos de vale-transporte, alinhando-os com as necessidades reais dos colaboradores.
- Reduzir fraudes e abusos através de monitoramento contínuo e detecção de anomalias.
- Aumentar a eficiência operacional na gestão de vale-transporte, permitindo decisões baseadas em dados.
4. Visão Geral da Solução
O agente de IA para análise de uso de vale-transporte processa dados de uso, aplica algoritmos de detecção de anomalias e gera relatórios para otimizar a distribuição de créditos e detectar fraudes. 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 na gestão de vale-transporte.
A solução consiste em um fluxo de automação composto por 4 agentes de IA. O processo inicia com a padronização dos dados de uso e termina com a geração de um relatório executivo.
A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.
| Agentes | Função Principal |
|---|---|
Agente de Padronização e Consolidação de Dados de VT (RF 1)
| Unificar, limpar e padronizar os dados de uso de vale-transporte. |
Agente de Detecção de Anomalias de Uso de Vale-Transporte (RF 2)
| Identificar padrões anormais e possíveis fraudes/abusos no uso de vale-transporte. |
Agente de Otimização da Distribuição de Créditos de VT (RF 3)
| Recomendar a carga mensal de créditos por colaborador para reduzir desperdícios. |
Agente Gerador de Relatório Periódico de VT (RF 4)
| Consolidar achados em um relatório executivo periódico. |
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.
6. Requisitos Funcionais
RF 1. Agente de Padronização e Consolidação de Dados de VT
1.1 Tarefa do Agente
Unificar, limpar e padronizar os dados de uso de vale-transporte, integrando registros de validações/embarques com cadastro de colaboradores, jornadas e calendários para formar a base única de análise.
1.2 Prompt ou Instruções do Agente
Você está recebendo conjuntos de dados de uso de vale-transporte. Sua tarefa é unificar, limpar e padronizar esses dados, integrando registros de validações/embarques com cadastro de colaboradores, jornadas e calendários para formar a base única de análise. Siga as regras para garantir a qualidade e consistência dos dados.
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 arquivos CSV com dados de uso 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 dos arquivos na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo é um conjunto de arquivos CSV contendo dados de uso de vale-transporte.
-
Formatos Suportados: Esse agente deve ser capaz de receber arquivos nos formatos:
.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 objeto JSON estruturado contendo os dados consolidados e padronizados.
-
Exemplo de Estrutura de Output:
{"dataset_consolidado": {"usos_normalizados": [...]}, "qualidade_dados": {...}} - Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno 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 Detecção de Anomalias de Uso 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 Detecção de Anomalias de Uso de Vale-Transporte (RF 2).
RF 2. Agente de Detecção de Anomalias de Uso de Vale-Transporte
2.1 Tarefa do Agente
Identificar padrões anormais e possíveis fraudes/abusos no uso de vale-transporte, produzindo alertas explicáveis e priorizados.
2.2 Prompt ou Instruções do Agente
Você está recebendo dados consolidados de uso de vale-transporte. Sua tarefa é identificar padrões anormais e possíveis fraudes/abusos, gerando alertas explicáveis e priorizados. Siga as regras para garantir a precisão e relevância dos alertas gerados.
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: Este agente deve ser apto a receber como input um objeto JSON contendo os dados consolidados e padronizados.
-
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 objeto JSON contendo as anomalias identificadas e suas características.
-
Exemplo de Estrutura de Output:
{"anomalias": [...], "sumario": {...}} - Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno 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.
- Calculadora: Não utiliza.
- 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 Otimização da Distribuição de Créditos 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 Otimização da Distribuição de Créditos de VT (RF 3).
RF 3. Agente de Otimização da Distribuição de Créditos de VT
3.1 Tarefa do Agente
Recomendar a carga mensal de créditos por colaborador para reduzir desperdícios sem comprometer deslocamentos necessários.
3.2 Prompt ou Instruções do Agente
Você está recebendo dados de anomalias e uso de vale-transporte. Sua tarefa é recomendar a carga mensal de créditos por colaborador, reduzindo desperdícios sem comprometer deslocamentos necessários. Siga as regras para garantir a precisão das recomendações.
3.3 Configurações do Agente
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 objeto JSON contendo dados de anomalias e uso consolidados.
-
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 objeto JSON contendo as recomendações de crédito por colaborador.
-
Exemplo de Estrutura de Output:
{"recomendacoes": [...], "impacto_global": {...}} - Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 5.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.
- Calculadora: Utiliza lógica interna para calcular recomendações de crédito.
- 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 Gerador de Relatório Periódico de VT (RF 4).
3.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente Gerador de Relatório Periódico de VT (RF 4).
RF 4. Agente Gerador de Relatório Periódico de VT
4.1 Tarefa do Agente
Consolidar achados em um relatório executivo periódico para apoio à tomada de decisão sobre distribuição de créditos e gestão de fraudes.
4.2 Prompt ou Instruções do Agente
Você está recebendo dados de anomalias, recomendações de crédito e impacto global. Sua tarefa é consolidar esses achados em um relatório executivo, apoiando a tomada de decisão sobre distribuição de créditos e gestão de fraudes. Siga as regras para garantir a clareza e utilidade do relatório.
4.3 Configurações do Agente
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 objeto JSON contendo dados de anomalias, recomendações de crédito e impacto global.
-
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 consolidando os achados.
-
Exemplo de Estrutura de Output:
# Relatório de Uso de Vale-Transporte – Período: YYYY-MM-DD a YYYY-MM-DD ## Sumário Executivo - Economia total estimada: R$ X - Colaboradores afetados: N - Principais tipos de anomalia: ... ## Indicadores-Chave (KPIs) ... ## Detecção de Anomalias ... ## Recomendações de Créditos ... ## Ações Sugeridas ... ## Metodologia ...
- Número de caracteres esperado: O relatório gerado deve ter um tamanho estimado em torno de 10.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.
- Calculadora: Não utiliza.
- 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 nenhum agente subsequente.
- Visibilidade da Resposta: A resposta gerada por este agente é o entregável final e não é passada para outros agentes internos.
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.