# Телефоны, ссылки и имена (/ru/docs/mentions)

Найдите, где кто-то прислал номер телефона, все ссылки на один сайт, все чаты, где упоминается документ, или все
сообщения, где назван коллега. Инструменты
замечают такие значения в сохранённых сообщениях: их можно искать в любой записи и отметить, что это такое. Этот номер —
Анны, этот — магазина, а это номер заказа, а не телефон. История нужных чатов должна быть сохранена на вашем
компьютере.

## Что такое упоминание [#что-такое-упоминание]

**Упоминание** — значение, которое инструменты нашли в сообщении: номер телефона, адрес почты, ссылка или ссылка на
документ Google или имя знакомого человека. Инструменты ищут упоминания в тексте сообщения,
в тексте его файлов и в расшифровках голосовых сообщений.

Каждое упоминание хранится в одной стандартной записи, поэтому поиск находит значение, как бы оно ни было написано.
`+1 (555) 010-0100` и `+1 555 010 0100` — один номер; российские `8 900 000-00-01` и `+7 900 000-00-01` — тоже.
`docs.google.com` и `drive.google.com` — один сайт, `google.com`.

Упоминания находятся по постоянным правилам на вашем компьютере. Никакой провайдер ИИ не читает для этого ваши
сообщения, и ничего не отправляется в мессенджер. Правила ищут то, что «похоже на телефон»: даты, суммы, номера карт и
числа после слов вроде «заказ» или «счёт» пропускаются, но какие-то коды всё равно найдутся как телефоны. Такие
отклоняют один раз. Номер другой страны без `+` находится, только если перед ним стоит слово вроде «тел» или
«телефон», и тогда хранится просто цифрами.

## Попросите агента [#попросите-агента]

> ```text prompt
> Найди в моей истории Telegram все сообщения, где кто-то присылал номер +1 555 010 0100. Покажи чат, дату и сообщение вокруг. Только чтение: не отвечай и не отмечай сообщения прочитанными.
> ```

> ```text prompt
> Перечисли ссылки на google.com, которые мне присылали в MAX за прошлый месяц, по чатам. Только чтение.
> ```

> ```text prompt
> Найди в Telegram сообщения, где писали об Анне Смирновой, в любом падеже. Только чтение.
> ```

Агент ищет в истории, сохранённой на вашем компьютере. Если какого-то чата или периода там нет, пустой ответ не
доказывает, что значение никто не присылал: [сначала загрузите эту историю](/llms.mdx/docs/ru/search/content.md#%D1%81%D0%BD%D0%B0%D1%87%D0%B0%D0%BB%D0%B0-%D0%B7%D0%B0%D0%B3%D1%80%D1%83%D0%B7%D0%B8%D1%82%D0%B5-%D0%B8%D1%81%D1%82%D0%BE%D1%80%D0%B8%D1%8E-%D0%BD%D1%83%D0%B6%D0%BD%D1%8B%D1%85-%D1%87%D0%B0%D1%82%D0%BE%D0%B2).

## Поиск по значению [#поиск-по-значению]

Четыре поля поиска находят сообщения по упоминанию:

```sh
tg personal search messages 'phone:"+1 555 010 0100"'
tg personal search messages 'email:"ana@example.com"'
max personal search messages 'domain:example.com'
max personal search messages 'url:"https://example.com/price"'
```

* `phone:` находит номер с любыми пробелами, дефисами и скобками. Пишите его с кодом страны и `+`. Без `+`
  распознаются только российские номера: `8 900…` и `9…` из десяти цифр читаются как `+7`.
* `email:` находит адрес в любом регистре. Берите его в кавычки: у `@` в запросе своё значение.
* `domain:` находит все ссылки и все адреса этого сайта, включая поддомены.
* `url:` находит одну ссылку. Параметры отслеживания вроде `utm_source` и часть после `#` не учитываются.

Значение из файла или голосового сообщения находит сообщение, к которому пришёл файл. Поля сочетаются с остальным
[языком запросов](/llms.mdx/docs/ru/tg/query-language/content.md), например `domain:example.com AND date>=2026-09-01`.

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

Чтобы увидеть сами упоминания, сначала новые:

```sh
tg personal mentions list kind:phone
tg personal mentions list domain:example.com status:found
tg personal mentions show 12
```

`list` показывает у каждого упоминания ID, дату, вид (`phone`, `email`, `url`, `document`, `person-name`), значение,
статус и
сообщение. `show` добавляет текст вокруг и сколько ещё мест содержат то же значение.

У упоминания один из трёх статусов:

| Статус | Значение |
| --- | --- |
| `found` | найдено правилами; что это, ещё никто не сказал |
| `linked` | известно, что это: номер человека, адрес компании, документ в локальном хранилище |
| `dismissed` | не настоящее упоминание или не стоит хранить |

## Отметьте, что это за значение [#отметьте-что-это-за-значение]

```sh
tg personal mentions confirm 12 person:7
tg personal mentions confirm 12 organization:3
tg personal mentions reject 14
```

* `confirm 12 person:7` записывает, что этот номер или адрес принадлежит человеку 7. `organization:<id>` — что он
  принадлежит организации, например телефон магазина или адрес `info@` компании.
* `reject 14` отклоняет значение, которое не настоящее упоминание, например номер заказа, похожий на телефон.
* Ссылка на документ подтверждается без владельца, когда документ есть в локальном хранилище: `confirm 15`.

Решение относится к значению, а не к одному сообщению. Подтвердите номер один раз, и все сообщения с ним связываются
с этим человеком, включая те, что придут позже. Отклоните его, и он останется отклонённым везде. Номер или адрес,
который уже принадлежит человеку из вашей истории, связывается без вас.

Подтверждение и отклонение меняют только локальное хранилище на вашем компьютере. Ничего не отправляется, аккаунт в
мессенджере не меняется. Хранилище записывает, кто решил. Команда, запущенная в терминале агента, где задана
переменная `AI_AGENT` или `CLAUDECODE`, записывается как решение агента; `--as-owner` записывает её как ваше. Если
[разрешения](/llms.mdx/docs/ru/permissions/content.md) вашего профиля не позволяют эти изменения, ошибка назовёт настройку, которую нужно
поменять.

## Имена людей [#имена-людей]

Инструменты находят ещё и имена людей, которых вы встречали в чатах: имя человека и имена его аккаунтов. Имя
находится в любом падеже: «Анна» находит и «Анне», и «Анну». Имя, записанное латиницей, находит и русское написание:
«Valery» находит «Валерию». Два имени одного человека подряд, например имя и фамилия, считаются одним полным именем.

Именем считается только слово с заглавной буквы из четырёх букв и больше. Короткие слова вроде «Оля» пропускаются:
чаще это обычные слова, а не имена. Люди, известные только по почте, не учитываются: в основном это компании и
рассылки.

Одно имя может принадлежать нескольким людям, поэтому имя решается там, где оно написано, а не везде:

```sh
tg personal mentions list kind:person-name status:found
tg personal mentions confirm 31 person:7
tg personal search messages 'mentions:"person:7"'
```

`show` перечисляет людей, которыми может быть это имя. Без вас имя связывается с человеком, только если в этом чате
писал ровно один человек с таким именем. `mentions:"person:7"` находит сообщения, где назван человек 7 или есть его
подтверждённый номер или адрес.

Когда в истории появились новые люди, прочитайте имена заново:

```sh
tg personal mentions rebuild person-name
max personal mentions rebuild person-name
```

## Сообщения, сохранённые раньше [#сообщения-сохранённые-раньше]

Новые сообщения получают упоминания при сохранении. Сохранённую раньше историю прочитайте один раз:

```sh
tg personal mentions rebuild
max personal mentions rebuild
```

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

## Номера телефонов и приватность [#номера-телефонов-и-приватность]

Номера хранятся в локальном хранилище цифрами, как и в самих сохранённых сообщениях. В логи, сообщения об ошибках и
записи запусков они не попадают. Ссылки не открываются, к сайтам никто не обращается.

## Чего пока нет [#чего-пока-нет]

* Имена людей, которых инструменты ещё не знают.
* Упоминания в [заметках и файлах](/llms.mdx/docs/ru/memo/notes/content.md) и в [почте](/llms.mdx/docs/ru/email/content.md).
* Связь ссылки с чатом или сохранённым документом, на который она ведёт. Пока ссылку можно только отклонить.
* Адреса.

Когда вы узнали, где появлялись номер, сайт или имя, [вспомните контекст общения с этим человеком](/llms.mdx/docs/ru/people/content.md), прежде чем
отвечать.
