Ассистент в мессенджере

Ассистент Telegram и MAX работает от имени пользователя через общий Rocket Home API. Владелец, член семьи и гость получают те же права, что в кабинете и общем API, включая ограничения комнат, групп и автоматизаций. Каталог инструментов задан явно: новые операции API не становятся инструментами автоматически. Зависимости от MCP нет; публичный OAuth продолжает работать.

Функция и внешняя передача выключены по умолчанию. Выбор модели сам по себе их не включает. До пилота требуется решение владельца сервиса о цели обработки, получателях и условиях передачи данных; порядок выкатки находится в docs/specs/assistant/README.md. Эта страница описывает подготовленное поведение, а не разрешение на включение функции.

Настроить канал

1. Откройте «Настройки → Ассистент» в Janus и привяжите Telegram или MAX.

2. Выберите модель, режим и включите ассистента для нужного канала. Сохраните изменения. Новая привязка Telegram/MAX получает выключенный ассистент и режим «С подтверждениями». Включение, режим и модель меняются только в Janus.

3. Отправьте /assistant в личном чате и выберите доступный вам дом.

Настройки каждого канала независимы. Выбор канала обычных уведомлений не включает ассистента и не меняет его режим. Команды /assistant_access, /assistant_request и /assistant_revoke направляют в настройки Janus; отдельного TOTP и выдачи прав владельцем больше нет.

Для будущего веб-чата подготовлен контекст с идентичностью из сессии Janus, без обращения к bot. Веб-канал всегда включён и начинает с подтверждений; перед использованием нужно выбрать модель. Интерфейс веб-чата появится отдельно.

Подтвердить действие

Чтение не требует подтверждения. В режиме «С подтверждениями» изменение показывает объект, операцию и проверенные сервером точные параметры. Карточка действует пять минут.

• «Разрешить один раз» выполняет только представленное действие.

• «Разрешать всегда» выполняет действие и сохраняет разрешение для его точного повторения этим пользователем в том же чате и доме.

• «Отклонить» отменяет карточку без исполнения и без постоянного запрета.

Разрешение на яркость одной лампы 40% не разрешает 70%, выключение или другую лампу. Сопоставление выполняет сервер по пользователю, привязке, дому, инструменту, объекту, нормализованным параметрам и версии конфигурации. Модель не создаёт разрешения и не определяет совпадение. Переключения сначала превращаются в конкретное целевое состояние. Если точное повторение нельзя связать с объектом, кнопки «Разрешать всегда» нет.

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

Команды устройствам используют GET .../devices/{device}/live-state и POST .../devices/{device}/commands общего API. Значение command_sent означает отправку команды; наблюдение состояния не доказывает выполнение конкретной команды. Полные схемы — в /api-docs.

Удалить разрешение и данные

В карточке каждого канала Janus показывает сохранённые разрешения. Удалите одно или нажмите «Удалить все разрешения». Отдельного срока у разрешений нет. Правка логики автоматизации или существенной конфигурации устройства делает связанные разрешения недействительными. Обычное изменение состояния этого не делает.

Смена режима, модели, отключение, перепривязка и изменение прав аннулируют ожидающие карточки и неиспользованные разрешения исполнения. Отключение, перепривязка, смена модели и изменение прав также удаляют затронутые сохранённые разрешения. Переход в Yolo не исполняет старые карточки. Потеря доступа очищает затронутую историю. Уже отправленную устройству команду отозвать нельзя.

Переписка, аргументы и результаты хранятся не более 24 часов. Технический аудит с основанием исполнения (чтение, Yolo, точное разрешение или однократное подтверждение) хранится 90 дней. Выгрузка профиля включает настройки, разрешения и собственную историю; удаление аккаунта очищает эти данные.

Внутренний контракт настроек и событий — openapi/assistant-internal-api.yaml версии 3.0.0. При переходе со старой схемы миграция удаляет гранты, данные фактора и старые ожидающие действия. Они не включают каналы и не превращаются в разрешения «Разрешать всегда».

Модель пилота

Каталог сервера ограничен YandexGPT Pro 5.1. В Tower редактируются название, включение, предел ответа и суточный лимит резервирования. Адрес API, каталог, идентификатор модели и реквизиты подключения задаются сервером. Суточный счётчик резервирует размер запросов и предел ответа; это не точный расход токенов и не денежный бюджет. Начальные лимиты — 1024 токена ответа и 1000000 единиц суточного резервирования.

При обновлении прежние модели отключаются, а связанные контексты, карточки, история и разрешения аннулируются. Новая модель создаётся выключенной; Telegram и MAX миграция не включает. Только синтетический пилот разрешён отдельным решением. Настройка стенда и ротация ключа описаны в docs/specs/assistant/yandex-stage-runbook.md, проект политики — в docs/specs/assistant/yandex-privacy-draft.md.