Память (Memory)

Kodik может запоминать факты, договорённости и контекст, которые должны сохраняться между отдельными задачами. Для этого используется инструмент memory, создающий и обновляющий именованные .md-файлы в двух областях хранения.

Как работает инструмент `memory`

Во время выполнения задачи агент может вызвать инструмент memory с тремя параметрами:

Параметр	Описание
`scope`	Область хранения: `workspace` или `global`
`path`	Имя файла памяти (без пути к директории, только имя)
`content`	Содержимое для сохранения (Markdown)

Чтобы удалить запись, агент передаёт параметр delete: "true" вместо content.

Путь — это просто имя файла без директорий. Расширение .md добавляется автоматически, если его нет. Абсолютные пути и символы .. не разрешены.

Области хранения

Память рабочего пространства

Файлы хранятся в .kodik/memories/ в корне текущего проекта. Эта память относится только к данному проекту и может быть добавлена в систему контроля версий.

Пример файла: .kodik/memories/testing-conventions.md

Глобальная память

Файлы хранятся в директории ~/Documents/Kodik/Memories/ (на Windows — в папке «Документы»). Глобальная память доступна во всех проектах и рабочих пространствах.

Загрузка в контекст агента

При каждом запуске задачи Kodik загружает сохранённые файлы памяти в системный промпт. Файлы каждой области помещаются внутрь тега <memory> в начале контекста. Для каждой области существует лимит — не более 200 строк и 50 файлов. Каждый отдельный файл памяти не может превышать 16 КБ.

Поскольку файлы памяти — это обычные .md-файлы, их можно просматривать и редактировать вручную. Kodik также автоматически удаляет значения, похожие на секреты (токены, ключи API), перед записью.

Практические советы

Просите агента сохранить конвенции команды, предпочтения по стилю кода или детали архитектуры в память рабочего пространства — они будут автоматически присутствовать в следующих сессиях.
Используйте глобальную память для личных предпочтений, которые применимы ко всем проектам (например, предпочтительный язык для ответов).
Файлы памяти можно создавать или редактировать вручную — Kodik загрузит их так же, как созданные агентом.
Чтобы проверить, что именно сохранено, откройте .kodik/memories/ в проводнике или ~/Documents/Kodik/Memories/ для глобальной памяти.