Agente de IA para Organização de Acervo em Bibliotecas Escolares

Analisar dados de empréstimos e devoluções para identificar popularidade, tendências e itens com baixa circulação no acervo.

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 estruturados de circulação e catálogo 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 CSV na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: Dados estruturados de circulação e catálogo.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .json, .csv.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON contendo resumos gerais, métricas por livro e por categoria, e uma lista de itens frios.
• Exemplo de Estrutura de Output:

   {
    "resumo_geral": {
      "periodo_analise": {"inicio": "YYYY-MM-DD", "fim": "YYYY-MM-DD"},
      "total_emprestimos": number,
      "itens_unicos": number
    },
    "metricas_por_livro": [
      {
        "livro_id": string,
        "titulo": string,
        "categoria_principal": string,
        "emprestimos_30d": number,
        "emprestimos_90d": number,
        "emprestimos_180d": number,
        "emprestimos_365d": number,
        "dias_medio_emprestimo": number,
        "atrasos_percentual": number, 
        "recencia_factor": number, 
        "tendencia_crescimento": number, 
        "popularidade_score": number, 
        "classe_demanda": "alta" | "media" | "baixa",
        "sazonalidade_pico": ["Meses"],
        "publico_predominante": "alunos" | "professores" | "misto"
      }
    ],
    "metricas_por_categoria": [
      {
        "categoria": string,
        "share_demanda_90d": number,
        "popularidade_media": number,
        "itens_frios": number,
        "tendencia_categoria": number
      }
    ],
    "itens_frios": ["livro_id", ...],
    "parametros_norma": {
      "p90_uso_30d": number,
      "media_180d": number,
      "desvio_180d": number
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.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.
• Calculadora: Utiliza lógica interna para calcular métricas de uso e popularidade.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 Sugestão de Organização do Acervo (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Sugestão de Organização do Acervo (RF 2).

Gerar um plano de organização física e de exposição do acervo com base nas métricas de demanda, categorias e sazonalidade.

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 a saída completa do Agente de Análise de Dados de Uso do Acervo e parâmetros de espaço em 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é 50.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON detalhando o plano de organização do acervo, incluindo zonificação, alocação de categorias, posicionamento de livros e recomendações de sinalização.
• Exemplo de Estrutura de Output:

   {
    "zonificacao": [
      {"zona": "A", "proposito": "Alta demanda e acesso rápido", "bays_atribuidos": [1,2], "capacidade_total": number },
      {"zona": "B", "proposito": "Demanda média", "bays_atribuidos": [3,4,5], "capacidade_total": number },
      {"zona": "C", "proposito": "Baixa demanda/arquivo", "bays_atribuidos": [6,7,8,9,10], "capacidade_total": number }
    ],
    "alocacao_categorias": [
      {"categoria": string, "zona": "A"|"B"|"C", "racional": string}
    ],
    "posicionamento_livros": [
      {"livro_id": string, "zona": "A"|"B"|"C", "bay": number, "prateleira": number, "face_out": true/false}
    ],
    "sinalizacao": {
      "placas_zona": [{"zona": "A", "texto": "Recomendados e mais emprestados"}],
      "rotulos_prateleira": [{"categoria": string, "cor": string, "icone": string}]
    },
    "realocacoes_sugeridas": [
      {"livro_id": string, "de": {"bay": number, "prateleira": number}, "para": {"bay": number, "prateleira": number}, "motivo": string}
    ],
    "revisao_periodica": {"frequencia": "mensal", "criterio_rebalanceamento": "se desvio de demanda > 15%"}
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado 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: Utiliza lógica interna para otimizar a organização do acervo.
• 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 completa o fluxo e é o produto final a ser utilizado para reorganizar o acervo.

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

A execução deste agente finaliza o fluxo e o plano de organização gerado deve ser implementado pela equipe da biblioteca.