# Поиск по темам переписки в MAX (/ru/docs/max/topic-search)

[Найти сообщение или обсуждение](/llms.mdx/docs/ru/search/content.md)

Вы помните, что в чате что-то обсуждали, но не помните, какими словами. Поиск по темам находит такое
обсуждение по смыслу. Спросите «где мы говорили про аренду квартиры?» — и он найдёт разговор, в котором
были «сдаю», «залог» и «хозяйка», даже если слов «аренда квартиры» никто не написал. Он работает и между
языками: вопрос по-русски находит обсуждение на английском или испанском.

Прочитав эту страницу, вы сможете подготовить чат к поиску по темам, задавать вопросы своими словами,
читать результаты и понимать, когда лучше подходит обычный поиск по словам. Поиск по темам использует
только сообщения, которые `max` уже сохранил на этом компьютере, поэтому сначала скачайте историю:
`max personal messages sync <чат>` ([скачать историю чата](/llms.mdx/docs/ru/max/archive/content.md#%D1%81%D0%BA%D0%B0%D1%87%D0%B0%D1%82%D1%8C-%D0%B8%D1%81%D1%82%D0%BE%D1%80%D0%B8%D1%8E)).

Термины этой страницы:

- **Разговор** — одно обсуждение внутри чата. В оживлённой группе идут сразу несколько разговоров, и
  их сообщения перемешаны. `max` разделяет их; разговор — список сообщений, которые относятся друг к
  другу, от старых к новым.
- **Кусок** — короткая часть разговора, около 1200 знаков. Длинный разговор режется на куски, чтобы
  каждый был примерно об одном.
- **Вектор** — набор чисел, который передаёт смысл текста. У текстов об одном и том же векторы похожи,
  даже если слова или язык другие.
- **Модель** — небольшая программа, которая превращает текст в вектор. По умолчанию она работает на
  вашем компьютере.

Поиск по темам — не поле `topic:` [поиска сообщений](/llms.mdx/docs/ru/max/search/content.md). `topic:` оставляет одну ветку
обсуждения. Разговор здесь — то, что `max` находит сам, в любом чате.

## Что можно сделать [#что-можно-сделать]

| Задача | Команда |
|---|---|
| Найти обсуждение по теме — в одном чате или во всех подготовленных | `max personal search conversations "<вопрос>"` |
| Посмотреть разговоры чата, новые сверху | `max personal conversations list <чат>` |
| Прочитать один разговор от начала до конца | `max personal conversations show <id>` |
| Открыть весь разговор, в котором есть сообщение | `max personal conversations show <чат> <сообщение>` |
| Найти другие разговоры о том же, во всех чатах | `max personal conversations related <чат> <сообщение>` |
| Ограничить результат человеком, периодом или словом | `max personal search conversations "<вопрос>" --filter '<запрос>'` |
| Узнать, что устарело, и догнать | `max personal conversations status`, `max personal search conversations "<вопрос>" --catch-up` |
| Попросить своего ИИ-агента точнее связать сообщения | `max skill show link-conversations` |

## Поиск по темам или поиск по словам? [#поиск-по-темам-или-поиск-по-словам]

| | [Поиск по словам](/llms.mdx/docs/ru/max/search/content.md) (`max personal search messages`) | Поиск по темам (`max personal search conversations`) |
|---|---|---|
| Что вы помните | точные слова, имя, дату, файл | только о чём шла речь |
| Что находит | отдельные сообщения с вашими словами | целые разговоры о вашем вопросе |
| Другие слова о том же | нет: «квартира» не найдёт «жильё» | да |
| Другие языки | нет | да, около 100 языков у модели по умолчанию |
| Точные условия (отправитель, дата, файл, ссылка) | да, весь [язык запросов](/llms.mdx/docs/ru/max/query-language/content.md) | да, через `--filter` |
| Подготовка | скачать историю | скачать историю, затем `build` и `embed` |
| Обращается к MAX | да, при поиске в одном названном чате | нет, читает только этот компьютер |

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

## Попробуйте [#попробуйте]

Подготовьте чат один раз, а потом задавайте сколько угодно вопросов.

**Ваш запрос ИИ-агенту:**

> В Книжном клубе найди, где мы обсуждали, чтобы встречаться в другом месте. Покажи разговор.

**Что происходит по шагам:**

```sh
max personal messages sync "Книжный клуб"                  # 1. скачать историю, если её ещё нет
max personal conversations links rebuild --chat "Книжный клуб"   # 2. разделить чат на разговоры
max personal models download embeddinggemma         # 3. один раз: скачать модель, 219 МБ, общая с tg
max personal conversations embed --chat "Книжный клуб"   # 4. посчитать вектор каждого куска
max personal search conversations "где встречаемся" --chat "Книжный клуб"   # 5. спросить
max personal conversations show 91                       # 6. прочитать найденный разговор
```

Шаги 2–4 выполняются на вашем компьютере и к MAX не обращаются. `embed` продолжает с места, где его
прервали. Следующим вопросам нужен только шаг 5; когда повторять шаги 2 и 4, сказано в разделе
[Свежесть](#свежесть).

**Пример результата** (вымышленный):

```text
0.874  91  2026-09-14 18:02–18:40  23 messages · 4 people · from message 4180  (messages 4185–4192)  msg:max/500/7/4185
0.851  64  2026-08-02 10:15–10:31  9 messages · 3 people · from message 3302  (messages 3302–3310)  msg:max/500/7/3302
```

Найденное — подсказка, а не ответ: откройте разговор и прочитайте сообщения, прежде чем на него
опираться.

## Как это работает [#как-это-работает]

У поиска по темам три этапа. Первые два готовят чат один раз; третий выполняется на каждый вопрос.

### 1. Build: разделить чат на разговоры [#1-build-разделить-чат-на-разговоры]

`max personal conversations links rebuild` читает сохранённые сообщения чата от старых к новым и для каждого решает,
какое прежнее сообщение оно продолжает. ИИ не используется, к MAX команда не обращается. Связи берутся
в таком порядке:

1. **Ответы самого MAX.** Сообщение, отправленное ответом, относится к сообщению, на которое отвечает.
2. **Ответы вашего агента**, если вы попросили агента связать чат
   ([ниже](#связать-сообщения-поможет-ваш-агент)).
3. **Упоминание.** Сообщение, где кого-то упомянули, относится к последнему сообщению этого человека.
   Упоминание — это `@username`, упоминание, отмеченное мессенджером, или сообщение, которое начинается
   с имени пользователя и двоеточия или запятой (`anna: согласна`). `max` смотрит назад не дальше 50
   сообщений.
4. **Тот же человек пишет снова.** Следующее сообщение человека продолжает его предыдущее, если пришло
   в пределах 5 минут и последних 10 сообщений.

Сообщение без связи начинает новый разговор. Разговор может пропускать сообщения между своими, если те
из других разговоров. Правила угадывают: они могут разбить одно обсуждение на два или склеить два в
одно. Новый `build` заменяет прошлый, поэтому номер разговора берите из свежего `list`, а не храните.

### 2. Embed: превратить каждый кусок в вектор [#2-embed-превратить-каждый-кусок-в-вектор]

`max personal conversations embed` режет каждый разговор на куски около 1200 знаков, по границам сообщений.
Каждая строка куска — «отправитель: текст». Сообщение длиннее куска делится на части внахлёст, чтобы
модель прочитала всё длинное сообщение, а не только начало. Сообщения без текста ничего не добавляют.
Затем модель превращает каждый кусок в вектор, и `max` его сохраняет. Сам текст куска второй раз не
сохраняется — только вектор и отпечаток, по которому видно, что текст изменился.

### 3. Search: по смыслу и по словам одновременно [#3-search-по-смыслу-и-по-словам-одновременно]

`max personal search conversations` ищет ваш вопрос двумя способами и объединяет результаты:

- **По смыслу.** Вопрос тоже превращается в вектор. `max` сравнивает его с векторами всех кусков и
  оценивает каждый разговор по его самому близкому куску. У модели по умолчанию `embeddinggemma`
  учитываются все совпадения, их ранжирует сходство по шкале, где 1 — тот же смысл. У `e5-small`
  совпадение по смыслу должно быть достаточно близким: оценка сходства выше 0,80.
- **По словам.** `max` ищет и каждое слово вопроса в сохранённых сообщениях. Слово из трёх и более букв
  находит и более длинные слова, которые с него начинаются (`встреч` найдёт «встречаемся»). Опечатки не
  исправляются.

Разговор, найденный обоими способами, стоит выше найденного одним. У каждого результата сказано, как он
найден: `"by": ["meaning"]` (по смыслу), `["words"]` (по словам) или оба. Без скачанной модели поиск
всё равно работает, только по словам, и в ответе тогда `"meaning": "unavailable"`. Чат, который ни разу
не построен, не просматривается: сначала `build`.

**Почему так находится больше, чем поиском по словам:** поиску по словам нужно то же слово в
сообщении. Поиск по смыслу сравнивает, о чём тексты, и читает кусок разговора, а не одно сообщение.
Поэтому «где встречаемся» может найти обсуждение, где один спросил «библиотека или кафе?», а другой
ответил «в кафе на углу тише». Половина по словам не даёт потерять точные имена и редкие слова.

Техническая сторона — правила, куски, векторы и порядок результатов — на странице
[как устроен поиск](/llms.mdx/docs/ru/search-architecture/content.md).

## Посмотреть найденное [#посмотреть-найденное]

В терминале каждый результат — одна строка:

- оценка сходства, или `—`, если нашли только по словам;
- номер разговора, когда он начался и кончился, сколько сообщений и людей, его первое сообщение;
- `(messages 4185–4192)` — кусок, совпавший лучше всего (или сообщение, если нашли только по словам):
  с него и начинайте читать;
- ссылка на сообщение (`msg:…`), которую принимают `max personal messages show` и `max personal messages context`;
- `stale`, если текст изменили после подсчёта вектора: оценка — для старого текста.

С `--json` то, что поиск не смог просмотреть по смыслу, — записи в `missing`: модель не скачана, векторы
устарели, чат ни разу не построен или не скачан. Рядом в `next` — команда, которая это исправит, например
`conversations embed --chat <чат>`; аккаунты — в `meta.accounts`.

```sh
max personal conversations list "Книжный клуб" started_at>=7d
max personal conversations show 91                       # один разговор, от старых к новым
max personal conversations show "Книжный клуб" 204       # разговор, в котором сообщение 204
max personal conversations related "Книжный клуб" 204    # другие разговоры о том же, во всех чатах
max personal messages links "Книжный клуб" 204           # почему сообщение там, где оно есть
```

`related` берёт векторы, которые сохранил `embed`, и модель не запускает, поэтому отвечает быстро. Это
поиск только по смыслу.

## Примеры [#примеры]

**Тему помните, слова — нет.**

```sh
max personal search conversations "кто берёт еду на пикник"
```

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

**Обсуждали на другом языке.**

```sh
max personal search conversations "аренда квартиры" --chat "Клуб Пример"
```

С моделью по умолчанию так находится и обсуждение на испанском — про «piso».

**Сузить по человеку и периоду.** `--filter` принимает строгий [язык запросов](/llms.mdx/docs/ru/max/query-language/content.md).
Разговор подходит, если хотя бы одно его сообщение удовлетворяет всему условию. Сам вопрос по-прежнему
ищется по смыслу.

```sh
max personal search conversations "бюджет поездки" --filter 'from:"Алиса Тестова" date:30d'
```

```sh
max personal search conversations "условия договора" --filter 'has:file' --timezone Europe/Madrid
```

**Начать с одного сообщения.** Вы нашли сообщение поиском по словам и хотите всё остальное на эту тему:

```sh
max personal search messages '"вернули залог" chat:"Клуб Пример"'
max personal conversations related "Клуб Пример" 5120
```

**Искать и в чатах ботов.** По умолчанию поиск по темам идёт в текущей учётной записи. `--source personal`,
`bots`, `all` или название мессенджера расширяют охват; тогда у каждого результата сказано, из какой
учётной записи он.

```sh
max personal search conversations "задержка доставки" --source all
```

**Скачать новое перед вопросом.** `--sync-first` сначала скачивает новые сообщения — в пределах чата,
времени и числа сообщений, как у поиска сообщений.

```sh
max personal search conversations "где встречаемся" --chat "Книжный клуб" --sync-first
```

## Свежесть [#свежесть]

Новые сообщения попадают в разговор только после следующего `build`, а в векторы — после следующего
`embed`.

```sh
max personal conversations status                         # что отстало, по чатам
max personal conversations links rebuild                          # все изменившиеся чаты и группы, ни разу не построенные
max personal conversations embed                          # все построенные чаты, где остались куски
max personal search conversations "аренда квартиры" --catch-up  # сначала догнать, потом искать
```

`status` считает для каждого построенного чата сообщения, которых `build` ещё не видел (новые,
изменённые, удалённые), куски с актуальным, устаревшим или отсутствующим вектором, и сколько групп ни
разу не построено. Без `--chat` команды `build`, `embed` и `search conversations --catch-up` берут за раз не больше
20 чатов (`--max-chats`) и считают не больше 2000 кусков (`--max-chunks`); запустите ещё раз, чтобы
продолжить. Модель они не скачивают. `--catch-up` нельзя сочетать с `--filter` и `--source`: сначала
постройте и посчитайте нужные чаты.

Когда в новой версии меняются правила, `status` и `max personal store check` называют чаты, построенные по
старым, — постройте их снова.

Когда сообщение удаляют, его текст уходит и из векторов.

`max personal messages sync <чат> --catch-up` может сразу после скачивания построить разговоры чата и посчитать
векторы ([скачать историю чата](/llms.mdx/docs/ru/max/archive/content.md#%D1%81%D0%BA%D0%B0%D1%87%D0%B0%D1%82%D1%8C-%D0%B8%D1%81%D1%82%D0%BE%D1%80%D0%B8%D1%8E)).

## Связать сообщения поможет ваш агент [#связать-сообщения-поможет-ваш-агент]

Правила не видят связей, которые понятны только по смыслу. Их может добавить ваш собственный ИИ-агент
(например, Claude Code, Codex, Cursor или Gemini CLI):

```sh
max skill show link-conversations                     # инструкция для агента
max personal conversations batches status --chat "Книжный клуб"   # сколько сообщений и пачек, сколько текста
```

Агент читает инструкцию, говорит, сколько текста прочитает, и ждёт вашего «да». Потом он берёт чат
пачками (`max personal conversations batches show`), решает, на какое прежнее сообщение отвечает каждое, и
сохраняет ответ (`max personal conversations links add`). Следующий `build` его учитывает: сначала идут ответы
самого MAX, потом связи агента, потом правила. `max personal conversations links clear --chat "Книжный клуб"`
убирает ответы агента; после этого постройте чат снова. В этом процессе сам `max` модель не вызывает.
Сохранять ответы разрешает право профиля `conversations.links`.

`max` может и сам отправить пачки сервису моделей. Обычный `build` использует правила и сохранённые
связи; `max personal conversations links rebuild --chat <чат> --analyze` передаёт ограниченные пачки настроенному
OpenAI-совместимому сервису или Anthropic. Нужен явный `--chat`. Перед первой передачей команда
показывает объём, адрес и предел токенов и спрашивает согласие; оно сохраняется для учётной записи,
чата и выбранного сервиса до отзыва. По умолчанию пачка — 50 сообщений (`--size`), предел резерва —
100 000 токенов за запуск (`--max-tokens`); `--yes` даёт согласие в скриптах.
`max personal conversations consents list` показывает согласия, `consents remove --chat <чат>` отзывает их.
Встроенный анализ доступен только из командной строки, не через MCP; ключи не записываются в файл
настроек.

## Приватность и цена [#приватность-и-цена]

По умолчанию ничего не уходит с компьютера. Модель работает здесь и скачивается только по вашей
команде:

```sh
max personal models list kind:text                             # модели и какие скачаны
max personal models download embeddinggemma
```

`embeddinggemma` — по умолчанию: она знает более 100 языков и находит больше, но на неё действуют
условия использования Google Gemma. Для скачивания флаг не нужен. `--accept-terms` ещё принимается,
но ничего не делает. `e5-small` меньше и примерно в семь раз быстрее, лицензия MIT. Если на компьютере
скачана только `e5-small`, она остаётся в работе, пока не скачана `embeddinggemma`. Модель выбирает
`models set`. Векторы двух моделей не смешиваются: ищите той моделью, которой считали. Чат,
посчитанный только другой моделью, stderr называет.

На современном ноутбуке `embeddinggemma` считает около 8 кусков в секунду; группа в 100 000
сообщений — около часа с четвертью, один раз. `e5-small` считает около 30 в секунду, чуть больше
20 минут. Дальше считается только изменившееся.

Векторы может считать внешний сервис, с вашим ключом:

```sh
max personal models keys set openai
max personal conversations embed --chat "Книжный клуб" --embedding-provider openai
max personal search conversations "аренда квартиры" --embedding-provider openai
```

Тогда текст разговоров чата уходит этому сервису, а каждый поиск отправляет ему ваш вопрос. Прежде
чем что-то отправить, `embed` называет число кусков, наибольшее число токенов и наибольшую цену и
ждёт «да» (`--yes` в скриптах; `--max-tokens` задаёт предел). `--base-url` принимает любой сервер с
API векторов OpenAI (`/v1/embeddings`), например Ollama или LM Studio на вашем компьютере, вместе с
`--model` и `--dims`. `max personal models keys remove openai` забывает ключ. Настройка внешних векторов
действует и на поиск, который ваш агент выполняет через MCP: его вопросы тоже уходят этому сервису.

## Дальше [#дальше]

- [Поиск сообщений](/llms.mdx/docs/ru/max/search/content.md) — точные слова, люди, даты и файлы.
- [Как устроен поиск](/llms.mdx/docs/ru/search-architecture/content.md) — техническая сторона правил,
  кусков, векторов и порядка результатов.
