Документация

Поиск по базе знаний

Спрашивайте своими словами — поиск по содержимому идёт по смыслу, а не по совпадению букв: «как мы решили вопрос с оплатой» найдёт документ, где слова «оплата» нет вовсе.

Окно быстрого перехода

Главная дверь в поиск — Ctrl+K (на Mac — ⌘K), двойное нажатие Shift, привычка из IDE, или поле «Поиск» вверху левой колонки. Пустое окно показывает недавно открытое.

Вкладки окна:

Вкладка Что делает
Всё, Страницы, Документы, Презентации, Доски, Задачи поиск по названию — на каждую букву; найти документ, название которого вы помните
Теги все теги проекта с числом страниц; выбор тега — список помеченного, набор в поле сужает его по названию
Текст поиск по содержимому — по Enter

Первые отвечают на вопрос «где этот документ», «Текст» — «где про это написано». Поиск по содержимому запускается по Enter, а не на каждый символ, и причина в цене: по названиям отвечает один запрос к базе за миллисекунды, по содержимому — вектор, лексика и реранкер в соседнем сервисе, то есть секунды. Двум скоростям в одном списке не место.

Решётка в начале запроса переключает на «Теги» — так тег и набирают. Стрелки водят по списку, Enter открывает, Ctrl+Enter — в новой вкладке, Tab — следующая вкладка окна. Рядом со списком — предпросмотр начала выбранной строки; окно не меняет размер и не прыгает на каждый введённый символ.

Экран поиска

Полный экран «Поиск и теги» — когда выдачу нужно рассмотреть или отправить ссылкой. Туда ведут клик по тегу на странице или на дашборде и ссылка «На экране поиска» на вкладках «Текст» и «Теги» окна. Строка ищет по смыслу, теги фильтруют точно; работают вместе — поиск внутри помеченного. Запрос и теги живут в адресе, поэтому ссылкой на выдачу можно поделиться.

Что попадает в выдачу

Страницы и подключённые внешние документы: Google-доки, презентации, доски Miro. Выдача ведёт в нужное место документа — к разделу, слайду или фрейму доски, а не к документу целиком.

В каждой строке — название, значок источника, процент соответствия, раздел, фрагмент текста и теги. Порядок — по релевантности, а не по дате.

Почему находится то, что не написано теми же словами

Внутри работают две ветки сразу: одна ищет по смыслу (близость векторов), другая — по точным словам и числам. Их результаты складываются, а верхние кандидаты дополнительно переупорядочивает отдельная модель.

Практически это значит вот что:

  • Точные строки находятся точно. Номер версии, идентификатор конфигурации, ОГРН, название переменной — по ним поиск попадает в цель, хотя смысловая близость на числах слепа.
  • Переформулированный вопрос тоже находится. «Какие три базы данных в проекте» найдёт документ, где нет ни одного слова из вопроса.

Порога у поиска нет: он показывает всё, что нашёл, а решаете вы. Порог есть у ассистента — в ответ он берёт только уверенно подходящее.

Когда поиск по смыслу недоступен

Модели, которые ищут по смыслу и упорядочивают выдачу, на бете работают на оборудовании без резервирования. Когда оно недоступно, поиск не ломается, а находит по совпадению слов и говорит об этом плашкой: «Умный поиск сейчас недоступен — ищу по словам. Результаты могут быть хуже обычного». Без модели порядка выдачи — своя плашка: самые подходящие результаты могут оказаться не вверху. Ассистент в чате предупреждает о том же отдельной строкой.

Ничего делать не нужно: поиск по смыслу вернётся сам, а страницы, которые успели измениться за это время, догонят индекс без вашего участия.

Что ищется внутри страницы

Текст, заголовки, подписи к картинкам и подписи на диаграммах — исходник схемы индексируется как обычный текст. По самой картинке поиск не ищет: ни по загруженной, ни по нарисованной диаграмме. Подпись «Оплата → Банк» на блок-схеме найдётся, содержимое скриншота — нет.

Задачи в выдачу по содержимому не попадают вовсе, см. Задачи — их находят по названию в окне быстрого перехода.

Фильтр по тегам

Теги — это не поиск, а сужение: несколько тегов складываются по «И», и в выдаче остаются страницы, помеченные всеми сразу. Фильтр можно применить и без запроса — тогда это просто список помеченных страниц. См. Ссылки и теги.

Границы

Проект — граница всего. Каждый запрос идёт в пределах одного проекта, и это не договорённость, а устройство: искать «по всем проектам сразу» технически невозможно. Ни соседний проект, ни чужая организация в выдачу не попадут.

На публичном сайте документации поиск сужен до страниц: ни задачи, ни внешние документы снаружи не ищутся — названия вроде «Починить выкат» или «Бюджет 2026» рассказывают о компании больше, чем она собиралась показать.

Когда написанное найдётся

Почти сразу: как только страница сохранилась, сервер сам отправляет её в поиск — без кнопки «переиндексировать» и независимо от того, закрыли ли вы вкладку. Сначала текст находится по словам, через мгновение — и по смыслу.

Состояние видно у точки сохранения над страницей — наведите на неё:

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

Если в проекте накопились страницы не в индексе, на дашборде в полосе счётчиков появится «N страниц не в индексе» — плитка показывается, только когда есть о чём сказать.

Неподтверждённая правка агента в индекс не попадает вовсе — до тех пор, пока вы её не приняли, см. Проверка правок агента.

Если не находится

  • Спросите иначе. Полный вопрос («какой порядок выката и кто его подтверждает») работает лучше одного слова («деплой»).
  • Проверьте, есть ли это вообще. Поиск не выдумывает: чего в базе нет, того он не покажет.
  • Спросите ассистента. Он делает несколько заходов в поиск и собирает ответ из нескольких документов — см. Чат с ассистентом.