Ставить теги документам¶

Результат¶

Вы упорядочиваете нативные документы проекта свободными тегами — например, «Billing», «Релиз Q3», «Клиент X» — и сужаете список Documents до документов с этими тегами. У документа может быть сразу несколько тегов.

Перед началом¶

Чтобы добавлять и убирать теги, нужна роль member или выше. Роль viewer видит теги и может фильтровать по ним.
AI-агенты делают то же через MCP: kb_set_document_tags (scope kb.write), а kb_list_documents фильтрует по tags.

Добавить или убрать тег¶

Откройте Knowledge → Documents и документ.
В карточке документа найдите Tags.
Введите тег в поле Add a tag… и нажмите Enter (или поставьте запятую). Вставка «Billing, Q3» добавит оба. Под полем подсказываются теги, которые уже есть в проекте, — выберите, чтобы добавить.
Чтобы убрать тег, нажмите × на нём.

Каждое изменение сохраняется сразу. Теги принадлежат документу, а не одной его версии: смена тегов не создаёт новую версию, и все версии показывают одни и те же теги. Теги можно задать и при создании документа, в New document.

Правила:

не длиннее 40 символов и не больше 20 тегов на документ;
регистр не создаёт новый тег: «Billing» и «billing» — один тег;
запятая разделяет теги, поэтому внутри тега её быть не может;
лишние пробелы убираются; управляющие и невидимые символы не принимаются.

Отфильтровать список по тегам¶

Откройте Knowledge → Documents.
Выберите тег в Any tag или нажмите на чип тега в строке списка.
Чтобы сузить ещё, выберите другой тег в And tag…: в списке останутся документы, у которых есть каждый выбранный тег.
Нажмите × на выбранном теге, чтобы убрать его, или Clear, чтобы сбросить все фильтры.

При включённом Archived варианты тегов считают только архивные документы.

Найти документы по тегу в поиске¶

Поле поиска в списке Documents ищет и по тегам (по любой части тега). Поиск по базе знаний и AI-агенты (MCP kb_search_knowledge, kb_retrieve) находят документ, если вопрос содержит один из его тегов так, как он написан, целыми словами; регистр и лишние пробелы не важны:

«billing docs for Q3» найдёт документы с тегом «Billing» или «Q3»;
«release Q3» не найдёт «Q3 release» (слова должны идти в том же порядке);
«billing» не найдёт «bill»;
тег только из символов или эмодзи поиск не использует.

Новый тег находится сразу. В поиске по словам документ, найденный только по тегу, идёт после всех документов, у которых совпал текст; итоговый порядок учитывает и поиск по смыслу, поэтому такой документ всё же может оказаться высоко. Регистр сравнивается простым приведением к строчным: «STRASSE» не найдёт тег «Straße». Поиск сравнивает слова тега, а не смысл: «деньги» не найдут тег «Billing».

Частые проблемы¶

Симптом	Вероятная причина	Что делать
«A tag must be at most 40 characters.»	Тег слишком длинный	Сократите его
«A tag cannot contain a comma (commas separate tags).»	В тексте есть запятая	Введите части как отдельные теги
«20 tags at most — remove one to add another.»	У документа уже 20 тегов	Сначала уберите тег
«This document is archived, so its tags cannot change.»	Документ кто-то архивировал	Сначала разархивируйте его
Нет поля Add a tag…	У вас роль `viewer` или документ в архиве	Попросите участника или разархивируйте документ
На публичной ссылке нет тегов	Теги — только для участников проекта	Ничего — так задумано