Documentação Oficial - KnowledgeBasePro

1. O Problema e a Solução

Silos de Informação

Em ambientes técnicos, manuais PDF, scripts e anotações ficam espalhados. Encontrar a resposta certa vira uma caça ao tesouro ineficiente.

Conhecimento Unificado

O KnowledgeBasePro centraliza tudo. Ele entende seus arquivos e permite buscas precisas usando filtros avançados e Inteligência Artificial local.

2. Arquitetura Modular em Containers

O sistema adota uma abordagem de microsserviços isolados, garantindo segurança, estabilidade e facilidade de manutenção.

Application Core

Web & Logic Layer

Data Persistence

Structured Storage

Intelligence Engine

Local LLM Service

Módulo do Sistema	Responsabilidade	Stack Tecnológica
Application Service	Processamento central, orquestração de buscas e interface de usuário.	Python 3.12, Flask, Gunicorn
AI Engine (Local)	Processamento de linguagem natural e geração de vetores (Embeddings).	Ollama 3.2 (Isolado/Offline)
Web Gateway	Ponto de entrada seguro e gerenciamento de tráfego.	High Performance Web Server

3. Busca Avançada e Inteligência Híbrida

O KnowledgeBasePro utiliza um motor de busca híbrido que combina Filtros Rígidos (SQL) com Busca Semântica (Vetorial). Isso permite que você especifique exatamente onde quer procurar, enquanto a IA entende o que você quer encontrar.

Operadores de Busca

Operador	Sintaxe	Explicação e Exemplo
Frase Exata	`"..."`	Busca a sequência exata de palavras, ignorando sinônimos da IA. Ex: `"erro de conexão 504"`
Filtro de Categoria	`category:` ou `categoria:`	Restringe a busca a uma categoria específica do sistema. Ex: `senha wifi category:Redes` (Ignora artigos de RH)
Tipo de Arquivo	`filetype:` ou `ext:`	Busca apenas em arquivos com a extensão especificada. Ex: `relatório anual filetype:pdf`
Exclusão (Negativa)	`-`	Remove resultados que contenham a palavra especificada. Ex: `servidor linux -ubuntu` (Traz Debian, CentOS, mas não Ubuntu)
Busca Combinada	(Misto)	O poder máximo: Combine tudo em uma linha. Ex: `"firewall" category:Segurança filetype:pdf -cisco`

Como a "Mágica" Acontece?

1. Filtragem Rígida (SQL)

Antes de pensar, o sistema obedece aos seus comandos. Se você digitou category:TI, ele descarta fisicamente todo o resto do banco de dados. Isso garante 100% de precisão nos filtros e economiza processamento.

2. Análise Semântica (IA)

Nos resultados que sobraram, a IA calcula a relevância matemática (Embeddings). Ela entende que "Acesso Remoto" é similar a "VPN", mesmo que as palavras não sejam idênticas.

3. Geração de Resposta (RAG)

A IA lê o conteúdo dos 3 melhores resultados e escreve um resumo natural respondendo à sua pergunta, citando exatamente qual arquivo ou artigo contém a informação completa.

4. Ingestão Inteligente

Transforme arquivos brutos em conhecimento estruturado automaticamente.

Suporte a Múltiplos Formatos

PDF: Leitura nativa de manuais.
DOCX: Documentos Word.
Code: Scripts .py, .sh, .sql.

Refinamento via IA

Ao fazer upload na aba "Organizar com IA", o sistema lê o arquivo, identifica títulos, formata códigos e cria um artigo Markdown pronto para uso.

5. Controle de IA (Dual Brain)

O "cérebro" da plataforma pode ser alternado instantaneamente entre Nuvem e Edge AI.

Modo Nuvem

Google Gemini Pro

Máxima Performance

Modo Local (Edge AI)

Integração nativa com Ollama 3.2

Privacidade Absoluta (Offline)
Latência Zero de Rede
Modelo Llama 3.2 otimizado