Como Criar uma Base de Conhecimento: Artigos, Busca, Permissões e Respostas com IA

Uma base de conhecimento é uma biblioteca pesquisável de respostas: como fazer algo, como resolver algo, qual é a regra. Para criar uma, você precisa de artigos agrupados em poucas categorias claras, um editor que sua equipe de fato use, uma busca que encontre o artigo certo a partir das palavras que as pessoas realmente digitam, e uma decisão sobre quem pode ler o quê — o público, clientes logados ou apenas a equipe interna. Um construtor de apps com IA consegue gerar a estrutura, o editor e a busca em uma sessão curta. O que torna uma base de conhecimento útil é a escrita e a manutenção, então planeje para facilitar a edição e para identificar artigos desatualizados desde o primeiro dia.

Decida primeiro para quem é

As mesmas funcionalidades servem a sites bem diferentes:

• Central de ajuda pública — para clientes e possíveis clientes. Precisa ser rápida, indexável por buscadores e escrita com as palavras do público.
• Documentação só para clientes — atrás de um login, para clientes pagantes ou parceiros.
• Base de conhecimento interna — políticas, processos e tutoriais para a equipe. Precisa ser privada; busca e atualização importam mais do que o design.

Misturar artigos públicos e internos em um mesmo site é onde a maioria dos vazamentos acontece. Se você precisar dos dois, dê a cada artigo uma configuração de visibilidade clara, ou mantenha dois sites separados.

O que o app precisa

Dados

Dois campos fazem muito trabalho: responsável (quem mantém o artigo preciso) e data da última revisão (quando alguém confirmou pela última vez que ele ainda é verdadeiro). Juntos, eles permitem listar os artigos que ninguém checou em seis meses.

Páginas

• Leitor: página inicial com busca e categorias, páginas de categoria, páginas de artigo com sumário, artigos relacionados e a pergunta “Isto foi útil?”.
• Editor: lista de artigos com filtros (rascunhos, desatualizados, com avaliação baixa), um editor com pré-visualização e histórico de revisões.
• Admin: categorias, usuários e papéis, além de relatórios sobre buscas sem resultados.

Permissões

Leitores veem os artigos publicados que têm permissão de ver. Editores criam e editam artigos, talvez limitados a certas categorias. Admins publicam, arquivam e gerenciam usuários. Para uma base interna, todos precisam de login; para uma central de ajuda pública, só os redatores.

Decisões e trade-offs

Editor: Markdown ou texto formatado

Markdown é rápido, portátil e funciona bem com histórico de versões, mas alguns redatores acham pouco intuitivo. Um editor de texto formatado, com títulos, listas, imagens, destaques e blocos de código, parece familiar. Seja qual for a escolha, guarde o conteúdo em um formato que você consiga exportar depois.

Busca

Uma busca de texto simples no banco é suficiente para algumas centenas de artigos, se você pesquisar títulos, resumos e conteúdos e der mais peso às correspondências no título. Acima disso, ou se erros de digitação e sinônimos importam (“fatura” vs. “boleto”), use uma busca full-text de verdade ou um serviço de busca hospedado. Nosso guia sobre como adicionar busca mostra as opções. Registre toda consulta que não retorna nada: é uma lista gratuita de artigos a escrever.

Respostas com IA

Uma caixa de “faça uma pergunta” que responde com base nos seus artigos agora é comum. Ela funciona recuperando os trechos mais relevantes e pedindo a um modelo de linguagem que responda apenas com base neles — veja o que é RAG. Sempre mostre os artigos de origem, permita a resposta “não sei” e lembre que ela vai repetir com confiança qualquer coisa desatualizada nos seus artigos. Construa isso depois que os artigos estiverem em boa forma, não antes.

Versionamento e revisão

Mantenha revisões para ver quem mudou o quê e poder reverter. Para conteúdo regulado (política de RH, procedimentos de segurança), adicione uma etapa de aprovação antes de publicar uma mudança.

Um primeiro prompt que funciona

Crie uma central de ajuda pública para a Parcelly, um app de etiquetas de envio para pequenas lojas online. Página inicial com uma caixa de busca grande e seis categorias (Primeiros passos, Impressão de etiquetas, Transportadoras, Cobrança, Devoluções, Solução de problemas). Os artigos têm título, resumo, conteúdo em Markdown com imagens e destaques, categoria, tags, status (rascunho, publicado, arquivado), responsável e data da última revisão. As páginas de artigo mostram um sumário, artigos relacionados e uma pergunta “Isto foi útil?” com sim/não e um comentário opcional. A busca cobre títulos, resumos e conteúdos, com correspondências no título em primeiro lugar, e registra cada consulta e se ela retornou resultados. Uma área de editor (exige login, papéis de editor e admin) lista rascunhos, artigos não revisados há 180 dias e artigos com avaliações baixas, e mantém o histórico de revisões. Cada artigo tem seu próprio título de página e meta description para buscadores. Design limpo, calmo e legível. Pensado primeiro para celular.

Passos de construção

1. Liste os primeiros 20 a 30 artigos a partir de perguntas reais de suporte antes de construir qualquer coisa. Essa lista define as categorias.
2. Gere o site e confira a leitura no celular — largura da linha, títulos, imagens.
3. Editor e papéis. Os redatores precisam adicionar e corrigir artigos sem depender de um desenvolvedor.
4. Busca, e depois teste com as palavras que os clientes realmente usam, incluindo erros de digitação.
5. Feedback e registro de buscas.
6. Relatório de artigos desatualizados com base no responsável e na data da última revisão.
7. Básico de SEO para um site público: títulos e descrições únicos, URLs limpas, sitemap. Veja SEO para sites criados com IA.
8. Linke a base a partir do seu produto e das suas respostas de suporte, e acompanhe semanalmente o registro de buscas sem resultado.
9. Respostas com IA, quando o conteúdo estiver sólido.

Erros comuns

• Organizar por departamento em vez de pelo que o leitor está tentando fazer.
• Artigos longos cobrindo cinco tarefas. Uma tarefa por artigo, com um título que diga qual problema ele resolve.
• Nenhum responsável por artigo. Ninguém atualiza nada, e a confiança cai após a primeira resposta errada.
• Anotações internas em artigos públicos. Use visibilidade separada e revise antes de publicar.
• Busca que só encontra títulos. Os leitores digitam sintomas, não nomes de artigos.
• Capturas de tela sem texto alternativo ou contexto. Elas envelhecem rápido; descreva o passo também em palavras.

Quando um produto pronto é a melhor escolha

Se sua equipe já trabalha em uma ferramenta de documentação ou wiki, uma base de conhecimento interna ali costuma ser o caminho de menor resistência — nossa comparação entre Notion e Confluence cobre duas escolhas comuns. Se você usa um produto de helpdesk, a central de ajuda embutida liga artigos aos chamados e sugere artigos aos clientes, o que é difícil de reproduzir. Geradores de sites de documentação são ideais para documentação de desenvolvedor mantida junto com o código.

Construa a sua quando precisar de estrutura ou permissões próprias (artigos por cliente, por unidade, por função), quiser a base dentro do seu produto em vez de um site separado, precisar de etapas de revisão e aprovação que uma wiki não impõe, ou quiser respostas de IA sobre o seu conteúdo sem outra assinatura. Ela combina bem com um helpdesk próprio.

Construindo com o Mythex

No Mythex você descreve a base de conhecimento no chat e ela é construída em uma pré-visualização ao vivo; artigos, revisões e feedback ficam em um banco Postgres que o agente adiciona quando necessário, e as imagens vão para o armazenamento de arquivos do projeto. O login dos editores usa uma abordagem de autenticação que você escolhe, já que o Mythex não tem login de usuário final embutido. Para respostas com IA, você usa a chave de API do seu próprio provedor de IA, guardada como segredo do projeto, e o consumo é cobrado na sua conta do provedor, não em créditos do Mythex (receita de IA). Novos apps do Mythex usam por padrão um SPA em React renderizado no cliente, que é mais fraco para buscadores; então, para uma central de ajuda pública, peça uma configuração estática ou renderizada no servidor, como Next.js (receita de SEO).

Para um prompt inicial, experimente os modelos hub de conhecimento do produto ou app de documentação da equipe.

Perguntas