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 "Gestão de Arquivos Acadêmicos", uma solução projetada para organizar e classificar arquivos acadêmicos, facilitando o acesso e a recuperação de documentos importantes. 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 é implementar um sistema automatizado que classifique e organize arquivos acadêmicos, melhorando a eficiência na busca e recuperação de documentos.
2. Contexto e Problema
Cenário Atual
Atualmente, a gestão de arquivos acadêmicos enfrenta diversos desafios, principalmente relacionados à desorganização e à dificuldade de acesso a documentos importantes. Isso resulta em um tempo elevado para recuperação de documentos devido à falta de classificação adequada.
Problemas Identificados
- Desorganização: Arquivos acadêmicos estão frequentemente desorganizados, dificultando a localização e o acesso rápido.
- Tempo de Recuperação: A falta de um sistema de classificação eficiente aumenta o tempo necessário para encontrar documentos específicos.
3. Impactos Esperados
A implementação deste fluxo de automação visa alcançar os seguintes resultados:
- Reduzir o tempo de recuperação de documentos em pelo menos 70%.
- Melhorar a organização e a classificação de arquivos acadêmicos.
- Aumentar a eficiência do sistema de busca de documentos.
4. Visão Geral da Solução
O agente de IA para gestão de arquivos acadêmicos organiza e classifica documentos com base em critérios definidos, facilitando o acesso e a recuperação rápida de documentos importantes. 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 na gestão de arquivos acadêmicos.
A solução consiste em um fluxo de automação composto por 3 agentes de IA. O processo inicia com a classificação automática dos arquivos e termina com a implementação de um sistema de busca eficiente.
A execução dos agentes é sequencial, seguindo a ordem definida na tabela abaixo:
| Agentes | Função Principal |
|---|---|
Agente de Classificação de Arquivos Acadêmicos (RF 1)
| Classificar automaticamente arquivos acadêmicos com base em critérios definidos. |
Agente de Organização de Arquivos Acadêmicos (RF 2)
| Organizar arquivos acadêmicos para facilitar o acesso e recuperação rápida. |
Agente de Busca de Arquivos Acadêmicos (RF 3)
| Implementar um sistema de busca eficiente para localizar documentos rapidamente. |
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 esperado. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Classificação de Arquivos Acadêmicos
1.1 Tarefa do Agente
Classificar automaticamente arquivos acadêmicos com base em critérios definidos.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo arquivos acadêmicos em diversos formatos. Sua tarefa é analisar e classificar esses arquivos de acordo com critérios predefinidos.
# 2. Objetivo
Classificar arquivos acadêmicos com base em tipo de documento, palavras-chave e metadados relevantes.
# 3. Regras que você deve seguir para gerar sua resposta
- Analise o texto completo do arquivo para identificar o tipo de documento (artigo, tese, relatório, etc.).
- Extraia palavras-chave do conteúdo e atribua tags relevantes que descrevam o tema e a área de estudo.
- Utilize metadados, como autor, data de publicação e instituição, para auxiliar na classificação e garantir precisão.
- Verifique a presença de seções específicas, como introdução, metodologia e conclusão, para determinar a estrutura do documento.
# 4. Exemplo de Output que você deve produzir
{"classificacao": "Artigo Científico", "tags": ["Ciência", "Pesquisa"]} 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 acadêmicos 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: Arquivos acadêmicos em diversos formatos.
-
Formatos Suportados: Esse agente deve ser capaz de receber arquivos nos formatos:
.pdf,.docx,.txt. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 100.000 caracteres por documento.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON contendo a classificação do documento e as tags atribuídas.
-
Exemplo de Estrutura de Output:
{"classificacao": "Artigo Científico", "tags": ["Ciência", "Pesquisa"]} - Número de caracteres esperado: O JSON de output 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: 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 Organização de Arquivos Acadêmicos (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Organização de Arquivos Acadêmicos (RF 2).
RF 2. Agente de Organização de Arquivos Acadêmicos
2.1 Tarefa do Agente
Organizar arquivos acadêmicos para facilitar o acesso e recuperação rápida.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados classificados de arquivos acadêmicos. Sua tarefa é organizar esses arquivos de forma eficiente.
# 2. Objetivo
Organizar arquivos acadêmicos em uma estrutura de pastas clara e lógica, baseada nas classificações atribuídas.
# 3. Regras que você deve seguir para gerar sua resposta
- Crie uma hierarquia de pastas baseada nas classificações atribuídas, como área de estudo, tipo de documento e ano de publicação.
- Automatize o processo de movimentação de arquivos para os diretórios apropriados, assegurando que a estrutura respeite as convenções organizacionais definidas.
- Garanta que a organização permita fácil atualização e manutenção, facilitando a adição de novos documentos sem comprometer a estrutura existente.
# 4. Exemplo de Output que você deve produzir
{"estrutura": "Pasta/Categoria", "localizacao": "Caminho do Diretório"} 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: Dados classificados de arquivos acadêmicos.
-
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é 5.000 caracteres por documento.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON contendo a estrutura de pastas e os caminhos de diretórios para cada arquivo.
-
Exemplo de Estrutura de Output:
{"estrutura": "Área/Tese/2025", "localizacao": "Documentos/Acadêmicos/Área/Tese/2025"} - Número de caracteres esperado: O JSON de output terá um tamanho aproximado de 500 caracteres.
2.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
2.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.
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 Busca de Arquivos Acadêmicos (RF 3).
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Busca de Arquivos Acadêmicos (RF 3).
RF 3. Agente de Busca de Arquivos Acadêmicos
3.1 Tarefa do Agente
Implementar um sistema de busca eficiente para localizar documentos rapidamente.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo uma consulta de busca do usuário. Sua tarefa é localizar documentos acadêmicos de forma rápida e eficiente.
# 2. Objetivo
Desenvolver um sistema de busca que permita consultas por palavras-chave, autor, data, tipo de documento e tags atribuídas.
# 3. Regras que você deve seguir para gerar sua resposta
- Desenvolva um sistema de busca que permita consultas por palavras-chave, autor, data, tipo de documento e tags atribuídas.
- Implemente algoritmos de ordenação que priorizem resultados por relevância, frequência de acesso e data de modificação.
- Inclua a capacidade de filtrar resultados por múltiplos critérios simultaneamente, oferecendo uma interface de busca avançada para usuários experientes.
- Assegure que o sistema de busca seja escalável e mantenha performance eficiente mesmo com grandes volumes de dados.
# 4. Exemplo de Output que você deve produzir
{"resultados": [{"nome_arquivo": "Documento1.pdf", "caminho": "Caminho/Para/Documento1.pdf"}]} 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: Consulta de busca do usuário.
-
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é 1.000 caracteres por consulta.
3.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON contendo os resultados da busca, com nome do arquivo e caminho de diretório.
-
Exemplo de Estrutura de Output:
{"resultados": [{"nome_arquivo": "Documento1.pdf", "caminho": "Caminho/Para/Documento1.pdf"}]} - Número de caracteres esperado: O JSON de output terá um tamanho aproximado de 1.000 caracteres, dependendo do número de resultados retornados.
3.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
3.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.
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 é o entregável final e não é passada para outros agentes internos.
3.3.6 Regras de Orquestração e Transição
A execução deste agente finaliza o fluxo. Os resultados da busca são o resultado que deve ser disponibilizado ao usuário.