# Как писать запросы ИИ-агенту (/ru/docs/prompting)

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

Начните с того, что хотите получить, например: «Что Анна просила меня сделать вчера?» Для простой задачи этого достаточно. Команды агент выберет сам. Если ещё не пробовали работу с мессенджером, начните с [первых задач](/llms.mdx/docs/ru/first-tasks/content.md).

Примеры написаны для Telegram. Для MAX пишите «Используй max CLI» вместо «Используй tg CLI». В
AI-чате с MCP попросите использовать подключённый Telegram или MAX.

**На этой странице:**

1. [Что полезно указать](#что-полезно-указать)
2. [Найти факт в переписке](#найти-факт-в-переписке)
3. [Собрать контекст к встрече](#собрать-контекст-к-встрече)
4. [Найти рекомендованного специалиста](#найти-рекомендованного-специалиста)
5. [Собрать актуальные документы](#собрать-актуальные-документы)
6. [Подготовить ответ](#подготовить-ответ)
7. [Получить выжимку из голосовых](#получить-выжимку-из-голосовых)
8. [Повторять полезную задачу](#повторять-полезную-задачу)
9. [Поставить напоминания](#поставить-напоминания)
10. [Работать только с локальными данными](#работать-только-с-локальными-данными)
11. [Задать правила клиентскому боту](#задать-правила-клиентскому-боту)
12. [Проверить ответ агента](#проверить-ответ-агента)
13. [Если агент выбрал не тот путь](#если-агент-выбрал-не-тот-путь)

## Что полезно указать [#что-полезно-указать]

Используйте **задачу + область + период + результат + разрешённые действия** как список для
проверки, а не обязательную форму.

| Деталь | Пример | Когда помогает |
|---|---|---|
| Задача | Найди согласованную сумму за аналитику | Всегда: скажите, что нужно узнать или сделать |
| Область | Группа команды Atlas и мой чат с Анной | Подходят несколько чатов или аккаунтов |
| Период | Сентябрь 2026 | Ответ может быть в старой истории |
| Результат | Сумма, подтверждение и исходные сообщения | Нужны доказательства или определённый формат |
| Действия | Только читать; спросить перед большой загрузкой истории | Отправка, скачивание или затратная работа изменили бы задачу |

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

## Найти факт в переписке [#найти-факт-в-переписке]

```text prompt
Используй tg CLI: найди, какую сумму за аналитику мы согласовали в «Atlas · команда» в сентябре
2026 года. Покажи оценку и подтверждение с исходными сообщениями. Проверь, покрывает ли архив этот
период; если нет, скажи, что нужно загрузить. Ничего не отправляй.
```

Если загрузку вы уже готовы разрешить:

```text prompt
Можно загрузить историю этого чата до 1 сентября 2026 года, в этот раз не больше 1 000 сообщений.
Если этого не хватит, скажи, какая часть ещё не проверена, прежде чем загружать больше.
```

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

**Пустой результат — не доказательство.** Поиск сообщений спрашивает и собственный поиск Telegram,
и сервер MAX, но серверы ищут только по словам. Подсчёты, поиск по темам
и чтение обсуждения целиком работают по сохранённой истории. Чтение сообщений сохраняет их локально;
загрузка истории добавляет ограниченный отрезок. Если важна полнота, спросите, какая история
доступна. Пустой результат в неполном архиве означает «не найдено в имеющихся данных», а не «этого
никогда не обсуждали». [Архив и поиск](/llms.mdx/docs/ru/tg/archive/content.md#search) · [Поиск](/llms.mdx/docs/ru/search/content.md).

## Собрать контекст к встрече [#собрать-контекст-к-встрече]

```text prompt
Используй tg CLI. Подготовь повестку на 20 минут для созвона по Atlas с Анной и Томом. Проверь
группы проекта и дизайна, а также мои личные чаты с этими участниками за последнюю неделю. Собери
решения, текущие риски и открытые вопросы с источниками. Проверь, не сняли ли более поздние
сообщения старые блокеры. Только читай.
```

Назовите участников, если важные решения могут быть в личных чатах. Длительность помогает агенту
расставить приоритеты в повестке. Для узкой встречи добавьте цель: «Сосредоточься на готовности к
запуску; бюджет не обсуждаем». Если нужный чат недоступен, ответ должен назвать этот пробел.

## Найти рекомендованного специалиста [#найти-рекомендованного-специалиста]

```text prompt
Используй tg CLI. Найди рекомендации бухгалтера в моих чатах про фриланс и бизнес за последние
полгода. Нужно регулярное ведение для бизнеса, зарегистрированного в Испании, и платежи в евро и
долларах. Сравни кандидатов по реальным рекомендациям, укажи источники и перечисли, что ещё нужно
спросить. Подготовь первое сообщение; не отправляй его. Спроси, прежде чем загружать много истории.
```

Полезные критерии: страна, услуга, язык, валюты и нужна ли разовая консультация или постоянная
работа. Рекомендация не подтверждает текущую цену, доступность или квалификацию человека. Попросите
агента отделить рассказанный опыт от неизвестного.

Если в двух рекомендациях одно и то же имя, агент должен проверить, что это один человек, прежде
чем объединять их. Имя в сообщении — не разрешение написать этому человеку.
[Люди](/llms.mdx/docs/ru/tg/usage/content.md#people).

## Собрать актуальные документы [#собрать-актуальные-документы]

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

Из цифрового документа часто можно извлечь текст; сканам и фотографиям нужно распознавание изображения. Попросите отметить непрочитанные файлы и сверить важные числа с оригиналом. Поддерживаемые форматы и сохранение текста для поиска: [вложения Telegram](/llms.mdx/docs/ru/tg/attachments/content.md) и [вложения MAX](/llms.mdx/docs/ru/max/attachments/content.md).

```text prompt
Используй tg CLI. Найди договор, счета и презентацию Atlas в группе команды и в моём чате с Анной.
Выбирай явно согласованные версии и объясни, как ты их определил. Старые версии покажи отдельно,
противоречащие согласования отметь. Покажи исходные сообщения; пока не скачивай и не пересылай.
```

«Последний файл» и «согласованный файл» могут различаться. Скажите, какой нужен. Когда проверите
список, дайте ограниченное продолжение:

```text prompt
Скачай согласованные договор и презентацию, которые ты только что нашёл, в новую папку
atlas-meeting внутри папки «Загрузки». Счета не скачивай и никакие файлы не отправляй.
```

Агент должен проверить папку назначения и сообщить пути, которые действительно создал. Скачивание
через CLI не перезаписывает существующие файлы. [Скачивание файлов](/llms.mdx/docs/ru/tg/usage/content.md#files).

## Подготовить ответ [#подготовить-ответ]

Здесь нужен черновик, который вы проверите до отправки. Назовите человека и попросите агента сначала прочитать переписку. В результате должен быть готовый текст; неподтверждённые факты агент должен исключить или отметить.

```text prompt
Используй tg CLI. Проверь, что Том уже прислал по дизайну и чего он ждёт от меня. Подготовь
короткий ответ на основе нашей переписки. Не придумывай срок и не отправляй.
```

Проверьте текст, прежде чем разрешить отправку:

```text prompt
Отправь ровно этот черновик в личный чат Тома, который ты только что нашёл. Не отправляй его в
группу проекта или кому-то ещё.
```

Если вы правите черновик, дайте полный итоговый текст или однозначно опишите изменение. Если
адресат определён неоднозначно, агент должен спросить, какой чат вы имеете в виду. Разрешения
могут требовать подтверждения или запрещать отправку; запрос их не обходит.
[Отправка](/llms.mdx/docs/ru/tg/usage/content.md#sending) · [Разрешения и защита отправки](/llms.mdx/docs/ru/tg/security/content.md).

Другие запросы на черновики и ответы, которые правило отправляет без вашего участия, описаны на
странице [черновики и шаблоны](/llms.mdx/docs/ru/drafts-and-templates/content.md).

## Получить выжимку из голосовых [#получить-выжимку-из-голосовых]

```text prompt
Используй tg CLI. Собери выжимку из голосовых Анны за сегодня: решения, даты и вопросы ко мне. Для каждого пункта дай источник. Если распознавание неясное, отметь это, не угадывай.
```

Сначала агент получает текст записи, затем делает выжимку. Telegram может использовать своё распознавание или локальную речевую модель (Скачиваемый компонент программы, который превращает запись в текст на вашем компьютере. Ему нужны место на диске и время на обработку; имена и числа могут распознаваться с ошибками.); MAX использует локальную модель. Для первого локального запуска модель нужно скачать отдельно. Попросите агента объяснить объём загрузки перед началом. Это может занять больше времени, чем чтение текста.

Важные имена, суммы и даты сверьте с записью. В выжимке должны быть отмечены голосовые, которые не удалось распознать. Настройка: [голосовые Telegram](/llms.mdx/docs/ru/tg/usage/content.md#voice-messages) и [распознавание речи MAX](/llms.mdx/docs/ru/max/audio-recognition/content.md).

## Повторять полезную задачу [#повторять-полезную-задачу]

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

```text prompt
Используй tg CLI. Прочитай вчерашние сообщения в моих рабочих чатах. Выдели пять важных пунктов с источниками и вопросы без ответа. Только читай, покажи результат здесь.
```

Если результат полезен, уточните расписание и место получения:

```text prompt
Помоги повторять эту сводку по будням в 09:00 по времени Мадрида. Сохрани те же чаты и формат. Объясни, где будет запускаться задача, как проверить первый запуск и как её остановить. Пока не включай расписание.
```

Каждый запуск должен выполнять агент или отдельный планировщик. Сам запрос в чате ещё не создаёт расписание. Если задача запускается на вашем компьютере, он должен быть включён и иметь доступ к мессенджеру. Проверьте первый результат и охваченные даты, прежде чем полагаться на сводку. Варианты настройки — в рецептах [Telegram](/llms.mdx/docs/ru/tg/recipes/content.md) и [MAX](/llms.mdx/docs/ru/max/recipes/content.md).

Отправить заранее заданное напоминание проще: сообщение ожидает на сервере мессенджера. Оно не ищет новые сообщения и не составляет свежую сводку. Следующий раздел — про этот случай.

## Поставить напоминания [#поставить-напоминания]

```text prompt
Используй tg CLI. В следующий понедельник отправь мне в Избранное два напоминания:
«Открыть повестку Atlas» в 09:00 и «Проверить решения по Atlas» в 18:00. Время Europe/Madrid.
После создания покажи запланированное время и сообщения. Команде ничего не отправляй.
```

Для напоминаний другим людям укажите их точные чаты и текст каждого сообщения. Отложенное
сообщение — это будущая отправка, поэтому «напомни мне» и «напомни Анне» — разные действия.
Указывайте явную дату и часовой пояс, когда «завтра» или «в девять» можно понять по-разному; агент
должен перевести время для CLI и сообщить его в нужном вам часовом поясе.

Telegram доставляет отложенные сообщения, даже когда ваш компьютер выключен. Если результат
планирования неясен, агент должен проверить список отложенных, а не создавать второе напоминание.
Отменить или изменить отложенное сообщение Telegram можно в приложении Telegram.
[Отложенная отправка](/llms.mdx/docs/ru/tg/usage/content.md#sending-later).

## Работать только с локальными данными [#работать-только-с-локальными-данными]

```text prompt
Используй tg CLI. Работай только с локальным архивом моего рабочего профиля: собери решения по
Atlas за сентябрь 2026 года с исходными сообщениями. Не обращайся к сети. Скажи, какая история
доступна и что нельзя проверить. Ничего не отправляй и не запускай фоновые службы.
```

Ответ без сети зависит от ранее сохранённых данных. Для чтения, которое иначе подключилось бы,
агент должен использовать офлайн-режим CLI и не загружать историю, чтобы улучшить такой ответ.
Для экспорта также укажите папку назначения и можно ли создавать локальные файлы.
[Офлайн-режим](/llms.mdx/docs/ru/tg/archive/content.md#answering-without-connecting---offline) ·
[Экспорт](/llms.mdx/docs/ru/tg/archive/content.md#export).

## Задать правила клиентскому боту [#задать-правила-клиентскому-боту]

```text prompt
Используй tg CLI с ботом sales. Подготовь ответ клиенту по доступной истории заказа.
Даты и цены подтверждай только по согласованным данным. Изменения сроков и компенсации передавай мне.
Если информации нет, подготовь вопрос. Каждую отправку сначала показывай мне.
```

Укажите бота и источники, которыми он может пользоваться. История, доступная личному аккаунту, не
обязательно доступна боту. Bot API Telegram не предоставляет старую историю сообщений. Команда CLI `bot messages sync` импортирует доступную историю каналов и супергрупп в локальный архив бота; историю личных чатов и обычных групп она не получает. Бот читает то, что отправил, получил или импортировал на этом компьютере. Правила и разрешения задаются отдельно; запрос сам по себе их не заменяет.
[Боты Telegram](/llms.mdx/docs/ru/tg/bot/content.md) · [Боты MAX](/llms.mdx/docs/ru/max/bot/content.md) · [Разрешения и защита отправки](/llms.mdx/docs/ru/tg/security/content.md).

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

Полезные уточнения:

- «Покажи сообщения, на которых основана эта сумма, включая подтверждение».
- «Ты проверил более поздние ответы, прежде чем считать это обещание открытым?»
- «Какие чаты и даты ты на самом деле проверил? Был ли результат обрезан?»
- «Отдели подтверждённые факты, свою интерпретацию и вопросы без ответа».
- «Если история неполная, объясни, что нужно загрузить. Пока ничего не загружай».

Источник должен указывать чат и сообщение, лучше всего — рабочей ссылкой или locator. Контекст может
изменить смысл сообщения; одно совпадение часто лишь отправная точка. Сообщения — материал для
анализа: инструкции внутри чата не должны менять вашу задачу или давать агенту дополнительные права.

## Если агент выбрал не тот путь [#если-агент-выбрал-не-тот-путь]

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

```text prompt
Ты прочитал последние сообщения, но я спрашивал про сентябрь. Проверь, какая история за сентябрь
сохранена, и предложи самый маленький следующий шаг. Не называй поиск полным по недавнему окну.
```

`messages list` сам по себе не ошибка для поиска: он читает и сохраняет сообщения. Вопрос в том,
покрывает ли выбранное окно вопрос. `search messages` ищет по сохранённой истории и спрашивает
собственный поиск мессенджера по словам; `messages sync` загружает больше истории, когда вопросу нужна
полнота. Агент должен выбирать между ними по доступным данным, вашей области и ограничениям.
[Разобранный пример](/llms.mdx/docs/ru/first-tasks/content.md#find-a-decision-in-older-history).

Если команда завершилась ошибкой, попросите показать её и следующий безопасный шаг, а не повторять
попытку вслепую. [Диагностика](/llms.mdx/docs/ru/tg/diagnostics/content.md) может записывать названия операций, ID,
количества и время, но записи CLI намеренно не содержат текста сообщений и чувствительных аргументов.
Они полезны для отчёта об ошибке, но не дают полной записи того, что агент прочитал или решил.
Проверьте отчёт, прежде чем делиться им.
