Conceitos

O modelo mental por trás das tools. Entender isso muda como o agente usa o Memorax — de “busca plana” para “navegar um grafo de conhecimento”.

A wiki é um grafo

O conhecimento de cada projeto vive como uma wiki interligada por wikilinks ([[assim]]) — não um monte de documentos soltos. Cada página aponta para outras e é apontada por outras, formando um grafo. O diferencial do Memorax está justamente nessas conexões: o agente não precisa adivinhar relações, ele as segue.

Projetos e escopo

Todo conhecimento pertence a um projeto. Cada credencial (chave ou conexão OAuth) é escopada aos projetos que o dono autorizou — e a uma organização por credencial. Participa de mais de uma? Crie uma credencial por organização: elas funcionam ao mesmo tempo, cada uma no endereço da sua organização. Toda chamada exige um projectId desse conjunto; fora dele, a resposta é 403. Descubra os projetos do seu token com GET /api/v1/me (ou memorax whoami).

Tipos de página

Cada página tem um tipo, útil pra filtrar em listar_paginas:

• concept — um conceito ou ideia.
• entity — pessoa, empresa, produto, etc.
• source — um documento-fonte ingerido.
• question — uma pergunta em aberto.
• meta — páginas de índice/organização (ex.: index, log).

O padrão grafo-aware

A forma recomendada de usar as tools, em sequência:

• buscar — acha páginas relevantes (devolve trechos + score, não o conteúdo inteiro).
• ler_pagina — lê por completo o melhor resultado (única tool que devolve o markdown).
• relacionadas — segue o grafo (o que a página cita e quem a cita) pra montar contexto — quase sempre melhor que buscar de novo.
• listar_paginas — inventaria por tipo/tag quando você quer a visão ampla.

É esse padrão que a nossa skill ensina ao agente — e que já vai no instructions do servidor MCP.