Construindo sua Wiki | Sutram Blog

Este guia mostra, na prática, como a Wiki do seu projeto é construída e como navegá-la. Diferente de outras seções, a Wiki não é preenchida por um formulário de "novo item": ela é construída por um assistente de IA conectado ao projeto e lida e navegada pela interface. Ao final, você saberá habilitar a Wiki, entender como os nós e as ligações se formam, enriquecer a rede com conceitos e relações, e explorar o grafo de conhecimento.

Antes de começar: A Wiki requer um plano pago (a partir do Pro) e precisa estar habilitada no projeto. Você também vai precisar de um assistente conectado via MCP — veja Conectando o Sutram ao Claude. Se ainda não leu, comece pelo conceito em Wiki e Grafo de Conhecimento.

Passo 1: Habilitar a Wiki no projeto

A Wiki só aparece depois de ser ativada pelo proprietário:

Como proprietário ou administrador do projeto, abra as configurações do projeto
Ative a opção Wiki
O card Wiki passa a aparecer na página inicial do projeto

Passo 2: Entenda como a Wiki é construída

A Wiki não se preenche sozinha, e a interface web não tem formulário de "novo nó": toda criação e edição de nós passa pelo Sutram MCP Server, ou seja, por um assistente de IA conectado ao projeto. A interface é onde você navega, busca e lê o que foi construído.

O que se forma a partir daí:

Nós-espelho de Records — quando você pede para espelhar um Record, o assistente cria o nó correspondente e copia o texto integral do documento para dentro dele, trazendo esse conteúdo para a busca e para o grafo.
Nós-conceito — páginas de conceito ou de síntese que não correspondem a um arquivo, criadas sob demanda. Ao criar, o Sutram compara o nome com o catálogo do projeto e reaproveita um nó parecido em vez de duplicar.
Menções criam a rede — quando o texto de um nó usa [[slug]] para citar outro, essa ligação vira uma aresta do grafo. Citações a algo que ainda não existe viram stubs (nós-fantasma) e ficam registradas como pendências visíveis; assim que o alvo é criado com aquele slug, a menção passa a resolver sozinha.

Ou seja: você guia a construção conversando com o assistente, e a estrutura emerge das ligações.

Passo 3: Enriqueça com conceitos, sínteses e relações (via IA)

Na prática, a criação de nós-conceito, a redação de sínteses e a definição de relações tipadas são feitas pedindo ao assistente de IA conectado ao projeto pelo Sutram MCP Server (por exemplo, o Claude). Alguns exemplos do que você pode pedir:

"Crie um nó de wiki para o conceito 'Onboarding de clientes' com uma síntese do nosso processo."
"Ligue este documento ao nó 'Política de Reembolso' com a relação 'depende de'."
"Traga o texto integral deste Record para o nó-espelho correspondente, para entrar na busca."

Nos bastidores, o assistente usa as ferramentas de Wiki do MCP — criar e atualizar nós, definir menções e relações tipadas, e sincronizar o texto-fonte. A referência completa dessas ferramentas está no Guia do Sutram MCP Server.

Dica: comece pedindo à IA para espelhar os Records mais importantes e escrever sínteses curtas. Depois evolua para relações tipadas onde o "como" das conexões importa.

Passo 4: Navegue pela Wiki

Abra o card Wiki na página inicial do projeto. Ela tem três seções:

Conceitos — a lista dos nós-conceito (e nós de orientação), cada um com sua contagem de backlinks
Documentos — os nós-espelho dos documentos do projeto
Grafo — a visualização das relações entre os nós

Clique em qualquer nó para abrir sua página. Nela você encontra:

A síntese do nó, com as menções [[slug]] renderizadas como links clicáveis (as pendentes aparecem marcadas como quebradas)
O texto integral, quando o nó espelha um documento
O ego-graph — um mapa radial da vizinhança imediata do nó
O painel de relações e os backlinks ("Mencionado em"), para saltar para tudo que se conecta a ele

Passo 5: Explore o grafo

Na seção Grafo, você vê o conhecimento do projeto como uma rede:

Busque ou filtre por nome ou tipo de nó para focar no que interessa
Clique num nó para abri-lo ou ver suas relações
Navegue pelos agrupamentos (clusters) para descer a temas relacionados
Reorganize o layout arrastando os nós, e salve ou descarte a disposição

Use o grafo para responder perguntas que uma lista não responde: quais conceitos são centrais? O que está isolado e talvez precise de contexto? Como duas áreas do projeto se conectam?

Dicas de Curadoria

Nomes estáveis — o slug é o endereço do nó; padronize nomes para evitar duplicatas e menções quebradas.
Sínteses enxutas — o verbete orienta; o detalhe já está no texto integral do documento.
Menções antecipadas — cite um conceito com [[slug]] mesmo antes de documentá-lo; a pendência vira um lembrete visível.
Relações com verbo — "revoga", "altera", "depende de" contam uma história que um link solto não conta.
Revise os pendentes — menções quebradas são um bom mapa do que ainda falta documentar.

Perguntas Frequentes

P: Não uso IA. Ainda assim tenho uma Wiki?

R: Não. Hoje a única forma de adicionar ou modificar nós da Wiki é pelo Sutram MCP Server — a interface web não oferece essa funcionalidade. Sem um assistente conectado, a Wiki permanece vazia. Depois de construída, porém, qualquer participante navega, busca e lê tudo pela interface, sem precisar de IA.

P: Como faço para criar um nó-conceito sem IA?

R: Não é possível pela interface. Conecte um assistente de IA ao projeto (veja Conectando o Sutram ao Claude) e peça a criação do nó — é por esse caminho que a Wiki é construída e curada.

P: Por que um nó aparece "quebrado" ou vazio?

R: É um stub — um nó criado por uma menção a algo que ainda não foi documentado. Assim que o alvo real (um Record ou um nó-conceito) é criado com aquele slug, a menção passa a resolver e o nó ganha conteúdo.

P: Quem pode construir e quem pode só ler a Wiki?

R: Navegar, buscar e ler está aberto a qualquer participante, inclusive visualizadores. Criar e editar nós, sínteses e relações exige função de edição (Proprietário, Administrador ou Membro).

Próximos Passos

Records e Metadados — como estruturar os dados que alimentam os nós-espelho da Wiki
Guia do Sutram MCP Server — a referência das ferramentas de Wiki usadas pelo assistente de IA
Wiki e Grafo de Conhecimento — o conceito por trás do que você acabou de construir

Versão do Documento: 1.0 Última Atualização: Julho de 2026 Autor: Equipe de Desenvolvimento Sutram