Base de Conhecimento RAG

Gerencie os documentos do Agente Tecnico. Faca upload, substitua ou remova arquivos por curso.

📖

Como preparar e subir documentos corretamente

Padroes de arquivo, nomenclatura e boas praticas para o RAG funcionar bem

▼

📄 Formatos aceitos

PDF — formato preferido. O arquivo precisa ter texto selecionavel (nao pode ser PDF escaneado/imagem). Para testar: abra o PDF e tente selecionar o texto com o mouse.
DOCX — documentos Word. Funciona bem para transcricoes e materiais de aula.
TXT — texto puro. Ideal para transcricoes brutas de video ou audio.
Tamanho maximo: 15 MB por arquivo.

Nao funciona: PDFs escaneados (foto do papel), imagens, planilhas Excel (.xlsx) ou apresentacoes PowerPoint (.pptx). Converta para PDF com texto selecionavel antes de subir.

🏷️ Nome do arquivo

Use o numero e nome da aula como nome do arquivo. Ex: 3.3. Como chegar na adubacao ideal.pdf
O nome do arquivo vira o nome da aula que o agente vai indicar para o aluno. Quanto mais claro, melhor.
Evite nomes genericos como aula1.pdf ou documento.pdf.
Use o padrao: [modulo].[aula]. [titulo].pdf
Nao use caracteres especiais nem acentos no nome: use adubacao em vez de adubação.

Bom exemplo: 3.3. Como chegar na adubacao ideal.pdf
Ruim: aula nova.pdf ou Adubação (1).pdf

📂 Qual pasta (curso) usar

Cada arquivo deve ser salvo na pasta do curso correto: CRIA, RECRIA ou ENGORDA.
O agente usa essa informacao para filtrar o conteudo certo quando o aluno informa em qual fase esta.
Se um mesmo tema aparece em mais de um curso, suba o arquivo em cada pasta separadamente.
Nao misture conteudo de cursos diferentes em um unico arquivo.

📝 Qualidade do conteudo

O conteudo ideal e uma transcricao completa da aula — quanto mais texto, melhor o agente encontra as informacoes.
Evite arquivos so com imagens, tabelas ou graficos sem texto explicativo.
Se for uma transcricao de video, nao precisa editar — suba o texto bruto, o sistema divide automaticamente em partes.
Minimo recomendado: 300 palavras por arquivo para o RAG funcionar bem.
Arquivos muito curtos (menos de 50 palavras) sao ignorados automaticamente.

🔄 Substituir ou atualizar um arquivo

Para atualizar um documento, suba um novo arquivo com o mesmo nome. O sistema substitui automaticamente todos os chunks antigos.
Se mudar o nome do arquivo, o sistema trata como um arquivo novo — o antigo continua no banco ate ser excluido manualmente.
Apos substituir, o agente ja usa o conteudo novo na proxima pergunta — nao precisa reiniciar nada.

📥 Como subir via Google Drive

Abra o arquivo no Google Drive e clique em Compartilhar.
Mude o acesso para "Qualquer pessoa com o link".
Copie o link e cole no campo "Importar pelo link do Google Drive" no modal de upload.
Funciona para PDF, DOCX e TXT publicos. Arquivos privados ou com restricao de dominio nao sao aceitos.