Wiki e Grafo de Conhecimento

Introdução

A Wiki do Sutram é uma camada de conhecimento sobre o seu projeto. Enquanto a aba Conteúdo organiza arquivos e pastas (e pode dar acesso ao conteúdo governado), a Wiki organiza ideias e como elas se conectam: conceitos, temas e documentos viram nós ligados entre si por menções e relações, formando um grafo de conhecimento navegável.

Mais do que uma enciclopédia interna, a Wiki é a memória estruturada do projeto — a base que permite tanto à sua equipe quanto a assistentes de IA encontrarem, entenderem e conectarem o que já foi produzido, sem depender de quem "estava lá quando aquilo foi decidido".

Quando usar a Wiki

A Wiki agrega valor quando o projeto tem:

Conhecimento que se acumula ao longo do tempo — decisões, conceitos e definições que precisam ser reencontrados meses depois
Muitos documentos que se referenciam — normas que alteram outras, laudos que citam exames, especificações que dependem de desenhos e outras especificações
Vários participantes — pessoas que entram e saem durante o projeto e precisam entender o contexto rapidamente
Uso de IA — quando você quer que um assistente responda perguntas ancorado (guard-rails) no material real do projeto

Se o seu projeto é apenas um repositório de arquivos sem relações entre eles, a aba Conteúdo já basta; a Wiki entra quando a ontologia e as conexões importam.

Requisito: A Wiki é um recurso dos planos pagos (a partir do Pro) e precisa ser habilitada pelo proprietário nas configurações do projeto.

Conceitos Principais

Nó de Wiki (WikiNode)

O nó é a unidade da Wiki: uma entidade referenciável que representa um conceito, um tema ou um documento. Diferente de um arquivo, um nó não guarda bytes — ele guarda significado: um nome, um slug (identificador curto), uma síntese opcional e metadados.

Há dois tipos principais de nó:

Tipo	O que é	Como surge
Nó-conceito	Uma ideia ou tema (ex.: "Onboarding de clientes", "Bioequivalência")	Criado deliberadamente (via IA/MCP) ou como stub quando é mencionado antes de existir
Nó-espelho de documento	O reflexo de um Record do projeto na Wiki	Gerado pela IA a partir dos Records; carrega o texto do documento extraído dos arquivos do documento (PDF, Office, etc.)

Menções `[[slug]]`

Uma menção é uma referência a outro nó, escrita como [[slug]] dentro do texto de um nó. Ela vira um link clicável na página do nó (ou acessível diretamente pela IA). Você também pode exibir um rótulo diferente do slug com [[slug|texto exibido]].

Quando você menciona algo que ainda não existe, a menção fica pendente (marcada como quebrada) e cria um stub — um nó-fantasma que passa a resolver assim que o alvo real é criado. Isso permite construir a rede de forma incremental, citando conceitos antes de documentá-los.

Backlinks

O backlink é o inverso da menção: se o nó A menciona o nó B, então A aparece nos backlinks de B — o painel "Mencionado em". É assim que você descobre todos os lugares onde um conceito aparece no projeto, sem procurar arquivo por arquivo. Cada nó exibe sua contagem de backlinks.

Relações tipadas

Uma menção simples diz "A cita B". Uma relação tipada diz como A se relaciona com B: regulamenta, revoga, altera, depende de, e assim por diante. O rótulo aparece na aresta do grafo e dá semântica às conexões — transformando uma lista de links numa rede com significado.

Síntese × Texto integral

Cada nó pode ter dois níveis de conteúdo:

Síntese — um resumo curado, editorial, do que o nó representa (o "verbete").
Texto integral — nos nós-espelho, o conteúdo completo do documento de origem, indexado para busca.

A busca da Wiki cobre os dois, então uma pergunta encontra tanto o resumo quanto o corpo do documento.

O Grafo de Conhecimento

Quando os nós se conectam por menções e relações, eles formam um grafo — visível na seção Grafo da Wiki. Ali você vê os nós como pontos e as relações como linhas rotuladas, e pode:

Buscar e filtrar por nome ou tipo de nó
Abrir um nó para ler sua síntese e seguir suas conexões
Explorar a vizinhança de um nó pelo ego-graph (o grafo radial centrado nele)
Reorganizar o layout e navegar por agrupamentos (clusters) de temas relacionados

O grafo não é decorativo: é uma forma de enxergar a estrutura do conhecimento do projeto — quais conceitos são centrais, o que está isolado, como as coisas se ligam.

A Wiki como memória para IA

A Wiki foi desenhada para ser a fonte que um assistente de IA consulta ao responder sobre o projeto. O fluxo típico é:

Perguntar — a IA faz uma busca full-text na Wiki a partir da sua pergunta
Ler — abre os nós mais relevantes, com síntese e texto integral
Navegar — segue menções e backlinks para reunir o contexto ao redor
Responder — sintetiza a resposta ancorada nas fontes encontradas

É isso que diferencia a Wiki do Sutram de um chatbot genérico: as respostas vêm do material real do seu projeto, com rastro até os documentos de origem. Para o passo a passo de como uma IA opera a Wiki, veja o Guia do Sutram MCP Server.

Wiki, Conteúdo e Records

A Wiki não substitui a aba Conteúdo — ela a complementa:

Camada	Guarda	Responde
Conteúdo	Arquivos e pastas	"Onde está o arquivo X?"
Records	Dados estruturados com metadados	"Quais documentos da categoria Y?"
Wiki	Conceitos, relações e sínteses	"O que é X e como se conecta a Y?"

Os Records alimentam a Wiki: cada Record pode ter um nó-espelho que traz seu texto para a busca e para o grafo. O espelhamento é feito por um assistente de IA via MCP — não acontece sozinho. Assim, o que você organiza como dado estruturado também vira conhecimento navegável.

Papéis e Permissões

O acesso à Wiki segue as funções do projeto:

Ação	Proprietário / Admin	Membro	Visualizador
Navegar, buscar e ler nós	Sim	Sim	Sim
Explorar o grafo e os backlinks	Sim	Sim	Sim
Criar e editar nós, síntese e relações	Sim	Sim	Não

A leitura da Wiki está disponível a qualquer participante do projeto, inclusive visualizadores. A escrita (criar/editar nós, definir relações) segue as funções de edição e é feita via assistente de IA / MCP Server.

Boas Práticas

Deixe o conhecimento emergir dos documentos (bottom up) — comece espelhando Records na Wiki; a rede cresce à medida que os textos se citam.
Nomeie conceitos de forma estável — o slug é o endereço do nó; nomes consistentes evitam duplicatas e menções quebradas.
Prefira relações tipadas onde o "como" importa — "revoga", "depende de" dizem muito mais que uma simples menção.
Use menções mesmo para o que ainda não existe — a menção pendente vira um lembrete visível de que aquele conceito precisa ser documentado.
Escreva sínteses curtas e objetivas — o verbete é um ponto de partida, não uma cópia do documento; o texto integral já cobre o detalhe.

Perguntas Frequentes

P: Qual a diferença entre a Wiki e a aba Conteúdo?

R: Conteúdo guarda pastas, arquivos e links; a Wiki guarda conceitos e conexões. Conteúdo responde "onde está o arquivo?"; a Wiki responde "o que é isto e como se relaciona com o resto?". As duas convivem — Records da aba Conteúdo alimentam nós-espelho na Wiki.

P: Quem constrói e mantém a Wiki?

R: Os assistentes de IA, via o MCP do Sutram. Toda a manutenção da Wiki — criar nós-espelho a partir dos Records, escrever nós-conceito e sínteses, definir relações tipadas, sincronizar o texto dos documentos — é feita por um assistente conectado ao projeto. Nada disso é criado sozinho pelo sistema, e a interface web não oferece essa funcionalidade: ela é o lugar de navegar, buscar e ler. Na prática, você conversa com o assistente e ele constrói a rede; depois, qualquer participante consulta o resultado pela interface.

Uma exceção parcial: as menções [[slug]] escritas no corpo de um nó criam stubs para conceitos ainda não documentados — mas isso também só acontece quando o nó é gravado via MCP.

P: O que é uma menção "pendente" ou "quebrada"?

R: É uma menção [[slug]] cujo alvo ainda não existe. Ela fica marcada como quebrada e cria um nó-fantasma (stub); quando o alvo real é criado, a menção passa a resolver normalmente.

P: Posso editar a Wiki pela interface web?

R: A interface web é voltada para navegar, buscar e visualizar o grafo e os nós. A criação e a edição de nós, sínteses e relações são feitas via o Sutram MCP Server (por um assistente de IA). Visualizadores podem navegar, mas não editar.

P: A busca da Wiki cobre o conteúdo dos documentos?

R: Sim. Nos nós-espelho, o texto integral do documento é indexado, então uma busca encontra tanto a síntese quanto o corpo do documento original.

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