Agente de IA para Controle de Saldos de Benefícios

11 de November de 2025 • Tempo de leitura: 5 min

Como criar um agente de IA que monitora e gera relatórios sobre o saldo de benefícios dos usuários.

1. Propósito e Escopo

Este documento define todos os prompts, configurações de memória, transição entre estados, busca online e demais requisitos funcionais para o Fluxo de Agentes "Controle de Saldos de Benefícios", uma solução de automação projetada para monitorar e gerar relatórios sobre o saldo de benefícios dos usuários. 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 é assegurar que os saldos de benefícios estejam sempre precisos e atualizados, além de notificar sobre quaisquer discrepâncias ou necessidades de recarga, melhorando a transparência e a eficiência no gerenciamento de benefícios.

2. Contexto e Problema

Cenário Atual

O gerenciamento de saldos de benefícios dos usuários enfrenta diversos desafios, como:

  • Falta de informações precisas e atualizadas sobre o saldo de benefícios dos usuários.
  • Inconsistências nos saldos que passam despercebidas até serem identificadas por um usuário.

Atualmente, a atualização dos saldos e a identificação de discrepâncias dependem de processos manuais e reativos, o que pode resultar em atrasos na identificação de problemas e na comunicação com os usuários.


Problemas Identificados

  • Informações Desatualizadas: Os usuários frequentemente enfrentam dificuldades devido à falta de dados atualizados sobre seus saldos de benefícios.
  • Inconsistências Não Detectadas: Discrepâncias nos saldos podem não ser identificadas a tempo, afetando a confiança no sistema de benefícios.
  • Comunicação Ineficiente: A falta de notificações proativas sobre necessidades de recarga ou ajustes nos saldos pode levar a frustrações e insatisfação dos usuários.

3. Impactos Esperados

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

  • Atualização Contínua: Garantir que os saldos de benefícios dos usuários sejam atualizados em tempo real.
  • Detecção Proativa de Inconsistências: Identificar e corrigir discrepâncias antes que sejam notadas pelos usuários.
  • Notificações Antecipadas: Enviar alertas automáticos sobre a necessidade de recarga ou ajustes nos saldos.
  • Confiança Aumentada: Melhorar a confiança dos usuários no sistema de benefícios, oferecendo informações precisas e atualizadas.

4. Visão Geral da Solução

O agente de IA para controle de saldos de benefícios monitora continuamente os saldos dos usuários, gera relatórios em tempo real e notifica sobre discrepâncias ou necessidade de recarga. 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 eficaz e autônomo no gerenciamento de saldos de benefícios dos usuários.

A solução consiste em um agente de IA que opera de forma contínua e integrada, garantindo a precisão e a atualização constante dos dados de saldo de benefícios.

Agente Função Principal
Agente de Monitoramento de Saldos de Benefícios (RF 1) Monitorar continuamente os saldos de benefícios dos usuários e atualizar os relatórios 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 do agente quanto o resultado final esperado. Explore os links abaixo para entender melhor a solução em ação.

6. Requisitos Funcionais

RF 1. Agente de Monitoramento de Saldos de Benefícios

1.1 Tarefa do Agente

Monitorar continuamente os saldos de benefícios dos usuários e atualizar os relatórios em tempo real.

1.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados de saldo de benefícios dos usuários em formato JSON. Esses dados são atualizados continuamente e representam o estado atual dos saldos dos usuários.

# 2. Objetivo
Monitorar continuamente os saldos de benefícios dos usuários e atualizar os relatórios em tempo real, enviando notificações sobre discrepâncias ou necessidades de recarga.

# 3. Regras que você deve seguir para gerar sua resposta
- Atualize o campo 'saldo_atualizado' para 'sim' após confirmação de atualização bem-sucedida do saldo de benefícios.
- Envie notificações automáticas para usuários e administração sempre que 'discrepancia_detectada' for 'true', detalhando a natureza da discrepância.
- Execute verificações de integridade de dados a cada 10 minutos. Se uma inconsistência for detectada, defina 'alerta_emitido' como 'sim' e especifique o tipo de alerta gerado.

# 4. Exemplo de Output que você deve produzir
{
  "saldo_atualizado": "sim",
  "discrepancia_detectada": "false",
  "alerta_emitido": "não"
} 
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 contínuo de dados de saldo de benefícios dos usuários 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 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 arquivo JSON contendo dados de saldo de benefícios dos usuários.
  • 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 texto com até 20.000 caracteres.

1.3.2 Especificação do Output

  • Formato de output: O output deve ser um JSON que reflete o status atualizado dos saldos e quaisquer ações tomadas, como notificações enviadas ou alertas emitidos.
  • Exemplo de Estrutura de Output:
     {
      "saldo_atualizado": "sim",
      "discrepancia_detectada": "true",
      "alerta_emitido": "sim"
    } 
  • Número de caracteres esperado: O JSON gerado deve ser conciso, com um tamanho estimado em torno 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: Utiliza lógica interna para verificações de integridade.
  • 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 os sistemas de notificação e administração de benefícios.

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

Este agente opera de forma contínua, atualizando e monitorando os saldos em tempo real sem necessidade de transição para outros agentes.

© 2025 prototipe.ai. Todos os direitos reservados.