NotariumДокументация
Версия документации: latest
RU

Аудит извлечения

Конструктор контекста определяет, что грузится в агента заранее, на старте. Аудит — его двойник во время работы: он показывает, что агент реально ищет (search / recall) и открывает (get_note), и нашёл ли. Это важно потому, что доминирующий режим отказа памяти — не «факта нет», а сбой извлечения: нужная заметка есть, но запрос её не достаёт. Без наблюдаемости груминг памяти превращается в гадание.

Раздел живёт в Agents → Audit.

Что попадает в лог

Каждый вызов читающего инструмента (search, recall, get_note) дописывает строку в лог: что искали (query, scope, class) и что нашли (топ-хиты с noteId, title, score, class + число результатов). Захват идёт в фоне — он не влияет ни на задержку, ни на корректность ответа агенту.

Пишущие инструменты (create_note, remember_*, edit_note) в аудит извлечения не логируются — их провенанс живёт в журнале ревизий. Аудит — про чтение.

Каждая строка помнит и имя агента — дружелюбное имя токена или приложения (например, CLI или Claude), захваченное пока токен жив. Так строка навсегда помнит, какой именно агент делал запрос.

Слепые зоны

Главный сигнал аудита — рекуррентные запросы без результата. Единичный пустой поиск — норма (агент проверил гипотезу). А вот запрос, который раз за разом не находит ничего, — это слепая зона: агенту нужен факт, которого в памяти нет или который лежит под неудачным заголовком. Это прямое указание, что дозаписать или как переформулировать.

Интерфейс сводит это в две панели:

  • Blind spots — рекуррентные пустые запросы (порог: два и более без результата), подсвечены жёлтым/янтарным.
  • Frequent — самые частые запросы.

Плюс лента истории (свежее сверху) с фильтром по инструменту (All / Search / Recall / Open): значок инструмента, сам запрос, имя агента, метка класса/категории, проект (только при сужении), число результатов и время. Раскрытие строки показывает найденные хиты — они кликабельны и ведут к заметкам.

Пустой результат

Аудит надёжно ловит именно пустой результат. Случай «релевантное есть, но не попало в топ» требует прогона запроса против памяти — это отдельный, более тонкий сигнал, которого аудит не показывает.

Приватность и охват

Лог виден только владельцу: вы видите извлечение своих агентов, привязанное к вашему имени пользователя. Поскольку зритель — владелец, имя своего агента показывается без редакции. Аудит охватывает все ваши пространства сразу — у строки нет одного домашнего пространства.

Когда извлечение не логируется

Аудит хранится в служебной БД. Хост без служебной БД (например, режим none без базы) извлечение не логирует — раздел просто остаётся пустым, без ошибки.

Дальше