Busca e descoberta de conteúdo

Conforme um projeto cresce, encontrar o que você precisa importa tanto quanto guardar. O Sutram oferece formas complementares de descoberta — por tag, por conhecimento (full-text na Wiki), por menção e por navegação. Este guia mostra qual usar em cada situação.

Escolha o método certo

Você sabe…	Use
Uma tag (categoria, autor, ano, paciente…)	Busca por tag, na aba Conteúdo
O assunto ou tem uma pergunta	Busca full-text na Wiki
O slug de uma menção `[[slug]]`	Resolver a menção
Onde o item fica na estrutura	Navegação por pastas

Buscar por tag (itens e pastas)

Tags são metadados chave-valor. A busca por tag é a forma estruturada de filtrar o acervo.

Na aba Conteúdo, abra a busca por tag
Informe uma chave (ex.: categoria) e, opcionalmente, um valor (ex.: contrato)
Para refinar, some várias condições — todas precisam ser satisfeitas (lógica E)

Como a correspondência funciona:

Chave: correspondência exata, sem distinção de maiúsculas/minúsculas (Categoria = categoria)
Valor: correspondência por trecho, sem distinção de maiúsculas/minúsculas (neuro encontra Neurologia)
Sem valor: retorna qualquer item que possua aquela chave, independentemente do valor

Os resultados trazem itens e pastas que batem; a partir deles você navega direto ao conteúdo.

Buscar conhecimento na Wiki (full-text)

Quando você não sabe a tag, mas sabe o assunto — ou tem uma pergunta —, a Wiki é o caminho. A busca da Wiki é full-text sobre o conteúdo: ela cobre o nome do nó, a síntese curada e o texto integral dos documentos espelhados (com stemming em português), e devolve um trecho destacado por resultado.

O fluxo de descoberta pela Wiki:

Busque a partir da pergunta ou do tema
Abra o nó mais relevante e leia a síntese e o texto integral
Siga as menções [[slug]] e os backlinks para reunir o contexto ao redor
Use o grafo para enxergar como os temas se conectam

Veja Wiki e Grafo de Conhecimento para o conceito completo.

Seguir menções e slugs

Dentro dos textos, referências no formato [[slug]] são links clicáveis. Você pode:

Resolver um slug para chegar ao item que ele aponta
Abrir os backlinks de um item ("Mencionado em") para ver todos os lugares que o citam

É a forma de descobrir conteúdo seguindo as conexões, em vez de buscar por palavras.

Buscar no Conteúdo Governado

O espaço de Conteúdo Governado tem busca própria e respeita o need-to-know: você só encontra as Classes e os documentos que tem permissão de ver, conforme seu papel e o estado de cada documento. Veja Papéis, permissões e need-to-know.

Descoberta com IA (MCP)

Um assistente conectado pelo Sutram MCP Server reúne todos esses caminhos numa conversa: buscar itens e pastas por tag, fazer busca full-text na Wiki, listar nós por nome ou categoria e resolver menções. Exemplos:

"Encontre todos os documentos marcados com categoria = contrato e ano = 2026."
"O que temos sobre política de reembolso? Busque na wiki e resuma com as fontes."
"Para onde aponta a menção [[politica-de-reembolso]]?"

A referência dessas ferramentas está no Guia do Sutram MCP Server.

Dicas

Tag para o estruturado, Wiki para o semântico — filtre por metadados quando souber os campos; pergunte à Wiki quando souber o assunto.
Padronize as tags — valores consistentes (de preferência via enum, em Records) tornam a busca por tag confiável.
Comece amplo, refine depois — busque por uma chave só, veja o volume, e acrescente condições para estreitar.
Siga os backlinks — muitas vezes o que você procura está a um salto de um item que você já encontrou.

Perguntas Frequentes

P: Busquei por tag e não veio nada. O que houve?

R: Confira se a chave existe (busque só pela chave, sem valor, para testar), se não há erro de digitação, e lembre-se de que o valor é por trecho e a chave é exata (ambos ignoram maiúsculas/minúsculas).

P: Qual a diferença entre busca por tag e busca na Wiki?

R: A busca por tag filtra por metadados estruturados (chave-valor) — ideal quando você sabe os campos. A busca na Wiki é full-text sobre o conteúdo — ideal quando você sabe o assunto, não os campos.

P: Consigo buscar pelo conteúdo de dentro dos documentos?

R: Sim, pela Wiki: o texto integral dos documentos espelhados é indexado, então a busca full-text alcança o corpo do documento, não só o título.

Próximos Passos

Wiki e Grafo de Conhecimento — a camada de descoberta por conhecimento
Records e Metadados — como estruturar tags e campos que a busca usa
Guia do Sutram MCP Server — a referência das ferramentas de busca para uso com IA

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