Como Criar uma Base de Conhecimento: Artigos, Pesquisa, 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, precisa de artigos agrupados em algumas categorias claras, um editor que os seus redatores realmente usem, uma pesquisa que encontre o artigo certo a partir das palavras que as pessoas realmente escrevem, e uma decisão sobre quem pode ler o quê — o público, os clientes com sessão iniciada ou apenas a equipa. Um construtor de aplicações com IA pode produzir a estrutura, o editor e a pesquisa numa sessão curta. O que torna uma base de conhecimento útil é a escrita e a manutenção, por isso desenhe-a desde o início para facilitar a edição e para identificar artigos desatualizados.

Decida primeiro para quem é

As mesmas funcionalidades servem sites muito diferentes:

• Centro de ajuda público — para clientes e potenciais clientes. Tem de ser rápido, indexável pelos motores de pesquisa e escrito com as palavras deles.
• Documentação só para clientes — atrás de um início de sessão, para clientes pagantes ou parceiros.
• Base de conhecimento interna — políticas, processos, guias práticos para a equipa. Tem de ser privada; a pesquisa e a atualidade importam mais do que o design.

Misturar artigos públicos e internos no mesmo site é a origem da maioria das fugas de informação. Se precisar dos dois, dê a cada artigo uma definição de visibilidade clara, ou mantenha dois sites separados.

O que a aplicação precisa

Dados

Dois campos fazem muito trabalho: responsável (quem mantém este artigo correto) e data da última revisão (quando alguém confirmou pela última vez que continua válido). Em conjunto, permitem listar os artigos que ninguém verificou nos últimos seis meses.

Páginas

• Leitor: página inicial com pesquisa e categorias, páginas de categoria, páginas de artigo com índice, artigos relacionados e uma pergunta "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.
• Administração: categorias, utilizadores e funções, e relatórios sobre pesquisas sem resultados.

Permissões

Os leitores veem os artigos publicados a que têm acesso. Os editores criam e editam artigos, talvez limitados a certas categorias. Os administradores publicam, arquivam e gerem utilizadores. Para uma base de conhecimento interna, todos precisam de início de sessão; para um centro de ajuda público, só os redatores.

Decisões e compromissos

Editor: Markdown ou texto enriquecido

Markdown é rápido, portátil e funciona bem com o histórico de versões, mas alguns redatores acham-no pouco acolhedor. Um editor de texto enriquecido, com títulos, listas, imagens, destaques e blocos de código, parece familiar. Seja qual for a escolha, guarde o conteúdo num formato que possa exportar mais tarde.

Pesquisa

A pesquisa de texto básica na base de dados chega para algumas centenas de artigos se pesquisar títulos, resumos e corpos, e der prioridade às correspondências no título. Para além disso, ou se erros de escrita e sinónimos forem importantes ("fatura" vs "conta"), use pesquisa de texto completo adequada ou um serviço de pesquisa alojado. O nosso guia para adicionar pesquisa apresenta as opções. Registe cada consulta que não devolva nada: é uma lista gratuita de artigos a escrever.

Respostas com IA

Uma caixa "faça uma pergunta" que responde a partir dos seus artigos é hoje comum. Funciona recuperando as passagens mais relevantes e pedindo a um modelo de linguagem que responda apenas a partir delas — veja o que é RAG. Mostre sempre os artigos de origem, permita "não sei" e lembre-se de que o sistema repetirá com toda a confiança qualquer informação desatualizada nos seus artigos. Construa-o depois de os artigos estarem bem organizados, e não antes.

Versões e revisão

Guarde as revisões para poder ver quem mudou o quê e reverter. Para conteúdo regulamentado (política de recursos humanos, procedimentos de segurança), acrescente um passo de aprovação antes de uma alteração ser publicada.

Um primeiro prompt que funciona

Crie um centro de ajuda público para a Parcelly, uma aplicação de etiquetas de envio para pequenas lojas online. Página inicial com uma caixa de pesquisa grande e seis categorias (Primeiros passos, Impressão de etiquetas, Transportadoras, Faturação, Devoluções, Resolução de problemas). Os artigos têm título, resumo, corpo em Markdown com imagens e destaques, categoria, etiquetas, estado (rascunho, publicado, arquivado), responsável e data da última revisão. As páginas de artigo mostram um índice, artigos relacionados e uma pergunta "Foi útil?" com sim/não e um comentário opcional. A pesquisa cobre títulos, resumos e corpos, com as correspondências no título em primeiro lugar, e regista cada consulta e se devolveu resultados. Uma área de editor (com início de sessão, funções de editor e administrador) lista rascunhos, artigos não revistos há 180 dias e artigos com pontuações de utilidade baixas, e mantém o histórico de revisões. Cada artigo tem o seu próprio título de página e meta descrição para os motores de pesquisa. Design limpo, calmo e legível. Pensado primeiro para o telemóvel.

Passos de construção

1. Liste os primeiros 20 a 30 artigos a partir de perguntas reais de suporte, antes de construir seja o que for. Essa lista define as categorias.
2. Gere o site e verifique a leitura num telemóvel — comprimento das linhas, títulos, imagens.
3. Editor e funções. Os redatores precisam de acrescentar e corrigir artigos sem pedir a um programador.
4. Pesquisa, e depois teste-a com as palavras que os clientes realmente usam, incluindo erros de escrita.
5. Feedback e registo de pesquisas.
6. Relatório de artigos desatualizados com base no responsável e na data da última revisão.
7. Fundamentos de SEO para um site público: títulos e descrições únicos, URLs limpos, um sitemap. Veja SEO para sites criados com IA.
8. Ligue-a ao seu produto e às suas respostas de suporte, e depois acompanhe semanalmente o registo de pesquisas sem resultados.
9. Respostas com IA, quando o conteúdo estiver sólido.

Erros comuns

• Organizar por departamento em vez de pelo que o leitor está a tentar fazer.
• Artigos longos que cobrem cinco tarefas. Uma tarefa por artigo, com um título que diga que problema resolve.
• Nenhum responsável por artigo. Ninguém atualiza nada, e a confiança cai após a primeira resposta errada.
• Notas internas em artigos públicos. Use visibilidade separada e reveja antes de publicar.
• Pesquisa que só corresponde a títulos. Os leitores escrevem sintomas, não nomes de artigos.
• Capturas de ecrã sem texto alternativo ou contexto. Envelhecem depressa; descreva também o passo por palavras.

Quando um produto pronto é a melhor escolha

Se a sua equipa já trabalha numa ferramenta de documentação ou wiki, uma base de conhecimento interna lá é normalmente o caminho de menor resistência — a nossa comparação entre Notion e Confluence aborda duas escolhas comuns. Se usa um produto de helpdesk, o centro de ajuda incorporado liga os artigos aos tickets e sugere artigos aos clientes, o que é difícil de reproduzir. Os geradores de sites de documentação são ideais para documentação de programadores mantida junto ao código.

Construa a sua própria quando precisar de estrutura ou permissões próprias (artigos por cliente, por local, por função), quiser a base de conhecimento dentro do seu produto em vez de num site separado, precisar de passos de revisão e aprovação que uma wiki não impõe, ou quiser respostas com IA sobre o seu conteúdo sem outra subscrição. Combina naturalmente com um helpdesk personalizado.

Construir com a Mythex

Na Mythex, descreve a base de conhecimento no chat e ela é construída numa pré-visualização em direto; os artigos, as revisões e o feedback são guardados numa base de dados Postgres que o agente acrescenta quando necessário, e as imagens vão para o armazenamento de ficheiros do projeto. Os inícios de sessão dos editores usam uma abordagem de autenticação que escolhe, já que a Mythex não tem um início de sessão de utilizador final incorporado. Para as respostas com IA, usa a chave de API do seu próprio fornecedor de IA guardada como segredo do projeto, e o consumo é faturado na sua conta do fornecedor e não em créditos Mythex (receita de IA). As novas aplicações Mythex são por omissão uma aplicação React de página única renderizada no cliente, o que é mais fraco para os motores de pesquisa; por isso, para um centro de ajuda público, peça uma configuração compatível com sites estáticos ou renderizada no servidor, como Next.js (receita de SEO).

Para um prompt inicial, experimente os modelos hub de conhecimento do produto ou aplicação de documentação de equipa.

Perguntas