Работа с агентом

Люди

Вспомните, кто вам написал и что вы обсуждали, прежде чем отвечать — по своей переписке Telegram или MAX.

Вспомните, кто вам написал и что вы обсуждали, прежде чем отвечать. Попросите агента рассказать, откуда вы знаете человека, о чём договаривались и какие сведения об аккаунте доступны, — с исходными сообщениями для каждого ответа. Ещё вы можете объединить Telegram и MAX одного человека.

Кто такой «человек» здесь

Человек — это тот, кого ваш аккаунт видел в чате: в личной переписке или в общей группе. Инструменты узнают его по аккаунту в мессенджере — ID, а в Telegram ещё и @username — и по тому, что о нём хранит история, сохранённая на вашем компьютере.

Человек не обязан быть в ваших контактах. Контакты — это адресная книга мессенджера: люди, которых вы добавили, часто по номеру телефона. Тот, кто писал в общей группе, считается человеком, даже если вы его не добавляли. contacts list показывает контакты, доступные через выбранный мессенджер. Добавить, переименовать или удалить контакт — отдельное действие, оно меняет ваш аккаунт в мессенджере.

О человеке можно хранить и личный контекст. Он остаётся на вашем компьютере и не попадает в мессенджер:

  • Своё имя для человека. Команды смогут находить его по этому имени. Оно действует в выбранном аккаунте и не меняет имя в ваших контактах.
  • Заметки. Свободный текст о человеке, по которому вы или агент потом сможете искать.

Команды описаны в руководстве Telegram о людях и в справочнике MAX.

У одного человека часто есть аккаунт в Telegram и аккаунт в MAX. Инструменты считают их двумя людьми, пока вы их не свяжете: не запишете на своём компьютере, что оба аккаунта принадлежат одному человеку. После этого обзор того, что он писал, включит его сообщения из обоих мессенджеров. Подробнее — в разделе один человек в двух мессенджерах.

Телефоны и почта в сообщениях

Телефон или адрес почты в сообщении кому-то принадлежит, но инструменты не угадывают кому. Они показывают каждое значение как упоминание, а вы говорите, чьё оно. Замените 1 на id из списка:

tg personal mentions list
tg personal mentions confirm 1 person:7

mentions confirm записывает, что значение принадлежит человеку (или организации через organization:). После этого поиск вроде mentions:"person:7" находит эти сообщения. Ошибочное значение отклоняется командой mentions reject. Подробнее: Телефоны, ссылки и имена и Как всё связано.

Попросите агента

Запрос
Прежде чем я отвечу @example_user, напомни, кто это и что мы обсуждали за последний месяц. Покажи чаты и исходные сообщения. Отдели подтверждённые договорённости от вопросов без ответа. Только читай: не отвечай и не отмечай сообщения прочитанными.

Замените имя пользователя на имя или ID аккаунта. Если найдено несколько людей, выберите нужного до дальнейшего чтения. Ожидайте короткую сводку: кто это, где вы общались и какие вопросы остались. Агент должен указать, какая история была доступна.

Кто это

Оба мессенджера показывают профиль человека и общую переписку:

tg personal contacts show @example_user
max personal contacts show 20000002

contacts show отвечает и только из локального хранилища, с --offline. Человека называют по ID или части имени; в Telegram подойдёт и @username. Если части имени подходят несколько людей, команда перечислит их и остановится. Эти команды читают ваш аккаунт и сообщения, сохранённые на компьютере. Человеку ничего не отправляется, ничего не отмечается прочитанным.

Поля профиля зависят от того, что мессенджер показывает вашему аккаунту:

  • Номер телефона: показывается целиком, в командной строке и по MCP, если мессенджер отдаёт его вашему аккаунту. --hide-phone его убирает. Прежние выпуски маскировали номер и имели --show-phone; этого флага больше нет.
  • Дата регистрации: всегда с указанием источника. Telegram присылает месяц, когда человек пишет вам впервые; иначе tg оценивает дату по ID аккаунта и помечает её estimate. Оценка работает для аккаунтов, созданных до августа 2026 года; для более новых даты нет — лучше без даты, чем с неверной. MAX может сообщить точный день; max показывает его, когда он доступен.
  • Прежние имена: имена и имена пользователя, которые видела сохранённая история, — в aliases, от старых к новым, со ссылкой t.me для старого имени пользователя Telegram. Имя из сохранённых сообщений помечено source: messages и приблизительно: заново скачанное сообщение несёт новое имя.
  • Общие чаты: сколько его сообщений в локальном хранилище в каждом чате, первое и последнее из них. Если чат сохранён не с начала (complete: false), число — нижняя граница; messages sync <чат> дополнит хранилище.

Кто отреагировал

tg personal reactions list "Book club" 101
tg personal reactions list "Book club" 101 reaction:🔥 --limit 20

reactions list показывает, кто отреагировал на одно сообщение, от новых к старым: реакция и время. Слово reaction: с эмодзи оставляет одну реакцию. Если чат прячет список, например канал, команда так и скажет, а не покажет пустой список. В WhatsApp этой команды пока нет.

Что он писал

Оба мессенджера могут собрать контекст из сообщений, уже сохранённых на вашем компьютере:

tg personal contacts context @example_user --since-time 30d --limit 20
max personal contacts context 20000002 --since-time 30d --limit 20

Без --chat — обзор: общие чаты, последнее сообщение в каждую сторону, его недавние сообщения и где его упоминали другие. Назовите нужные чаты, чтобы получить его последние сообщения в каждом, от старых к новым, по умолчанию 20 на чат:

tg personal contacts context @example_user --chat "Книжный клуб" --chat "Работа" --limit 10
max personal contacts context 20000002 --chat "Книжный клуб" --chat "Работа" --limit 10

У каждого сообщения только время и текст, чтобы агент мог прочитать много сразу и сделать выжимку. -v добавляет номера сообщений и ссылки, -vv — сообщение целиком.

Ответ берётся из сохранённой истории, без подключения к мессенджеру. Отсутствие сообщений не доказывает, что обсуждения не было. С --chat параметр --sync-first сначала спрашивает мессенджер: Telegram ищет сообщения этого человека в каждом чате, MAX читает последнюю страницу каждого чата, потому что искать по отправителю он не умеет. Если нужна более ранняя переписка, откройте архив Telegram или архив MAX.

Похож ли аккаунт на бота

Проверка аккаунта доступна в обоих мессенджерах:

tg personal contacts check @example_user
max personal contacts check 20000002

В ответе — оценка и все причины, у каждой указан источник: отметки самого мессенджера, пустой профиль, новый аккаунт, только свежие фото, ссылка в первом сообщении, один и тот же текст в нескольких чатах. Оценка — подсказка, а не доказательство: у многих настоящих людей нет фото или описания. В unknown перечислено то, о чём судить было не по чему, поэтому низкая оценка при длинном unknown мало что значит. Полный список причин — в руководствах Telegram и MAX.

В Telegram tg ещё спрашивает два публичных списка спамеров — Combot Anti-Spam и lols.bot. Им уходит ID человека в Telegram. Параметр --no-registries отключает эти запросы. Списки ведут только аккаунты Telegram, поэтому max им ничего не отправляет.

Чтобы проверить всю группу, chats members check оценивает каждого участника по списку участников и сохранённой истории и перечисляет тех, у кого нашлась причина. --deep 10 затем делает полную проверку для десяти с самой высокой оценкой, по человеку в секунду. Владелец и администраторы в список не попадают, никто не удаляется:

tg personal chats members check "Книжный клуб" --deep 10
max personal chats members check "Книжный клуб" --deep 10

Один человек в двух мессенджерах

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

tg personal contacts link @example_user max:"Example User"

Оба аккаунта уже должны быть в истории на этом компьютере, поэтому tg и max нужны на одном компьютере. После этого contacts context без --chat собирает связанные учётные записи. contacts context --chat и contacts show показывают только выбранную учётную запись мессенджера. Одинакового имени недостаточно: считается только то, что записали вы. contacts unlink убирает эту локальную связь.

Свяжите почтовый адрес

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

tg personal contacts link @example_user email:rin@example.test

Замените имя пользователя и адрес настоящими учётными записями человека. Проверьте возвращённые идентификаторы: совпадения имён недостаточно. Связь меняет локальную запись о человеке, а не входы в аккаунты и почтовые ящики. contacts unlink разделяет указанную учётную запись, если связь неверна.

Для собственного контекста о человеке создайте заметку. Инструкция о заметках и тегах описывает метки на контакте, связанном человеке или конкретном сообщении. Команды заметок мессенджера есть в справочниках Telegram и MAX.

Что отличается в MAX

ОбязательностьTelegram (tg)MAX (max)
Дата регистрациимесяц от Telegram после первого контакта, иначе оценкаточный день, если его сообщает MAX
Отметки «мошенник», «фейк», «подтверждён», premiumпоказываютсяMAX не присылает их для личных аккаунтов
--sync-firstищет сообщения человека в каждом чатечитает последнюю страницу каждого чата
Публичные списки спамеровспрашиваются, если нет --no-registriesне спрашиваются
Лишние запросы на профильнет, кроме запросов contacts showодин на человека

Точные параметры — в справочнике Telegram и справочнике MAX.

Когда ответы читает агент

Если подключён MCP-сервер, агент получает те же профиль, контекст и проверку. Текст сообщений в этих ответах написали другие люди. Попросите агента считать этот текст источником и игнорировать просьбы внутри него. Защиты CLI не контролируют все действия агента.

Автоответы по вашим правилам

Автоответы — отдельная задача, которая может отправлять сообщения; чтение истории человека их не включает. Чем они отличаются от черновика, который показывает агент, объясняет страница черновики и шаблоны. Настройка — в автоответах Telegram и автоответах MAX.

Когда контекст понятен, попросите черновик ответа и проверьте текст перед разрешением на отправку.

Клиенты, коллеги и сделки

Перед звонком клиенту хочется видеть всю картину: его компанию, его роль в сделке, кому он подчиняется и о чем вы говорили. memo собирает эту картину из CRM, чатов, почты и календаря. У каждой связи в ней указано, насколько она надежна, а ответ называет то, что прочитать не удалось. Сначала синхронизируйте CRM, например через b24, чтобы ее контакты, компании и сделки попали в локальное хранилище.

Запрос
Используй memo CLI. Перед звонком с Alice из Acme Ltd покажи ее компанию, ее роль в наших открытых сделках, кому
она подчиняется и о чем мы говорили в прошлом месяце. Скажи, что известно только из CRM и что прочитать не удалось.

Агент находит человека и читает его контекст. Те же команды можно запустить самому:

memo search people alice
memo context person:3
memo organizations context organization:1
memo deals context deal:1 --brief
memo relationships list kind:reports-to 'to:"person:12"'
  • memo context person:<id> читает все аккаунты, которые видели человека: CRM, Telegram, почту и календари. Он работает и для человека, который есть только в CRM, и для имени, которое вы добавили через memo people add.
  • memo organizations context <ref> показывает людей организации по ролям, ее клиентов, поставщиков и партнеров, проекты, открытые сделки и лиды, счета и платежи как они сохранены, и открытые задачи. memo organizations list category:client показывает ваших клиентов, а supplier, partner и employer работают так же.
  • memo deals context <ref> показывает одну сделку: ее стадии, клиента, людей с ролями, ответственного, проект, деньги, а также сообщения, письма и встречи ее людей, пока сделка была открыта. --brief дает короткую форму для агента. memo leads context делает то же для лида.
  • memo relationships list фильтрует по kind:, role:, standing:, from:, to: и at:<day> (связь действовала в этот день). Завершенные связи он не показывает, пока вы не добавите include:ended. С about:<ref> каждая строка показывает еще и направление, и обратное название.

Что значит каждый вид, роль и статус: Деловые связи. Как держать рабочие аккаунты отдельно от личных: Поиск по сделкам CRM и работа отдельно.

Примеры

В примерах ниже учебное хранилище. Ваша компания Northstar Consulting, ее CRM это Битрикс24 по адресу example.bitrix24.com, а Acme Ltd ваш клиент. Alice и Bob контакты Acme, Emma и Dana работают в Northstar. У вас номера и имена будут другими.

Человек, который есть только в CRM. Emma сотрудница Northstar, аккаунта в мессенджере у нее нет. Ее контекст все равно отвечает, по данным CRM и вашего календаря:

$ memo context person:7
Emma  person:7
  email:emma@northstar.example
  bitrix24:example.bitrix24.com/user/u1  Emma
...
Business
Organizations
  Northstar Consulting  organization:2  member-of employee (Sales owner) reported by bitrix24:example.bitrix24.com
Reports to
  Dana  person:12  reports-to reported by bitrix24:example.bitrix24.com
Deals and leads
  Acme renewal · New  deal:1  related-to owner reported by bitrix24:example.bitrix24.com
Categories  employer
...
Not read: messages — no messenger identity is linked to them
Read: bitrix24:example.bitrix24.com, google-calendar:owner@northstar.example

«Sales owner» это ее должность, а роль employee. «Not read» говорит, что ее сообщения прочитать не удалось: к ней не привязан ни один аккаунт мессенджера.

Один человек в CRM и в Telegram. Alice контакт в CRM и пишет вам в Telegram. Когда ее аккаунт Telegram и контакт в CRM стали одним человеком, один контекст показывает и то, и другое:

$ memo context person:3
Alice  person:3
  email:alice@acme.example
  bitrix24:example.bitrix24.com/contact/7  Alice
  telegram:201  Alice

Last from them   2026-10-04 00:00  telegram  Alice: Can we renew Atlas before December?  msg:telegram/100/201/1
...
Business
Organizations
  Acme Ltd  organization:1  member-of contact (Procurement manager) reported by bitrix24:example.bitrix24.com
Deals and leads
  Acme renewal · New  deal:1  related-to contact reported by bitrix24:example.bitrix24.com
Categories  client
...
Read: bitrix24:example.bitrix24.com, google-calendar:owner@northstar.example, telegram:100

Контакт из CRM соединился с ее почтой, потому что адрес тот же. Аккаунт Telegram соединился, потому что вы его связали, например через tg personal contacts link. Совпадение имени никогда не соединяет два аккаунта.

Организация с сотрудниками и клиентами. Ваша компания показывает своих людей и своих клиентов:

$ memo organizations context organization:2
Northstar Consulting  organization:2  (your own)
Categories  employer
People
  Emma  person:7  member-of employee (Sales owner) reported by bitrix24:example.bitrix24.com
  person:1  person:1  member-of founder confirmed
  Dana  person:12  member-of employee (Head of sales) reported by bitrix24:example.bitrix24.com
Customers
  Acme Ltd  organization:1  customer-of confirmed
Written by its people  0 messages, 0 emails, 1 meetings
Read: bitrix24:example.bitrix24.com, google-calendar:owner@northstar.example
Not read: messages — no messenger identity is linked to them

person:1 это вы. Сотрудники пришли из CRM, поэтому они reported. Acme Ltd клиент, потому что так сказали вы, поэтому связь confirmed. memo organizations context organization:1 показывает то же со стороны Acme: Alice и Bob, Northstar в разделе Suppliers, открытую сделку, счет и открытую задачу.

Сделка с тем, кто принимает решение, и связанная встреча. CRM знает Alice как контакт сделки, а Emma как ответственную. То, что решение принимает Bob, известно от вас, потому что Битрикс24 не хранит роль контакта в сделке:

$ memo deals context deal:1 --brief
Acme renewal  deal:1  Example sales/New  open
client Acme Ltd; owner Emma; project Atlas
  Alice  person:3  contact  reported
  Emma  person:7  owner  reported
  Bob  person:5  decision-maker  confirmed
stages ∅ → New
invoiced issued 1200.00 EUR; paid none
1 messages, 1 emails, 1 meetings (proposed); 1 open tasks

Встреча это звонок со всеми тремя, пока сделка была открыта. Она помечена proposed: у нее со сделкой общие люди, и больше их ничего не связывает. Счет выставлен, ничего не оплачено. Стадия с названием Won тоже не платеж: деньги это то, что говорят счета и платежи. Без --brief ответ перечисляет встречу, письмо и сообщение со ссылками на них.

Подчинение и его источник. Emma подчиняется Dana. Запросите поля источника, чтобы увидеть, откуда это известно:

$ memo relationships list 'about:"person:7"' --json=id,from,to,kind,standing,account,derived
{"items":[...,{"id":"9","from":"person:7","to":"person:12","kind":"reports-to","standing":"reported",
"account":"bitrix24:example.bitrix24.com","derived":"department-head"}],...}

Об этом сообщил аккаунт CRM, а derived говорит, что связь выведена из руководителя отдела Emma. Никто ее не подтверждал. Со стороны Dana та же строка называется manages:

$ memo relationships list 'about:"person:12"'
9  Person «Emma» → Person «Dana»  manages  reported by bitrix24:example.bitrix24.com
10  Person «Dana» → Organization «Northstar Consulting»  member-of as employee (Head of sales)  reported by bitrix24:example.bitrix24.com

Подчинение, которое добавил агент, остается предложением, пока вы его не подтвердите:

$ memo relationships list 'about:"person:5"' kind:reports-to
1  Person «Alice» → Person «Bob»  manages  proposed by claude-code

Связь изменилась и ждет проверки. Вы переключили связи аккаунта CRM в review. Потом в CRM меняются две вещи: Alice уходит из Acme Ltd, а Bob становится контактом сделки. После следующей синхронизации:

$ memo relationships list 'about:"person:3"' include:ended
4  Deal «Acme renewal · New» (Atlas) → Person «Alice»  related-to as contact  reported by bitrix24:example.bitrix24.com
1  Person «Alice» → Person «Bob»  reports-to  proposed by claude-code
1  Person «Alice» → Organization «Acme Ltd»  member-of as contact (Procurement manager)  ended by bitrix24:example.bitrix24.com

$ memo review list kind:relationship
no project or account
2  relationship  Deal «Acme renewal · New» (Atlas) → Person «Bob» as contact  bitrix24  11-07
   reported by bitrix24:example.bitrix24.com
1  relationship  Person «Alice» → Person «Bob»  claude-code  11-07
   Alice said so on the renewal call
2 shown

Участие Alice в Acme ended, и оно осталось вместе с историей. Новая роль Bob ждет в memo review, а его роль decision-maker, которую дали вы, не изменилась. memo review confirm 2 делает новую роль вашей, а memo review reject 2 --reason "not on this deal" отклоняет ее, и синхронизация больше ее не предложит.

Чьи сделки копируются

В CRM отдела продаж большинство сделок принадлежит другим людям. Поэтому синхронизация копирует только сделки и лиды тех пользователей CRM, которых вы выбрали, и клиентов из них: контакты и компании, назначенные этим пользователям или указанные в скопированных сделках и лидах. Пока вы никого не выбрали, она копирует сделки того, кто вошел, то есть ваши. Когда вы выбрали пользователей, копируются только их сделки, поэтому добавьте и себя, если нужны ваши. Всю CRM не копирует ни одна синхронизация, в том числе администратора, а остальные клиенты остаются на портале, где их по-прежнему находит b24 work people list. Подробности для Битрикс24 в разделе чьи сделки и лиды:

b24 work users list                                                     # who is who on the portal
b24 work config set crm.bitrix24:example.bitrix24.com.unassigned 3327   # copy the deals and leads of user 3327

В списке может быть несколько пользователей, например вы сами и пользователь, от имени которого форма на сайте создает сделки. У каждой сделки Битрикс24 есть ответственный, по умолчанию пользователь, который ее создал (документация REST Битрикс24), поэтому сделки формы попадают в копию, только если вы выбрали этого пользователя. Вебхук администратора Битрикс24 может выбрать кого угодно. Любой другой может выбрать только себя, уволенного пользователя или пользователя, который не сотрудник, например внешнего пользователя или бота. Синхронизация каждый раз проверяет список, и пользователя, которого ей брать нельзя, пропускает с причиной в issues (crm.unassigned-dropped). Если пропущены все, кого вы выбрали, синхронизация копирует ваши сделки.

Что происходит, когда выбор меняется:

  • Сделка, отданная невыбранному пользователю, уходит из копии при следующей синхронизации, а сделка, отданная выбранному, появляется.
  • Заданный раньше scope со значением all следующая синхронизация отклоняет и просит поставить mine. После этого сделки и лиды невыбранных пользователей помечаются здесь удаленными, только по копии, без запросов к CRM.
  • Сделка вне копии уходит из списков и поиска, в b24 и в memo. Ее прежняя копия при этом остается в файле хранилища на вашем компьютере.
  • Если вы ни разу не задавали scope, а mine убрал бы больше половины сохраненных сделок или лидов, синхронизация их оставляет и говорит об этом (crm.narrowing-held). Копия остается как есть, пока вы не поставите scope в mine.

b24 work store status показывает, насколько продвинулся каждый вид записей и сколько их сохранено.

Копия одного аккаунта принадлежит одному пользователю CRM. Первая синхронизация запоминает его в crm.<provider>:<account>.self, а синхронизация от имени другого пользователя отклоняется. Чтобы передать копию, сбросьте эту настройку, и следующая синхронизация запомнит нового пользователя:

b24 work config unset crm.bitrix24:example.bitrix24.com.self

scope, unassigned и self меняете только вы: агенту в этом отказывают. Это защита от ошибки агента, а не граница безопасности: агент, который может запускать любые команды на вашем компьютере, может ее обойти.

Базовые стадии

Каждая CRM и каждая воронка в ней называет свои стадии по-своему. Базовые стадии — ваш собственный список стадий, один для сделок и один для лидов: колонки, по которым раскладываются ваши сделки во всех воронках и всех CRM. Каждая другая стадия сопоставляется с одной из них. Memo предлагает сопоставление, а вы его подтверждаете.

memo stages show deal
memo stages list confirmed:false
memo stages set stage:41 Proposal
memo stages confirm --pipeline pipeline:3
memo deals move deal:5 stage:3
  • memo stages show deal создает список при первом обращении и показывает каждую базовую стадию с ее открытыми сделками и сопоставленными с ней стадиями. Еще он показывает, что не разобрано: стадии, которые не сопоставлены или только предложены. Если у вас ровно одна своя воронка сделок и в ней есть открытые, успешные и проваленные стадии, списком становится она. Иначе memo создает стадии на первом языке из owner_languages (русском, пока вы его не задали): «Новая», «Квалификация», «Предложение», «Переговоры», «Выиграна» и «Проиграна». Списком для лидов становится ваша собственная воронка Leads.
  • memo stages create, rename, move и remove правят список. В каждом списке остается хотя бы одна открытая, одна успешная и одна проваленная стадия, а стадию, на которой стоят или стояли ваши собственные сделки или лиды, удалить нельзя.
  • memo stages list показывает все остальные стадии, из CRM и из ваших воронок, с их базовой стадией и признаком confirmed. Стадии CRM предлагаются при каждой синхронизации, по исходу и по месту в воронке. Подтвержденное сопоставление синхронизация никогда не меняет.
  • memo stages set сопоставляет одну стадию. memo stages confirm --pipeline <pipeline> подтверждает предложения одной воронки, а memo stages confirm --all — все.
  • memo deals move и memo leads move принимают stage:<id> базовой стадии и переносят вашу собственную сделку на ту единственную стадию ее воронки, которая с ней сопоставлена. Если таких стадий несколько, ответ — stage.choice-required с кандидатами: перенесите еще раз на одну из них по ее stage:<id>. Если ни одной, ответ — stage.unmapped: сначала сопоставьте стадию. Сделка, скопированная из CRM, переносится в самой CRM, инструментом, который называет ее writes_with (см. ниже).
  • В --json у каждой строки memo deals list и memo leads list есть base_stage. Он остается null, пока вы не подтвердите сопоставление стадии этой строки.

Агент может предложить сопоставление: его memo stages set остается предложением, пока вы его не подтвердите. Правка списков и memo stages confirm агенту запрещены. Как и с областью CRM, это защита от ошибок, а не граница безопасности.

Изменить сделку из CRM

Сделку, лид или воронку, скопированные из CRM, меняют в самой CRM, а не в memo, иначе следующая синхронизация отменит изменение. В --json у каждой такой строки memo deals list, memo leads list и memo pipelines list есть writes_with: инструмент, который ее меняет (tool, например b24), account строки и profile, под которым этот инструмент запускать. Например, агент читает memo deals list status:open --json, а затем запускает b24 с этим профилем, например b24 work deals move deal:12 "Quote sent".

profile задан, только если на этом аккаунте работал ровно один профиль этого инструмента. Иначе он null, profiles перечисляет кандидатов, а why говорит, что выбрать: агент спрашивает вас, какой профиль взять, и никогда не выбирает сам. В группе профиль аккаунта вне группы никогда не называется. У ваших собственных сделок "writes_with": null, потому что их меняет сам memo.

Телефоны, ссылки, имена и адреса

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

Что такое упоминание

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

Каждое упоминание хранится в одной стандартной записи, поэтому поиск находит значение, как бы оно ни было написано. +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.

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

Попросите агента

Запрос
Найди в моей истории Telegram все сообщения, где кто-то присылал номер +1 555 010 0100. Покажи чат, дату и сообщение вокруг. Только чтение: не отвечай и не отмечай сообщения прочитанными.
Запрос
Перечисли ссылки на google.com, которые мне присылали в MAX за прошлый месяц, по чатам. Только чтение.
Запрос
Найди в Telegram сообщения, где писали об Анне Смирновой, в любом падеже. Только чтение.

Агент ищет в истории, сохранённой на вашем компьютере. Если какого-то чата или периода там нет, пустой ответ не доказывает, что значение никто не присылал: сначала загрузите эту историю.

Поиск по значению

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

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: находит номер с любыми пробелами, дефисами и скобками. Пишите его с кодом страны и +. Номер без + читается в ваших странах. Номер из восьми цифр и больше находит и сохранённый номер, который кончается этими цифрами.
  • email: находит адрес в любом регистре. Берите его в кавычки: у @ в запросе своё значение.
  • domain: находит все ссылки и все адреса этого сайта, включая поддомены.
  • url: находит одну ссылку. Параметры отслеживания вроде utm_source и часть после # не учитываются.

Значение из файла или голосового сообщения находит сообщение, к которому пришёл файл. Поля сочетаются с остальным языком запросов, например domain:example.com AND date>=2026-09-01.

Номера без кода страны

Люди пишут местный номер по-местному: 612 345 678 в Испании, 8 900 000-00-01 в России. Скажите инструментам, в каких странах ваши контакты, сначала самую вероятную:

tg personal config set phone_countries es,ru

Тогда номер без + читается как номер первой страны, которой он подходит. Настройка покрывает большую часть Европы, США и Канаду и действует для всех инструментов, которые делят локальное хранилище. Без неё номер без + читается как российский. После изменения прочитайте сохранённые номера заново командой mentions rebuild phone; ваши решения остаются при своих номерах.

Поиск в почте

В сохранённой почте работают те же поля. Почту ищет memo:

memo search mail 'domain:example.com'
memo search mail 'phone:"+1 555 010 0100"'
memo search mail 'url:"https://news.example.com/click?id=1"'
memo search mail 'link:"/click?id=1"'

В почте много ссылок отслеживания, каждая в одном письме. memo хранит такую ссылку один раз на письмо, как её сайт, поэтому domain: по-прежнему находит все письма. url: по-прежнему находит письмо по полной ссылке: он читает текст письма. link: находит письма, в ссылках которых есть кусок, например путь или id=1; регистр латинских букв не важен. Ссылку и её часть берите в кавычки: ?, / и = в запросе значат другое.

Просмотр найденного

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

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, place), значение, статус и сообщение. show добавляет текст вокруг и сколько ещё мест содержат то же значение. list в tg и max показывает только упоминания в сообщениях; упоминания в почте показывает memo mentions list --source email:<имя>, а в заметках и документах — --source notes или --source documents.

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

tg personal mentions list --new

--new сдвигает точку просмотра, только когда показал всё, поэтому обрезанная страница не пропустит упоминание. Когда messages sync сохраняет сообщения с новыми упоминаниями, его ответ называет их число и предлагает эту команду.

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

max personal mentions domains

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

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

Отметьте, что это за значение

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.
  • Ссылка t.me на чат или человека из вашей истории связывается с этим чатом или аккаунтом без вас.
  • Почтовый адрес подтверждается без владельца: confirm 40 сохраняет его как место. См. Почтовые адреса.

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

Подтверждение и отклонение меняют только локальное хранилище на вашем компьютере. Ничего не отправляется, аккаунт в мессенджере не меняется. Хранилище записывает, кто решил. Команда, запущенная в терминале агента, где задана переменная AI_AGENT или CLAUDECODE, записывается как решение агента; --as-owner записывает её как ваше. Если разрешения вашего профиля не позволяют эти изменения, ошибка назовёт настройку, которую нужно поменять.

Имена людей

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

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

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

tg personal mentions list kind:person-name status:found
tg personal mentions confirm 31 person:7
tg personal mentions confirm 31 person:7 --all-in-chat
tg personal search messages 'mentions:"person:7"'

--all-in-chat решает имя и во всех других местах того же чата, где его ещё никто не решил. В рабочем чате одна Ольга обычно один человек.

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

Находятся и имена людей, которых инструменты не знают, и ждут вас. Такое имя — распространённое имя в любом падеже («Ольге», «Sarah») или отчество с именем перед ним («Анзор Мамедович»), вместе с фамилией или вторым именем рядом («Ольга Смирнова», «John Smith»). Имя, которое бывает и обычным словом, например «Вера», «Надежда» или «Grace», считается только рядом со вторым именем. Правила такие имена ни с кем не связывают; кто это, скажут show и confirm.

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

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

Почтовые адреса

Почтовый адрес находится по форме: слово улицы рядом с названием и номером дома. Читаются адреса России, остальной Европы, Великобритании и США: «ул. Ленина, д. 5», «Невский проспект 28», «Calle Mayor, 12», «12 rue de la Paix», «Hauptstraße 5», «221B Baker Street». Число само по себе, цена или индекс адресом не бывают никогда.

Упоминание берёт и остаток адреса: квартиру или офис, индекс, город, регион и страну, в том числе со следующих строк подписи в письме. Совпадение ищется только по улице и дому, поэтому «C/ Colón 5» и «Calle Colón, 5, 46004 Valencia» — один адрес. Две одноимённые улицы в двух городах пока тоже считаются одним адресом.

tg personal mentions list kind:place
tg personal mentions confirm 40
tg personal mentions places

confirm сохраняет адрес как отдельное место, со всем, что там написано. Все упоминания того же адреса следуют за ним, а новые связываются без вас. mentions places показывает места, сначала самые упоминаемые. Больше всего адресов в подписях писем; memo показывает упоминания в почте командой memo mentions list --source email:<имя>.

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

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

tg personal mentions rebuild
max personal mentions rebuild

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

Номера телефонов и приватность

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

Чего пока нет

  • Список упоминаний в заметках и документах и в почте: они находятся и ищутся, но mentions list их не показывает.
  • Связь ссылки на обычный сайт с чем-либо. Такую ссылку можно только отклонить.
  • Места, кроме почтовых адресов: город сам по себе, название здания, место, описанное словами.
  • Адреса за пределами Европы, Великобритании и США: они могут найтись не целиком.

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