Справочник/Agent Knowledge

Уровни знаний: draft / confirmed / archived / static

Каждый чанк живёт в одном из четырёх tier'ов. Tier определяет:

  • Доверие агента к факту
  • Видимость в поиске (агент видит confirmed чаще, чем draft)
  • Возможность редактирования (operator override на любую стадию)

Четыре tier'а

TierСмыслКогда используется
staticЗафиксированные «истины», не подлежат decayГлоссарий, формулы — то, что вечно
confirmedПроверенный факт, агент использует свободноОсновная масса знаний
draftСвежее наблюдение, ещё в работеТолько что записанные, не успели окрепнуть
archivedУстаревший / отклонённый, не показываетсяПосле reject, decay или ручного решения

Как чанк меняет tier

Автоматически — daily promoter (03:15 МСК)

Демон promoter каждый день в 03:15 МСК пробегает все draft-чанки и пытается их повысить до confirmed. Решает по таблице:

SourceMin evidenceMin ageТребует ручного approve?
api_observation37 днейнет
marketplace_api23 днянет
conversation_extract57 днейнет
reflection114 днейда (≥ 30 дней без reject)
compressed114 днейда
manual10нет
manual_ingest10нет (см. ниже про auto_approved)

🔍 manual_ingest нюанс: новые факты из «Обучения» обычно сразу попадают в confirmed через ADD-путь конфликт-резолвера (это нормально, когда оператор одобрил preview, а похожих чанков в базе нет). Если резолвер пикнет UPDATE-путь (т. е. новый факт похож на существующий и сливается с ним), система также поднимет таргет с draft до confirmed — auto_approved передаётся внутрь UPDATE-ветки. NOOP-пути (точный дубль) ничего не поднимут, потому что нечего публиковать. В промоутере есть safety net на случай странного пути без auto_approved.

Если evidence count + age превышают порог — draft → confirmed. Если 30+ дней без подтверждений → archived.

Через approve/reject (ручной override)

  • Approve на чанке (или approve pending от агента) → сразу confirmed
  • Reject → archived

Через decay scheduler (V2)

decay_scheduler (daily 02:05 МСК — за 70 минут до promoter'а) понижает чанки, которые давно никто не запрашивал:

  • Не использовался 30 дней + low confidence → ослабить confidence
  • Не использовался 60 дней → перевести в archived

Decay не трогает static — на то и static.

Поведение поиска по tier

Когда агент делает search_knowledge, движок берёт топ-K по cosine, отсортированных по tier:

  • static и confirmed идут первыми
  • draft показывается с пометкой [draft] (агент сообщает в ответе)
  • archived не возвращается вообще

То есть пока чанк в draft, его влияние ограничено. После promoter он начинает работать на полную.

Когда менять tier вручную

Большинство переходов автоматические. Ручной override — для исключений:

СценарийДействие
Срочный факт (Ozon выкатил новое правило сегодня)Создайте через Обучение → manual_ingest сразу confirmed
Чанк в draft уже неделю и явно полезенОткройте /manage/ak/chunks/{id} → tier → confirmed
Чанк процитировал факт, который оказался выдумкойTier → archived + причина в audit
Внесли глоссарий, который не должен decay'итьTier → static (через /admin/ak/chunks/{id}/tier)

⚠️ Не злоупотребляйте static. Маркетплейсы меняют правила; сегодняшняя комиссия может стать вчерашней. static — только для вещей, которые по определению не зависят от времени.

Связанные настройки

  • Visibility менять у чанка нельзя — это нарушает scoping invariants. Если нужен «как этот, но для другого scope» — создайте новый через Обучение.
  • Confidence — числовая, 0..1; редактируется на странице детали чанка вместе с body.
  • Source — не редактируется; это атрибут происхождения для аудита.

Что дальше

  • «Обучение» — самый быстрый путь добавить знания, сразу в confirmed
  • «Очередь review» — про логику конфликт-резолвера и pending
  • «Когда агент даёт неверный ответ» — чек-лист, если что-то идёт не так

Смотрите также

Перенос карточек из Ozon в Wildberries →Сверка товаров: единый каталог по штрихкоду →Ценообразование: подбор цен и отправка в Ozon →Свой склад: с чего начать →Документы склада →Связь склада и поставок на FBO →Расходы из отгрузок маркетплейсам →Связь склада и закупок →Закупки: что заказать, заявки, контейнеры →Заказы поставщикам →Прайс-листы поставщиков →Сопоставления SKU →Поставки от поставщиков →Поставки на склады Ozon →Создание поставки FBO →Кластеры Ozon →Остатки на складах Ozon →Упаковка FBO →Возвраты к выдаче →Отложенная бронь слотов FBO →Авито: подключение кабинета и Автозагрузка →MCP-коннектор — AI-сотрудник для вашего магазина →Контент-фабрика: с чего начать →Бренды →Каналы публикации →База знаний бренда →Мониторинг новостей →Темы и идеи →Очередь контента →Контент-календарь →История публикаций →Автопилот →Аналитика контента →Настройки контент-фабрики →Память агента: что это и зачем →Обучение: как скармливать тексты и файлы →Очередь review, findings, lineage →Когда агент даёт неверный ответ →Insights (Reflector): дайджест паттернов →Industry review: кросс-арендные инсайты →