База знаний: как настроить

База знаний

Версия: v2Дата: 15.06.2026

Что значит «настроить» базу знаний

Главная настройка базы знаний — связи. Страница может быть общей для проекта или привязанной к конкретной сущности: SHORTLINK, EVENT, JOURNEY, LIVECHAT, REPORT и другим объектам. На фронте это реализовано через EntityKnowledgePanel, который показывает страницы, связанные с текущим объектом.

База знаний: связанные объекты — В карточке страницы справа отображаются anchors: serviceKey, entityType, entityUuid и routeSnapshot.

Где видна связанная документация

В карточке короткой ссылки /projects/{projectUuid}/links/{linkUuid}.
В карточке события /projects/{projectUuid}/settings/events.
В карточках сценариев, отчётов, livechat и других сущностей, где подключена панель знаний.

База знаний: поиск — Через поиск можно найти страницу по plain text, а не только по заголовку.

Best practice

Для объекта создавайте одну основную страницу ENTITY_DOC.
Для аварийных процедур создавайте отдельный RUNBOOK.
Не храните секреты, токены и пароли в тексте страницы.
При изменении процесса создавайте новую версию с комментарием.

Технически: пользователь работает во frontend через REST в gateway. Внутри CDP используется контур gateway → cdp_knowledge; картинки и вложения проходят через cdp_files, связи хранятся как anchors на сущности CDP. Пользователю это нужно знать только для диагностики: если UI показывает ошибку, смотрите route, HTTP-статус gateway и связанный сервис.

База знаний: версия страницы — Версионность нужна, чтобы понимать, кто и почему менял документацию.