# MAX: Автоответы (/ru/docs/max/replies)

Настройте правила автоответов и выберите получателей. Проверьте шаблон и условия, разрешения и способ остановить автоматические ответы.

[Выбрать черновики или автоответы](/llms.mdx/docs/ru/drafts-and-templates/content.md)

Эта страница — о том, как автоматически отвечать на сообщения в MAX, когда вы не можете ответить
сами: например, коротко написать «отвечу утром» тем, кто пишет после рабочего дня. Прочитав её,
вы получите работающий автоответ: правило с вашим текстом, выбор того, кто может получить ответ, способ заранее проверить, что оно ответило бы, ничего не отправляя, и готовые тексты
со страницы [Черновики и шаблоны ответов](/llms.mdx/docs/ru/drafts-and-templates/content.md).

Несколько слов, которые встретятся ниже:

- **Правило** говорит, на какие входящие сообщения реагировать и что делать: ответить, открыть
  задачу или и то и другое.
- **Шаблон** — текст ответа. В нём можно подставить имя отправителя и время.
- **Аудитория** — люди и чаты, которым вообще можно отвечать, что бы ни говорило правило.
- `max personal serve` — фоновый процесс, который получает новые сообщения и применяет правила.

Кто получает ответ и когда что-то отправляется:

- **Ответ получает каждый, кого выбрали правила, пока вы не ограничите аудиторию.** Отвечать только
  выбранным людям: `max personal replies audience --reply listed --allow-people …`; исключить кого-то:
  `--deny-people` и `--deny-chats`.
- **Ничего не отправляется, пока вы не включите отправку.** Нужно `permissions.replies.send allow`;
  `ask` тоже запрещает отправку, потому что у фонового сервера некого спросить. Новое правило
  тоже выключено, пока вы его не включите.

Полная справка — [команды автоответов](/llms.mdx/docs/ru/max/commands/content.md#max-replies).

## Создать и включить правило [#создать-и-включить-правило]

```sh
max personal replies add away
max personal replies edit away --template 'Спасибо, {{ sender.firstName | default: "вам" }}! Отвечу утром.'
max personal replies edit away --outside 09:00-19:00 --days mon-fri --timezone Europe/Madrid
max personal replies edit away --per-chat 1/12h --per-person 1/1d
```

`add` создаёт выключенное правило со всеми текущими настройками. Файл
`<профиль>.replies.json` находится рядом с `config_file` из `max config show --json`.
По умолчанию правила отвечают всем, кого выбрали. Чтобы отвечать только выбранным людям,
перечислите их id в MAX через запятую; `max personal contacts show <имя> --json` показывает id человека
в поле `id`:

```sh
max personal replies audience --reply listed --allow-people 1000001
```

Чтобы отвечать всем, кроме некоторых людей или чатов, оставьте `--reply all` и запретите их:

```sh
max personal replies audience --deny-people 1000002 --deny-chats 1000003
```

После первой команды в файле:

```json
{
  "audience": {
    "reply": "listed",
    "allow": { "people": ["1000001"], "chats": [] },
    "deny": { "people": [], "chats": [] }
  },
  "rules": [ … ]
}
```

Имена правил — строчные буквы, цифры и дефис; повторный id отвергается. Правило с действием `reply` нельзя включить
без текста шаблона. Для выключенного правила и действия `task` пустой текст допустим.

```sh
max personal replies test --since-time 7d
max personal replies on away
max personal config set permissions.replies.send allow
max personal serve
```

`replies test` читает только сохранённые сообщения: ничего не отправляет, ничего не меняет
и не подключается к MAX. Без разрешения отправки сервер молчит.
`max personal replies off away` выключает одно правило.

## Редактировать условия и аудиторию [#редактировать-условия-и-аудиторию]

`replies edit` меняет только переданные поля. Списки через запятую заменяются целиком;
пустая строка очищает список. Id остаются строками, включая большие числа.

| Поля | Опции |
|---|---|
| Действия | `--do reply,task` — ответ, задача или оба действия |
| Чаты | `--kinds dialog,group`, `--allow-chats`, `--deny-chats` |
| Условия | `--words`, `--question` / `--no-question`, `--mentions-me` / `--no-mentions-me` |
| Отправители | `--allow-people`, `--deny-people`, `--contacts-only` / `--no-contacts-only` |
| Ответ | `--template`, `--as-reply` / `--no-as-reply` |
| Лимиты | `--per-chat`, `--per-person`, например `1/12h` |
| Рабочее время | `--outside`, `--days`, `--timezone`, `--no-hours` |

Первое задание времени требует окно, дни и часовой пояс вместе; позднее можно изменить
одно поле. `--no-hours` очищает окно и несовместим с его полями. Перед записью проверяются
исходный файл и весь результат. Неверная правка не перезаписывает файл; другие правила,
аудитория, порядок правил и история ответов сохраняются.

`max personal replies audience` показывает общую аудиторию файла. Новый файл — это `--reply all`:
он отвечает любому, кого выбрало правило. `--reply listed` отвечает только разрешённым людям и чатам. Опции `--allow-people`,
`--allow-chats`, `--deny-people`, `--deny-chats` заменяют соответствующие списки.
Запрет побеждает разрешение. При `listed` с пустым списком никто не получает ответ;
команда предупреждает об этом.
Действие `task` открывает локальную задачу и не ограничивается аудиторией ответов.

## Шаблоны Liquid и модель [#шаблоны-liquid-и-модель]

Примеры текстов ответа для частых случаев и когда лучше оставить черновик — на странице
[Черновики и шаблоны ответов](/llms.mdx/docs/ru/drafts-and-templates/content.md).

Доступны `sender.firstName`, `sender.name`, `chat.title`, `chat.kind` и `now` в часовом
поясе правила, либо UTC без окна времени. Можно использовать фильтры, например
`{{ now | date: "%H:%M" }}`. Текст входящего сообщения не является переменной шаблона.
Неизвестные переменные и фильтры отвергаются; `default` обрабатывает отсутствующие значения.
Чтение файлов из шаблона запрещено, время, память и длина результата ограничены.

Модель может изменить только блок `ai`; текст вне блока остаётся вашим текстом
с обычными подстановками:

```liquid
Спасибо, {{ sender.firstName | default: "вам" }}!
{% ai %}Коротко подтвердите получение; я отвечу завтра.{% else %}Отвечу завтра.{% endai %}
```

Тело блока после подстановок — инструкция. Входящий текст передаётся модели отдельно
как данные. Её ответ не исполняется как Liquid; слишком длинный ответ или полный повтор
входящего текста отвергается. Если провайдер не настроен, нет согласия или вызов не удался,
используется `else`. Без него ответ пропускается с объяснением.

Настройте `models.replies.provider` (`openai` или `anthropic`), точный id модели в
`models.replies.model` и при необходимости `models.replies.base_url`. Общие значения
берутся из `models.default`; `provider off` выключает назначение. `config set` и
`config unset` принимают эти ключи, `config show` показывает источник каждого поля.
Ключ хранится через `max personal models keys set`; для своего сервера имя ключа — его host
с портом, и ключ публичного провайдера туда не передаётся.

Согласие на модель отдельно от права отправлять ответы:

```sh
max personal replies consents show
max personal replies consents grant
max personal replies consents revoke
```

`grant` разрешает передавать входящие данные выбранному провайдеру для всего профиля.
`replies consents deny` с id чата запрещает модель для этого чата; `allow` с id снимает
этот запрет, но не выдаёт согласие на профиль. Запреты сохраняются при grant/revoke.
Смена провайдера или endpoint требует нового согласия. Изменение согласия, настроек,
правила, аудитории или pause во время вызова проверяется перед отправкой результата.

`max personal replies test` показывает инструкции и запасной текст без вызова модели.
`max personal replies test --ai` явно разрешает передать сохранённые сообщения настроенной модели
с действующим согласием. Это не отправляет ответ в мессенджер и не меняет историю ответов;
`--ai` несовместим с `--offline`.
Старые `{firstName}`, `{name}` и `model: may-reword` читаются с предупреждением:
исходный заполненный шаблон остаётся запасным текстом. В новом файле поле `model` не нужно.

## Что правило не трогает [#что-правило-не-трогает]

- Тех, кого аудитория не разрешает.
- Ваши сообщения, каналы, ботов, сообщения от имени чата.
- Изменённое сообщение, уже обработанное сообщение и то, что пришло до запуска `serve`.
- В группе — сообщение без упоминания вас или ответа вам, если правило не называет группу в `chats`.

Лимиты `perChat` и `perPerson` обязательны. Два автоответчика останавливаются на первом лимите.

`max personal replies pause` немедленно останавливает все правила, `resume` отменяет паузу;
перезапуск не нужен. `status` показывает разрешение отправки, включённые правила и аудиторию.
`max personal sends list` показывает отправленные ответы с пометкой правила.
