ИИ-ассистент
ИИ-ассистент позволяет описать работу обычными словами, а TikMatrix поставит её в очередь. Он читает ваши устройства, аккаунты и историю задач, показывает ровно то, что собирается создать, и ждёт вашего одобрения, прежде чем что-либо записать.
Ассистент доступен на плане Pro и выше — то же требование, что и у локального API автоматизации.
Что это такое (и чем не является)
Ассистент не управляет телефонами напрямую. Он работает так же, как вы: смотрит, что у вас есть, а затем ставит задачи в очередь, которые подхватывает и выполняет обычный исполнитель задач. Всё созданное им появляется в списке задач как обычная задача с источником assistant.
Он также не может ничего записать самостоятельно. Любое действие, изменяющее состояние, останавливает разговор и сначала спрашивает вас — см. Ничего не выполняется без вашего одобрения.
Настройка
Модель предоставляете вы. TikMatrix не поставляет свою и не проксирует ваши запросы — приложение обращается к настроенному вами эндпоинту напрямую с вашей машины.
- Нажмите Ассистент на левой панели навигации.
- Нажмите Настройки модели.
- Заполните:
| Поле | Что указать |
|---|---|
| Эндпоинт | Полный URL chat-completions, например https://api.openai.com/v1/chat/completions |
| Модель | Идентификатор модели, например gpt-4o или claude-sonnet-4-5 |
| API-ключ | Ваш ключ для этого провайдера |
| Формат API | Оставьте Определять по эндпоинту, если определение не ошибается |
| Лимит задач на одно подтверждение | Максимум задач, которые может создать одно одобрение (по умолчанию 200) |
- Нажмите Сохранить.
После принятия настроек строка состояния вверху панели показывает используемую модель, так что видно, к какому эндпоинту пойдёт разговор.
Какие эндпоинты работают
Поддерживаются два формата обмена:
- OpenAI-совместимый — любой эндпоинт, понимающий
POST /v1/chat/completions. Сюда входят сам OpenAI и большинство самостоятельно развёрнутых серверов: vLLM, LocalAI, OpenAI-совместимый слой Ollama, DeepSeek, OpenRouter и подобные. - Anthropic — эндпоинты, понимающие
POST /v1/messages.
Формат API обычно оставляют на Определять по эндпоинту: URL, содержащий api.anthropic.com или /v1/messages, считается Anthropic, всё остальное — OpenAI-совместимым. Указывайте явно, только если вы используете прокси, по URL которого диалект не угадать.
Ассистент работает целиком через вызовы инструментов. Модель без надёжной поддержки инструментов будет с вами беседовать, но так ничего и не спланирует.
Как выбрать модель
| Если вам нужно | Используйте |
|---|---|
| Самое надёжное планирование, минимум присмотра | Актуальную флагманскую модель OpenAI или Anthropic |
| Меньшую стоимость рутинной работы «поставь это на всю стойку» | Модель среднего уровня тех же провайдеров |
| Чтобы ничего не покидало вашу машину | Локальный сервер (Ollama, vLLM, LocalAI) с моделью, уверенно вызывающей инструменты |
Небольшие локальные модели — обычная причина «оно болтает, но ничего не планирует». Прежде чем решить, что ассистент сломан, попробуйте тот же запрос на размещённой модели: если так всё работает, проблема была в модели, а не в настройках.
Где хранятся настройки
Эндпоинт и ключ записываются в assistant_settings.json в каталоге данных приложения, и бэкенд читает их при отправке запроса. Никуда, кроме настроенного вами эндпоинта, они не отправляются.
Одна настройка живёт только в этом файле: max_tokens — бюджет ответа, передаваемый модели. По умолчанию 8192, ограничен диапазоном 1024–64000. Увеличьте вручную, если длинные ответы обрезаются.
Как просить о работе
Пишите обычными словами. Примеры:
- Прогрей все аккаунты по 20 минут
- Почему упали мои последние задачи?
- Опубликуй на всех устройствах завтра в 09:00
- Подпишись на эти пять аккаунтов с телефонов из группы Marketing
Обычно запрос проходит три шага:
- Он смотрит. Какие устройства онлайн, какие аккаунты залогинены, какие параметры принимает скрипт.
- Он планирует. Вычисляет, сколько именно задач породит запрос, и показывает итоги — сколько задач, на скольких устройствах и аккаунтах.
- Вы подтверждаете. Только после этого задачи записываются.
Если запрос двусмыслен так, что это меняет число создаваемы х задач, ассистент спросит, а не будет угадывать.
Как выглядит запрос целиком
Вы: прогрей все залогиненные аккаунты по 20 минут, начиная завтра в 9 утра
Ассистент: (вызывает
get_script_schema,list_devices,list_accounts, затемplan_tasks) 34 задачи прогрева на 12 устройствах и 34 аккаунтах, по 20 минут, старт 2026-08-27 09:00. Два аккаунта не залогинены и исключены.
Появляется карточка подтверждения со списком каждой строки, которую он собирается создать, — устройство, аккаунт и цель, если скрипт её принимает, — плюс точный script_config, который будет записан. Вы нажимаете Подтвердить, и в списке задач появляются 34 задачи.
Указание времени
Задачи можно поставить на потом: упомяните время, и ассистент внесёт его в план как время старта задачи, а карточка покажет это до одобрения. Это же верный ответ на крупный запрос — растянуть подписки целой стойки на день выглядит куда менее автоматизированно, чем выпустить их разом, и на рискованных запросах ассистент сам это предложит.
На сборках, работающих с обоими приложениями
Сборка TikMatrix, настроенная и на TikTok, и на Instagram, не станет угадывать, что вы имели в виду: запрос без платформы вернётся встречным вопросом. Скажите «опубликуй в TikTok на группе Marketing» вместо «опубликуй на группе Marketing», и он сразу перейдёт к планированию. Одноплатформенные сборки никогда об этом не спрашивают.
Ничего не выполняется без вашего одобрения
Это обеспечено кодом, а не вежливой просьбой к модели.
Когда ассистент берётся за что-то, меняющее состояние, разговор останавливается и появляется карточка подтверждения с описанием предстоящего. Вызов выполняется только после нажатия кнопки подтверждения.
Так защищены четыре действия:
| Действие | Что делает |
|---|---|
create_tasks | Ставит запланированные задачи в очередь |
stop_task | Останавливает выполняющуюся задачу |
retry_task | Повторно ставит в очередь упавшую задачу |
create_custom_script | Записывает и регистрирует новый файл скрипта |
У создания задач есть второй замок: кнопка подтверждения может выполнить только тот план, который вам показали. Ассистент не может изменить параметры между предпросмотром и вашим одобрением — план одноразовый и истекает через 15 минут, поэтому предпросмотр, от кото рого вы отошли, нельзя подтвердить позже против уже изменившегося списка устройств.
Карточка — не пересказ, написанный моделью. Она отображает реальные строки плана и реальный script_config, поэтому вы одобряете именно то, что будет записано.
Отказ — нормальный ответ, а не ошибка: модели сообщают, что вы отказали, и она может предложить что-то другое вместо повтора того же вызова.
Потолок по числу задач
Одно подтверждение может создать не более 200 задач по умолчанию. Это тормоз на случай неверно понятого запроса — чтобы «прогрей мои аккаунты» не превратилось в тысячу задач, которые вы обнаружите утром. Большие прогоны по-прежнему возможны: ассистент разобьёт их на партии, подтверждаемые по одной.
Лимит меняется в Настройки модели → Лимит задач на одно подтверждение. Значения выше 2000 обрезаются.
Что видит ассистент
Этим он пользуется свободно, без вопросов:
| Инструмент | Что читает |
|---|---|
list_devices | Подключённые устройства, онлайн ли и заняты ли они, принадлежность к группам |
list_accounts | Аккаунты, устройство каждого и статус входа |
list_groups | Группы устройств и их размеры |
get_script_schema | Все скрипты этой сборки и точные параметры каждого |
list_tasks | Список задач с фильтром по статусу, устройству или скрипту |
get_task_log | Журнал одной задачи — обычно причина сбоя именно там |
get_activity_log | Недавняя активность аккаунтов |
device_screenshot | Что сейчас на экране устройства |
list_custom_scripts | Ваши зарегистрированные пользовательские скрипты |
get_custom_script_guide | Как написать пользовательский скрипт |
plan_tasks | Вычисляет, что создаст запрос, ничего не создавая |
device_screenshot отправляет изображение экрана телефона на настроенный вами эндпоинт. Если на экране может быть что-то, что вы не хотели бы передавать стороннему провайдеру, не просите скриншоты или направьте ассистента на модель, которую вы размещаете сами.
Что покидает вашу машину
Всё, что читает ассистент, отправляется на ваш эндпоинт как часть разговора — именно так модель это видит. На практике это серийные номера устройств и названия групп, имена аккаунтов и их статус входа, строки задач и журналы задач, а также любой запрошенный вами скриншот. API-ключей, учётных данных прокси и паролей аккаунтов среди доступного ему нет, поэтому в запросе их никогда не бывает.
Если этот список — больше, чем вы готовы отдать стороннему провайдеру, направьте эндпоинт на модель, которую запускаете сами; всё остальное в работе функции не изменится.
Написание пользовательских скриптов
Если ни один встроенный скрипт не подходит, ассистент может написать новый. Опишите задачу обычными словами; он прочитает руководство по написанию скриптов, составит программу и покажет её вам.
Карточка подтверждения для этого прямо об этом говорит: скрипт записывается на диск и регистрируется, чтобы его можно было запускать как встроенный. Прочитайте его перед одобрением. Скрипты попадают в папку assistant_scripts в каталоге данных приложения, поэтому всё написанное им можно проверить, отредактировать или удалить в одном месте.
Несколько ограничений, которые приложение накладывает на любое предложение модели:
- Интерпретатором могут быть только
python,python3,node,bunиdeno— ничего, что запустило бы шелл с полезной нагрузкой после него. - Имя файла должно быть простым: без разделителей пути, без
.., без ведущей точки, не длиннее 64 символов. - Исходник ограничен 200 КБ, а платформа должна быть
generic,tiktokилиinstagram.
Зарегистрированный скрипт дальше — обычный пользовательский скрипт: его можно открыть в Устройства → Пользовательские скрипты, изменить команду, поменять таймаут или отключить. Что скрипт может делать после регистрации, см. в Пользовательских скриптах.
Ограничения, о которых стоит знать
- Один запрос — двенадцать шагов. Если после двенадцати вызовов инструментов ассистент не закончил, он останавливается и сообщает, что осталось нерешённым, вместо того чтобы жечь ваши токены в цикле.
- Разговор — не архив. Он хранится в памяти — восемь последних разговоров и по 120 последних реплик в каждом — и теряется при перезапуске приложения. Всё, что стоит сохранить, становится задачей, а задачи лежат в базе данных.
- Уходить со страницы безопасно. Ветка разговора и незакрытое подтверждение восстанавливаются при возвращении.
- Стоп завершает цикл на ближайшей контрольной точке. Прервать уже отправленный запрос к модели он не может, поэтому текущий шаг сначала доработает.
- Токены оплачиваете вы. Каждый запрос несёт каталог скриптов и весь разговор до этого момента, поэтому сообщение в длинной ветке стоит дороже, чем в новой. Для несвязанной работы начать новый разговор дешевле, чем продолжать старый.
Диагностика
API access requires Pro or higher plan
Ваша лицензия — Starter или неактивна. Проверьте Настройки → Лицензия.
The app is still starting up. Try again in a moment.
Панель открылась до того, как фоновые службы завершили запуск. Подождите несколько секунд и отправьте снова.
No model endpoint configured / No API key configured / No model configured
Откройте Настройки модели и заполните все три поля: эндпоинт, модель и API-ключ.
Could not reach the model endpoint
Приложение не смогло установить соединение. Проверьте URL и то, что локальный эндпоинт действительно слушает на этом порту.
Модель отвечает, но ничего не планирует Скорее всего, она не вызывает инструменты. Попробуйте модель с уверенной поддержкой вызова инструментов и проверьте, что Формат API соответствует диалекту вашего эндпоинта.
Каждый ответ обрывается
Некоторые OpenAI-совместимые серверы по умолчанию сильно ограничивают вывод. Поднимите лимит на сервере или увеличьте max_tokens в assistant_settings.json.
Он постоянно спрашивает про платформу Эта сборка работает и с TikTok, и с Instagram. Назовите нужную прямо в запросе.
Карточка подтверждения не подтверждается Планы истекают через 15 минут. Попросите то же самое ещё раз, чтобы получить свежий план.
Задачи созданы, но ничего не выполняется Скорее всего, выключен Auto WakeUp Agent — ассистент предупреждает об этом до подтверждения. Включите его в Настройках.
Что дальше
- Пользовательские скрипты — пишите и регистрируйте автоматизацию, которой нет во встроенных скриптах
- Обзор локального API — управляйте той же очередью задач из своих программ
- Настройки задач — как поставленные в очередь задачи подхватываются и выполняются