Контекстные ключи

Контекстный ключ связывает материал базы знаний с элементом сайта или кабинета. Когда пользователь выбирает элемент и задаёт вопрос, документ с таким же ключом получает приоритет в поиске.

Ключ для всего документа

Откройте текстовый документ и укажите ключи в поле «Контекстные ключи для элементов». Вводите по одному ключу на строку или разделяйте ключи запятыми.

Такой же ключ должен быть указан на элементе сайта или кабинета в атрибуте data-ai-context-id.

Если файл загружен из MD/ZIP, проверьте это поле после импорта. Импорт также извлекает ключи из inline-меток data-ai-context-id в тексте Markdown.

Ключ для фрагмента текста

Если с элементом связан только определённый фрагмент документа, добавьте метку прямо в Markdown:

Нажмите <span data-ai-context-id="channels.add">кнопку «Добавить канал»</span>.

Ключ должен состоять как минимум из двух сегментов через точку, например channels.add или widget.custom-action.create. Допустимы латинские буквы, цифры, дефисы и подчёркивания; общая длина — не более 120 символов. Пробелы, кириллица и пустые сегменты не поддерживаются.

Чтобы добавить метку, откройте режим Markdown и оберните нужный текст в span. Затем можно вернуться в визуальный режим: помеченный фрагмент будет выделен. Нажмите его, чтобы открыть панель контекстной метки.

В панели можно изменить ключ и применить его кнопкой «Сохранить». «Убрать метку» удаляет только привязку, а текст остаётся. Закрытие панели не применяет несохранённое изменение.

Ключи из inline-меток кабинет добавляет к документу автоматически и не дублирует в поле ручных ключей. Если метка написана с ошибкой, исправьте её в Markdown; до исправления визуальное редактирование может быть недоступно.

Пример разметки сайта

<button data-ai-context-id="channels.add" data-ai-kb-query="как добавить канал">
  Добавить канал
</button>

Если документ не находится по элементу

1. Проверьте, что в документе указан нужный ключ.
2. Проверьте, что на элементе есть такой же data-ai-context-id.
3. Сравните написание ключей без лишних пробелов.
4. Убедитесь, что файл активен и привязан к агенту или доступен через выбранную папку.
5. Добавьте в документ достаточно слов для обычного текстового поиска, а не только короткий ключ.