Agente de IA para Gestão de Empréstimos e Devoluções

Este documento define todos os prompts, configurações de memória, transição entre estados e demais requisitos funcionais para o Agente de IA para Gestão de Empréstimos e Devoluções. 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 empréstimo e devolução de livros, garantindo que os registros sejam atualizados em tempo real e que notificações automáticas sobre prazos de devolução e disponibilidade de livros reservados sejam enviadas aos usuários.

Cenário Atual

Atualmente, o processo de gestão de empréstimos e devoluções de livros na biblioteca é manual e demorado, resultando em ineficiências e erros no controle de prazos e disponibilidade de livros.

• Processo manual e demorado de gestão de empréstimos e devoluções de livros na biblioteca.
• Necessidade de garantir a eficiência e a precisão no controle de prazos e disponibilidade de livros.

Problemas Identificados

• Consumo de tempo: O processo manual consome tempo valioso que poderia ser melhor aproveitado em outras atividades da biblioteca.
• Erros de registro: A atualização manual dos registros é propensa a erros, levando a inconsistências nos dados de disponibilidade de livros.
• Falta de notificações automáticas: Usuários não recebem lembretes automáticos sobre prazos de devolução, aumentando o risco de atrasos.

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

• Reduzir o tempo de processamento de empréstimos e devoluções em pelo menos 70%.
• Melhorar a precisão dos registros de disponibilidade de livros.
• Automatizar o envio de notificações para lembrar os usuários sobre prazos de devolução e disponibilidade de reservas.

O agente de IA para gestão de empréstimos e devoluções automatiza o processo de empréstimo e devolução de livros, garantindo a atualização em tempo real dos registros e o envio de notificações automáticas. A seguir são detalhadas todas as regras de negócio e especificações funcionais necessárias para que esse agente atue eficientemente na gestão de empréstimos e devoluções na biblioteca.

A solução consiste em um fluxo de automação composto por diversos agentes de IA. O processo inicia com a validação e orquestração dos empréstimos e termina com a execução de notificações para os usuários.

A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.

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.

RF 1. Agente de Validação e Orquestração de Empréstimo

# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados estruturados para validar a elegibilidade de um usuário para empréstimo de livro, incluindo informações sobre o usuário, livro e políticas da biblioteca.

# 2. Objetivo
Validar a elegibilidade do usuário, a disponibilidade do exemplar, calcular a data de devolução e resolver filas de reserva.

# 3. Regras que você deve seguir para gerar sua resposta
- Negar empréstimo se usuario.multa_em_aberto > 0 ou usuario.atrasos_abertos > 0; definir emprestimo_autorizado=false e motivo_bloqueio="pendencias".
- Negar se contagem de usuario.emprestimos_ativos >= politicas.limite_emprestimos_por_categoria[usuario.categoria]; motivo_bloqueio="limite_atingido".
- Verificar reserva: se livro.fila_reserva não vazia e primeiro da fila != usuario.id, negar com motivo_bloqueio="reserva_prioritaria" e prioridade_reserva_respeitada=false; se usuario.id for o primeiro, prioridade_reserva_respeitada=true.
- Verificar disponibilidade: se livro.exemplares_disponiveis < 1 e não há prioridade de reserva para o usuário, negar com motivo_bloqueio="sem_exemplar".
- Em caso autorizado, calcular data_prevista_devolucao = data_referencia + politicas.prazo_por_categoria_dias[usuario.categoria] (não ajustar fins de semana a menos que política traga exceção; se trouxer, role para o próximo dia útil). Saída no formato ISO YYYY-MM-DD.
- Preencher payload_api_atualizacao com operacao="registrar_emprestimo" e datas; nunca incluir campos nulos.
- Montar payload_notificacao.tipo="emprestimo_confirmado" com variáveis obrigatórias (nome_usuario, titulo_livro, data_prevista_devolucao) e lembretes em P-3d e P-1d relativos à data_prevista_devolucao.
- Definir usuario_posicao_fila conforme posição do usuário na fila (0 se não está na fila); se usuário for atendido por reserva, removê-lo logicamente da fila ao construir o payload (não executa remoção; apenas sinaliza via payload_api_atualizacao.extensoes = {"remover_reserva": true}).