---
title: "Аудит извлечения"
description: "Раздел Agents → Audit: что агент реально искал и открывал, нашёл ли, и где его слепые зоны — рекуррентные запросы без результата."
---

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

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

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

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

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

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

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

## Слепые зоны

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

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

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

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

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

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

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

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

## Дальше

- [Контекст-наборы и пины](/docs/agents/context-pins/) — что грузится заранее; аудит показывает, что достаётся по запросу.
- [Память агента](/docs/agents/memory/) — что именно ищут `search` и `recall`.
- [Безопасность и видимость](/docs/agents/security/) — почему логи чтения видны только владельцу.