Cognitive Core
v?
live PG Redis S3

Песочница API

Прямой доступ ко всем эндпоинтам системы. Карточки сгруппированы по этапам жизненного цикла памяти — от записи сырого события до KNN-поиска по выученным знаниям. Все запросы идут с выбранным API-ключом ниже.

?
Этап 1

Запись опыта в L1 ?

Агент отправляет каждое значимое действие в систему. Это попадает в L1 и ждёт ночной консолидации. Payload — произвольный JSON: что делал, какой результат, какой feedback.

POST

Отправить одно событие

/events

Самый частый вызов. Используется агентами для логирования каждого действия.

POST

Bulk: 5 тестовых событий

/events × 5

Быстрый способ накачать домен данными чтобы можно было запустить daily/weekly. Минимум для daily — 3 события.

Этап 2

Анализ памяти LLM-куратором ?

Куратор фильтрует шум, аналитик извлекает паттерны. Daily превращает L1 в L2, weekly — L2 в L3. Каждая операция вызывает DeepSeek (~10-30 секунд).

POST

Daily: L1 → L2

/memory/consolidate/daily

Куратор-фильтр + Daily Analyzer LLM. Создаёт один буфер на (date, domain) с patterns/mistakes/lessons.

POST

Weekly: L2 → L3

/memory/consolidate/weekly

Pre-Weekly Check (дубли, противоречия, повторяемость) + Weekly Consolidator LLM. Добавляет знания и инструменты в L3, создаёт L4-снапшот если изменилось.

POST

Monthly Audit

/memory/audit/monthly

Полный аудит L3: устаревшие знания (>90д), мёртвые инструменты (>60д), внутренние конфликты, дубликаты.

POST

Очистка L1

/memory/cleanup

Удаляет события L1 старше 14 дней (RETENTION_DAYS). По плану вызывается после weekly.

Этап 3

Поиск знаний через OP ?

Агент задаёт контекст-вопрос → система превращает его в вектор → KNN ищет ближайшие L3-записи → создаётся сессия в Redis (24h TTL).

POST

KNN-поиск

/operative/query

Возвращает session_id + top_k знаний и инструментов с distance (косинусное сходство).

POST

Закрыть сессию

/operative/sessions/{id}/close

keep_results=true → результат работы агента уйдёт обратно в L1 (обратная петля). false → сессия просто удаляется.

POST

Feedback по записи

/operative/feedback

useful=true → confidence записи в Redis повышается. false → понижается, при <0.3 удаляется из фрагмента.

Этап 4

Реестр инструментов L3 ?

Инструменты можно регистрировать вручную (агент описал свою API) или они извлекаются автоматически weekly-консолидатором из L2-буферов.

POST

Зарегистрировать инструмент

/tools
GET DELETE

Список инструментов домена

/tools?domain=...
Этап 5

Снапшоты L4 ?

Disaster recovery: если L3 повреждён — восстанавливаем из любого снапшота. Каждый снапшот с SHA-256.

GET

Список снапшотов

/memory/snapshots

Все снапшоты L4 с типом, размером и хэшем.

POST

Восстановить L3 из снапшота

/memory/snapshots/restore/{id}

Двухфазно: проверка хэша → атомарная транзакция (старое в effective_to, новое в effective_from). Опасная операция!