---
title: "Типы заметок"
description: "Класс заметки — это набор политик видимости и индексации, который система выводит из места хранения и применяет сама, а не свободное поле."
---

# Типы заметок

У каждой заметки есть **класс** — он задаёт, где заметка видна и как индексируется. Класс — это не свободная метка во frontmatter, которую можно проставить руками: это набор политик, который система **выводит из места хранения и применяет сама**. В API-ответе класс — признак только для чтения.

## Класс — это набор политик

За классом стоит набор политик — да/нет по каждой: индексируется ли заметка, попадает ли в граф, ленту, дерево, пользовательский поиск, доступна ли `recall` агента, версионируется ли, реплицируется ли. Главное: видимость проверяется в одном месте, а не фильтром, который надо не забыть добавить в каждый запрос. «Спрятать в выдаче» и «исключить из индекса» — разные вещи, и Notarium не путает их.

Идентичность заметки — `notarium-id`, а не путь. Поэтому перенос или переименование не меняют класс молча и не рвут индексы.

## Реестр классов

| Класс | Статус | Видимость |
|---|---|---|
| `user-doc` | живой | Виден везде: дерево, лента, граф, поиск. Класс по умолчанию для всего пользовательского контента. |
| `agent-memory` | живой | Индексируется и доступен `recall` агента, но скрыт из пользовательских поверхностей; виден владельцу отдельной секцией. |
| `attachment` | несёт политики | Вложения — полноценные данные, но как знание не индексируются: в поиск попадают только `.md`-файлы. |
| `derived` | несёт политики | Регенерируемые артефакты (превью, рендеры); в индекс не попадают. |
| `profile` | живой | Скрыт отовсюду, где вы ищете и просматриваете заметки; доступен только через Settings → Profile и агенту в `start_session`. |

## Два класса, с которыми вы работаете

На практике живут и наполняются два класса.

**`user-doc`** — ваши заметки. Класс по умолчанию: свободно организуется в дереве, попадает в поиск, граф и ленту. Именно сюда пишет и человек через редактор, и агент через `create_note`.

**`agent-memory`** — память агента. Это читаемые заметки, а не скрытая база: агент дозаписывает наблюдения в файл-на-категорию, а не плодит микрофайлы. Память хранится в отдельной служебной папке `.notarium/memory/`, поэтому не смешивается с вашим деревом и не конфликтует с вашими папками.

> [!note] Память видна вам, но принадлежит агенту
> Вы **читаете, правите и удаляете** содержимое памяти — это ваш аудит и контроль над тем, что могло попасть в контекст (в истории видно, кто и что записал). Но вы её **не реорганизуете**: раскладкой владеет агент (плоский набор категорий плюс производный индекс). Перенос безопасен технически — запрет реорганизации продуктовый, чтобы модель памяти оставалась предсказуемой.

Индекс памяти — производный: он собирается из поля `summary` каждого memory-файла и пересобирается полным повторным сканированием. Он загружается сразу в `start_session`, а сами файлы подтягиваются по запросу через `recall`. Подробнее — [Память агента](/docs/agents/memory/).

## `profile` — «о себе»

Отдельный класс для заметки-профиля: человеческий контент о вас (написали это вы, а не агент). Он скрыт отовсюду, где вы ищете и просматриваете заметки, и достаётся только двумя путями — через Settings → Profile и загрузкой агенту в `start_session` по идентификатору. Это не память агента, а курируемая вами карточка контекста.

Класс выводится из места хранения и задаётся системой — агент не выбирает ни папку, ни класс. Как это связано с изоляцией и адресацией, см. [Пространства и проекты](/docs/concepts/spaces-and-projects/).