Керувати пам’яттю робочого простору

Цей посібник показує, як працювати зі сховищем знань робочого простору.

Важливо знати перед початком: інтерфейс пам’яті — це поверхня перегляду, а не авторства. Факти й політики пишуть агенти — через propose_fact і propose_policy, а для заміни — через supersede_fact і supersede_policy. remember записує елемент гарячого рівня, обмежений сеансом, який consolidate_memory згодом може піднести до факту. Рішення із записаних зустрічей збираються в домен decisions; на завершених запусках агентів такого збору немає. Усе, що ви робите тут, — це читаєте те, що вони написали, виправляєте, деактивуєте або видаляєте.

Пам’ять живе за адресою Налаштування → Робочий простір → Пам’ять (/workspaces/<id>/settings/memory). Це не пункт верхнього рівня на бічній панелі.

Три вкладки

На сторінці рівно три вкладки. Факти й Політики показують актуальну кількість наживо; граф — ні:

Факти — кожен факт робочого простору, з лічильником тих, які не замінено
Політики — нормативні правила, згруповані за доменами, з лічильником активних
Граф знань — інтерактивне полотно з доменів, тем, фактів і політик

Домени не створюють вручну. Домен з’являється, коли агент записує в нього перший факт або політику; у жодному місці інтерфейсу немає елемента для створення домену.

Переглянути й виправити факт

Відкрийте вкладку Факти.
Скористайтеся полем пошуку, щоб звузити список. Це звичайний фільтр за підрядком по домену, темі й вмісту кожного факту — без індексу ключових слів і без ранжування.
Скористайтеся фільтром областей, щоб показати всі області, лише факти на весь робочий простір або факти одного репозиторію.
Скористайтеся перемикачем сортування, щоб упорядкувати за свіжістю або за впевненістю.
Натисніть елемент редагування факту.

У діалозі редагування можна змінити:

Домен — перенесення факту між доменами
Тема — її коротка назва
Вміст — текст знання
Упевненість — повзунок із кроком 5%

Натисніть Зберегти, щоб записати зміни назад. Кнопки Додати факт немає; діалог відкривається лише для наявного рядка.

Переглянути замінені факти

На вкладці Факти є перемикач Показувати замінені. Замінені факти приховані за замовчуванням і показуються цим перемикачем; саме тут живе журнал аудиту — заміщення ніколи не видаляє.

Видалити факт

Скористайтеся елементом видалення факту й підтвердьте. Це справжнє видалення, а не заміщення: вдавайтеся до нього для фактів, які просто не варто було записувати, а факти, чий вміст змінився, хай заміщують агенти.

Керувати політиками

Вкладка Політики групує активні політики за доменами, а неактивні виносить в окремий розділ унизу. Для кожної політики можна:

Редагувати її
Видалити її
Деактивувати / Активувати її — оборотний варіант, і зазвичай саме він правильний. До промптів агентів потрапляють лише активні політики.

Як і у випадку з фактами, елемента створення немає.

Дослідити граф знань

Вкладка Граф знань розкладає домени, теми, факти й політики як полотно вузлів, яким можна навігувати, — пересування, масштабування, перетягування вузлів. Дотик до вузла відкриває панель подробиць, з якої доступні ті самі діалоги редагування. Це найшвидший спосіб побачити, які домени справді наповнені.

Редагувати робочу пам’ять агента

Робоча пам’ять — це приватна чернетка кожного агента, яка вставляється в його промпт під час диспетчеризації. Агенти пишуть її самі через record_observation і update_my_notes, але ви можете читати й редагувати її безпосередньо:

Налаштування → Робочий простір → Агенти → виберіть агента → вкладка Пам’ять.

Дозволи доступу

Дозволи доступу до пам’яті зіставляють роль агента з дозволом (none, read, write) для кожного домену. Записують їх операціями memory_access_grant.*.

Дві речі, які варто розуміти про те, як вони діють:

Читання відкриті за замовчуванням. Якщо для пари (роль, домен) немає рядка дозволу, чинний дозвіл — read. Єдиний запис, який спричиняє помилку без write, — це propose_policy. Запис фактів не потребує дозволу.
Дозволи прив’язані до ролі агента. Інструменти пропонування підставляють general за замовчуванням, якщо agent_role відсутня. Дозвіл, записаний для іншої ролі, на цих агентів не поширюється; дозвіл для general — поширюється.

Пошук не скрізь однаковий

Три різні речі називають «пошуком у пам’яті», і вони не збігаються:

Де	Що це робить
Поле пошуку на вкладці Факти	Фільтр за підрядком по фактах, уже завантажених у клієнт
RPC-операція `memory_fact.search`	Лише пошук за ключовими словами через FTS5 — тонкий клієнт не може надіслати вектор запиту, тож гібридний пошук залишається внутрішнім для хоста
Інструмент `search_memory` на боці агента	`keyword`, `semantic` або `hybrid` (типовий). Гібридний поєднує чотири голоси: лексичний, семантичний, часовий і графовий

Тож агент і сторінка пам’яті ранжуватимуть той самий запит по-різному. Якщо перевіряєте, що агент насправді може пригадати, — спитайте агента.

Векторні подання

Факти отримують вектор під час запису і лише тоді, коли встановлено локальну модель векторних подань. Перевірте її стан у Налаштування → Сервер → Діагностика та приватність → Семантичний пошук. Якщо вам потрібне семантичне пригадування, встановіть модель до того, як агенти почнуть писати в пам’ять.