---
title: "Tipos de nota"
description: "A classe de uma nota é um conjunto de políticas de visibilidade e indexação que o sistema infere de onde ela é armazenada — não um campo livre."
---

# Tipos de nota

Toda nota tem uma **classe** — ela define onde a nota fica visível e como é indexada. A classe não é um rótulo livre no frontmatter que você preenche na mão: é um conjunto de políticas que o sistema **infere a partir de onde a nota é armazenada e aplica por conta própria**. Em uma resposta da API, a classe é somente leitura.

## A classe é um conjunto de políticas

Por trás de cada classe há um conjunto de políticas — sim/não para cada uma: se a nota é indexada, se aparece no grafo, no Feed, na árvore, na busca voltada ao usuário, se está disponível ao `recall` de um agente, se é versionada, se é replicada. O ponto central: a visibilidade é verificada em um único lugar, não por um filtro que você precisa lembrar de acrescentar a cada consulta. "Ocultar dos resultados" e "excluir do índice" são coisas diferentes, e o Notarium nunca as confunde.

A identidade de uma nota é seu `notarium-id`, não seu caminho. É por isso que mover ou renomear a nota nunca altera a classe silenciosamente nem quebra os índices.

## O registro de classes

| Classe | Status | Visibilidade |
|---|---|---|
| `user-doc` | ativa | Visível em todo lugar: árvore, Feed, grafo, busca. A classe padrão para todo o conteúdo do usuário. |
| `agent-memory` | ativa | Indexada e disponível ao `recall` de um agente, mas oculta das superfícies voltadas ao usuário; visível ao dono em uma seção à parte. |
| `attachment` | carrega políticas | Anexos são dados de pleno direito, mas não são indexados como conhecimento: só arquivos `.md` são pesquisáveis. |
| `derived` | carrega políticas | Artefatos regeneráveis (pré-visualizações, renders); não chegam ao índice. |
| `profile` | ativa | Oculta em todo lugar onde você busca e navega por notas; acessível apenas via Settings → Profile e ao agente em `start_session`. |

## As duas classes com que você trabalha

Na prática, duas classes permanecem ativas e continuam se enchendo.

**`user-doc`** — suas notas. A classe padrão: organizadas livremente na árvore, alimentando a busca, o grafo e o Feed. É exatamente para cá que escrevem tanto a pessoa (pelo editor) quanto o agente (via `create_note`).

**`agent-memory`** — a memória do agente. São notas legíveis, não um armazenamento oculto: o agente anexa observações a um arquivo por categoria, em vez de gerar microarquivos. A memória vive em uma pasta de serviço à parte, `.notarium/memory/`, para não se misturar com a sua árvore nem colidir com as suas pastas.

> [!note] A memória é visível para você, mas pertence ao agente
> Você **lê, edita e apaga** o conteúdo da memória — é assim que audita e controla o que pode ter chegado ao contexto (o histórico mostra quem escreveu o quê). Mas você não a **reorganiza**: o arranjo pertence ao agente (um conjunto plano de categorias mais um índice derivado). Mover coisas é tecnicamente seguro — a proibição de reorganizar é uma decisão de produto, para que o modelo de memória permaneça previsível.

O índice de memória é derivado: ele é montado a partir do campo `summary` de cada arquivo de memória e reconstruído com uma nova varredura completa. Ele carrega de imediato no `start_session`, enquanto os próprios arquivos são trazidos sob demanda pelo `recall`. Mais em [Memória do agente](/docs/agents/memory/).

## `profile` — "sobre você"

Uma classe dedicada à nota de perfil: conteúdo escrito por humano sobre você (escrito por você, não pelo agente). Ela fica oculta em todo lugar onde você busca e navega por notas, e só pode ser alcançada de duas formas — via Settings → Profile e fazendo o `start_session` carregá-la no contexto do agente por identificador. Isto não é a memória do agente; é um cartão de contexto que você mesmo cura.

A classe é inferida a partir de onde a nota é armazenada e definida pelo sistema — o agente não escolhe nem a pasta nem a classe. Para saber como isso se conecta ao isolamento e ao endereçamento, veja [Espaços e projetos](/docs/concepts/spaces-and-projects/).