# Умный AI-поиск

**Где найти:** вкладка **AI beta** на странице поиска.

Вкладка показывает то, что нашла бы Анфиса по просьбе «найди …»: задачи и документы со сниппетом и ссылкой на источник, без текстового ответа модели. Анфиса сама решает, где искать — по задачам, по документации или и там и там. Это отдельный режим основной страницы [Поиск](https://help.1forma.ru/domains/search/business.md).

![Вкладка AI beta на странице поиска с результатами](https://help.1forma.ru/help-images/search/search_types_ai.png)

## Доступ

Вкладка доступна тем, кому доступна Анфиса. Поиск идёт от вашего имени и с вашими правами: вы видите только те задачи и документы, которые вам доступны. Если Анфиса вам недоступна, вместо результатов вкладка покажет сообщение об этом.

## Четыре режима поиска

Режим переключается автоматически — по словам и формату запроса:

| Режим | Что ищет | Как активируется | Пример |
|-------|----------|------------------|--------|
| **Задачи** | Задачи по фильтрам и тексту | По умолчанию | `пресейлы клиент ромашка` |
| **Комментарии** | Комментарии по автору и тексту | Слова: писал, обсуждал, комментарий, переписка | `Сидоров писал про интеграцию` |
| **Содержимое файлов** | Текст внутри вложенных файлов | Фразы: «в файлах», «по вложениям», «содержимое файлов» | `в файлах протокол совещания` |
| **Файлы по имени** | Файлы по имени и расширению | Расширение в запросе: .xlsx, .pdf, .docx и др. | `отчёт.xlsx` |

## 1. Поиск задач (по умолчанию)

Всё, что не попало в другие режимы, ищет задачи. Система разбирает запрос на условия отбора — категория, исполнитель, параметры, статус, флаги, — а нераспознанный остаток ищет по тексту.

### Категории, разделы и люди

Напишите название — система его распознаёт:

```
пресейлы                          → задачи категории «Пресейлы»
ошибки хд                         → задачи категории «Ошибки ХД»
в разделе Поддержка               → все задачи раздела
в категории Мобильная разработка  → точное указание
```

Склонения работают: «пресейлов», «мобильной разработке», «поддержки» — всё распознаётся.

Укажите фамилию в любом падеже:

```
задачи Иванова             → задачи, где Иванов исполнитель
исполнитель Кузнецов       → явное указание роли
заказчик Иванова           → задачи, где Иванов заказчик
```

### Фильтры по дополнительным параметрам (ДП)

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

```
пресейлы клиент ромашка       → параметр «Клиент» содержит «ромашка»
клиенты КМ Смирнов            → параметр «КМ» = Смирнов
клиенты ЛК да                 → параметр-флажок «ЛК» = да
клиенты рейтинг А+            → параметр «Рейтинг» = «А+»
клиенты ИНН 7700000000        → параметр «ИНН» содержит «7700000000»
клиенты оборот > 100000       → параметр «Оборот» больше 100000
```

Для числовых и денежных параметров работают сравнения: `>`, `<`, `>=`, `<=`, `=`, `≠`.

Если после названия параметра не указано значение — найдутся задачи, где этот параметр заполнен:

```
пресейлы клиентский срок    → задачи, где параметр «Клиентский срок» заполнен
```

### Статусы, флаги, сортировка и комбинирование

Чтобы отобрать задачи по статусу, укажите его в запросе:

```
в статусе Проведение        → задачи в статусе «Проведение»
со статусом Тестирование    → то же
```

Слова-флаги сужают выборку по состоянию задачи и вашей роли в ней:

```
открытые                    → только открытые (по умолчанию)
закрытые                    → только закрытые
просроченные                → только просроченные
мои задачи                  → где я исполнитель
я автор                     → где я заказчик
я подписчик                 → где я подписчик
```

Порядок выдачи тоже задаётся словами:

```
старые задачи ...           → сначала старые (по дате создания)
новые задачи ...            → сначала новые (по дате изменения)
```

По умолчанию — по дате изменения, новые первыми.

Всё перечисленное можно объединять в одном запросе:

```
просроченные пресейлы клиент ромашка   → флаг + категория + параметр
закрытые задачи Иванова старые         → флаг + исполнитель + сортировка
клиенты км смирнов ромашка             → категория + параметр + поиск по тексту
```

## 2. Поиск по комментариям

Включается словами-триггерами. Триггер убирается из запроса, остальное разбирается как обычно.

**Триггеры:** писал, написал, обсуждал, говорил, сообщал, спрашивал, отвечал, комментировал (во всех формах: писала, писали, пишет…), а также комментарий, комменты, сообщение, переписка.

```
Сидоров писал про интеграцию    → комментарии Сидорова с текстом «интеграция»
комменты в категории Ошибки ХД  → комментарии в задачах категории
переписка Иванова               → комментарии Иванова
```

В результатах — автор и текст комментария со ссылкой на задачу.

## 3. Поиск по содержимому файлов

Ищет текст внутри вложенных файлов, включая распознанный текст со сканов и изображений. Включается явными фразами — просто слово «файл» не сработает.

> **Для сертифицированной сборки (ФСТЭК):** распознавание текста на изображениях недоступно — по содержимому ищется только текст документов.

**Триггеры:** «в файлах», «в файле», «по файлам», «из файлов», «содержимое файлов», «в вложениях», «по вложениям».

```
в файлах протокол совещания     → файлы с текстом «протокол совещания» внутри
по вложениям акт приёмки        → то же
в файлах пресейлы бюджет        → файлы в категории «Пресейлы» со словом «бюджет»
```

Учитываются формы слова: «протокол» найдёт «протоколы», «протоколом» и т.д.

В результатах — имя файла со ссылкой на задачу.

Слова «транскрипция», «ВКС», «расшифровка», «стенограмма», «видеоконференция», а также «протокол ВКС», «запись встречи», «запись созвона» включают специальный режим: поиск по содержимому файлов с именем «Видеоконференция от …». Явные триггеры вроде «в файлах» здесь не нужны.

```
транскрипция встречи с Ромашка    → файлы «Видеоконференция от…» с «Ромашка»
запись созвона апрель             → файлы «Видеоконференция от…» за апрель
```

## 4. Поиск файлов по имени

Самый простой режим. Если в запросе есть расширение файла, весь запрос считается именем файла.

**Расширения:** `.txt`, `.doc`, `.docx`, `.rtf`, `.pdf`, `.xls`, `.xlsx`, `.csv`, `.ppt`, `.pptx`, `.png`, `.jpg`, `.gif`, `.svg`, `.zip`, `.rar`, `.7z`, `.mp4`, `.mp3`, `.eml`, `.msg`, `.html`, `.xml`, `.json`, `.md`, `.sql` и другие (всего 39 форматов).

```
протокол.docx       → файлы с «протокол.docx» в имени
.xlsx               → все xlsx-файлы
report.pdf          → файлы с «report.pdf» в имени
акт сверки.pdf      → файлы с «акт сверки.pdf» в имени
```

Запрос в любом случае уходит Анфисе — отдельного быстрого режима без обращения к ней нет.

В результатах — имя файла со ссылкой на задачу.

## Скорость работы

Запрос выполняет те же шаги, что Анфиса при просьбе что-то найти, поэтому ответ занимает несколько секунд — пока идёт поиск, показывается индикатор загрузки. Если ничего не нашлось, вкладка так и скажет; при ошибке обращения показывается сообщение об ошибке.

Если по структурированному запросу ничего не нашлось, подключается полнотекстовый поиск с учётом форм слова. А для свободных формулировок (например, «условия поставки с отсрочкой») работает семантический поиск по смыслу — он точнее для расплывчатых запросов, но занимает 1–3 секунды.

## Частые вопросы

**Почему поиск вернул 0 результатов?**
Система могла принять слово за название категории или имя. Попробуйте упростить запрос или уточнить явным указанием: «в категории X» вместо просто «X».

**Почему долго?**
Запрос выполняет те же шаги, что Анфиса при просьбе что-то найти, поэтому занимает несколько секунд. Это нормально: дождитесь окончания загрузки.

**Важен ли регистр?**
Нет. «иванова», «Иванова», «ИВАНОВА» — одно и то же.

**Можно искать одновременно по задачам и файлам?**
Нет. Один запрос — один режим. Сделайте два отдельных запроса.