O Open WebUI pode organizar documentos para que um modelo consulte informações antes de responder. Isso é útil quando uma equipe quer perguntar, por exemplo, qual procedimento deve seguir ou onde uma orientação aparece em um manual. Mas criar uma base nessa interface não dá acesso automático a um agente instalado em outro ambiente.
Há duas decisões separadas: fazer o conhecimento funcionar dentro do Open WebUI e conectar um consumidor externo, se necessário. Este guia começa por um teste pequeno na interface, com documentos de demonstração, para confirmar fontes e permissões antes de integrar um atendimento real.
O que é uma base de conhecimento nesse contexto
Uma base reúne arquivos e coleções que podem ser consultados pelo modelo conforme o modo configurado. A recuperação de informações busca partes relevantes para a pergunta; ela não equivale a treinar novamente o modelo. Também não garante que toda resposta esteja correta.
A documentação de Knowledge diferencia formas de trabalhar com arquivos, incluindo recuperação e uso de contexto completo. O comportamento depende da configuração e das capacidades do modelo. Não copie uma instrução de uma versão antiga sem conferir a interface e a documentação atuais.
Para decidir se esse esforço é necessário, leia quando usar RAG e quando uma FAQ basta. Uma lista curta de respostas aprovadas pode atender melhor uma operação que ainda tem poucas perguntas e regras muito estáveis.
Prepare um documento que você consiga conferir
Use um arquivo pequeno com informações fictícias ou sem dados sensíveis: horário de uma empresa de demonstração, canais internos e um procedimento simples. Separe materiais públicos dos que exigem acesso restrito. Não comece importando toda a pasta da empresa.
Defina nome, responsável e data de revisão. Se o documento contém instruções contraditórias, o sistema de busca não resolve o conflito por conta própria. Corrija a fonte antes de tentar ajustar o modelo para escolher qual versão parece melhor.
Primeiro teste na interface
- Entre com uma conta autorizada e abra a área de trabalho correspondente.
- Em Workspace → Knowledge, crie uma base com nome e descrição claros, conforme o guia oficial.
- Restrinja a visibilidade aos usuários e grupos apropriados.
- Adicione o arquivo de teste e aguarde a conclusão do processamento.
- Referencie a base no chat ou associe-a ao modelo pelas opções documentadas.
- Pergunte algo que esteja no material e confira a resposta diretamente no arquivo.
- Faça uma pergunta ausente e verifique se a resposta reconhece a limitação.
A documentação apresenta a referência com # e opções de associação em Workspace → Models. Os nomes e a disponibilidade dependem da versão e das permissões. Se o modelo usa ferramentas para buscar conhecimento, confirme que a configuração permite a recuperação; anexar uma base não prova que ela foi consultada.
O processamento precisa terminar
O envio de um arquivo pode iniciar uma extração que ainda não foi concluída. Quando alguém pergunta antes de o conteúdo estar pronto, a busca pode não encontrar a informação. Verifique o estado do processamento e uma amostra do texto extraído.
PDFs digitalizados podem exigir reconhecimento de texto, conhecido como OCR. Tabelas, imagens e colunas podem gerar uma extração inadequada mesmo quando o arquivo abre normalmente. O roteiro de como configurar uma base de atendimento com PDFs detalha preparação e testes para esse tipo de material.
Confira recuperação e fonte, não só a resposta
Prepare perguntas que exijam localizar trechos diferentes. Compare a resposta com o documento e confira se a referência realmente sustenta o que foi afirmado. Uma citação presente na tela não deve ser tratada como validação automática.
Teste ainda duas fontes com termos parecidos, uma informação substituída por nova versão e uma pergunta que não deveria ter resposta. Registre as falhas para distinguir problema de documento, de permissão, de busca ou de interpretação do modelo.
A documentação de RAG do Open WebUI explica configurações que alteram como arquivos participam do contexto. Não desative ou amplie recursos sem entender esse efeito, especialmente quando a base contém informações internas.
Como um agente externo usaria essa base
Um agente operando no Telegram ou em outra ferramenta precisa de um caminho de integração próprio. Pode ser uma chamada autenticada ao serviço com o modelo e o conhecimento configurados, ou outra camada de recuperação projetada para a operação. Isso deve ser validado com a versão instalada, não presumido a partir do chat da interface.
A referência de API documenta autenticação e recursos disponíveis. A identidade usada pela integração deve ter apenas os acessos necessários. Não coloque uma credencial administrativa no prompt nem abra o serviço publicamente apenas para simplificar a conexão.
Conectar o agente também exige definir o que retorna: resposta, trechos ou referências. O consumidor precisa saber reconhecer falha e falta de fonte. Se a recuperação não oferece informação confiável, o fluxo deve encaminhar a dúvida, e não preencher o vazio com outra resposta inventada.
Atualização e controle de acesso
Defina quem pode adicionar, substituir e retirar documentos. Uma política antiga pode continuar aparecendo se houver cópias ou índices esquecidos. Depois de alterar uma fonte, repita perguntas conhecidas e confira se a versão correta passou a ser utilizada.
Teste o acesso com perfis diferentes. Uma base privada na interface não deve ser considerada protegida em uma integração externa sem verificar a identidade e o caminho efetivamente usado. Logs e exportações também precisam respeitar as permissões e a retenção aprovadas.
Perguntas frequentes
Todo agente entende automaticamente uma base criada no Open WebUI?
Não. Um agente externo precisa de integração e autenticação apropriadas. Uma base acessível no seu chat não é um serviço universal de documentos para qualquer ferramenta.
Um PDF enviado já está pronto para responder?
Não necessariamente. Espere o processamento, confira a extração e valide perguntas de teste. O upload bem-sucedido não comprova qualidade da recuperação.
Posso usar apenas um manual curto?
Sim, desde que o modo escolhido e os acessos sejam adequados. Começar pequeno facilita conferir o comportamento antes de ampliar a coleção.
Próximo passo
Valide um documento e uma pergunta de cada vez. Para aprender os fundamentos antes de integrar conhecimento a um agente, conheça a Academia NT Labz.