ШІ-асистент

ШІ-асистент дає змогу описати роботу звичайною мовою, а TikMatrix поставить її в чергу за вас. Він читає ваші пристрої, облікові записи та історію завдань, показує точно те, що збирається створити, і чекає на ваше схвалення, перш ніж щось записати.

Потрібен Pro

Асистент доступний на плані Pro та вище — та сама вимога, що й для локального API автоматизації.

Що це таке (і чим воно не є)

Асистент не торкається ваших телефонів напряму. Він працює так само, як ви: дивиться, що у вас є, а потім ставить завдання в чергу, які підхоплює й виконує звичайний виконавець завдань. Усе, що він створює, з'являється у списку завдань як будь-яке інше, з джерелом assistant.

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

Налаштування

Модель надаєте ви самі. TikMatrix не постачає жодної й не проксіює ваші запити — застосунок звертається до налаштованої вами кінцевої точки безпосередньо з вашої машини.

1. Натисніть Асистент на лівій панелі навігації.
2. Натисніть Налаштування моделі.
3. Заповніть:

Поле	Що вказати
Кінцева точка	Повна адреса chat-completions, наприклад https://api.openai.com/v1/chat/completions
Модель	Ідентифікатор моделі, наприклад gpt-4o або claude-sonnet-4-5
Ключ API	Ваш ключ у цього постачальника
Формат API	Лишайте Визначати за кінцевою точкою, якщо визначення не помиляється
Ліміт завдань на одне підтвердження	Найбільша кількість завдань, яку може створити одне схвалення (типово 200)

4. Натисніть Зберегти.

Щойно налаштування прийнято, рядок стану вгорі панелі показує використовувану модель, тож ви одразу бачите, до якої кінцевої точки піде розмова.

Які кінцеві точки працюють

Підтримуються два формати обміну:

• Сумісний з OpenAI — будь-яка кінцева точка, що розуміє POST /v1/chat/completions. Сюди належать і сама OpenAI, і більшість самостійно розгорнутих серверів: vLLM, LocalAI, сумісний з OpenAI шар Ollama, DeepSeek, OpenRouter тощо.
• Anthropic — кінцеві точки, що розуміють POST /v1/messages.

Формат API зазвичай лишають на Визначати за кінцевою точкою: адреса, що містить api.anthropic.com або /v1/messages, вважається Anthropic, решта — сумісною з OpenAI. Указуйте явно лише тоді, коли використовуєте проксі, з адреси якого діалект не видно.

Оберіть модель, що вміє викликати інструменти

Асистент працює цілком через виклики інструментів. Модель без надійної підтримки інструментів спілкуватиметься з вами, але так нічого й не спланує.

Як обрати модель

Якщо ви хочете	Використовуйте
Найнадійніше планування з мінімумом нагляду	Сучасну флагманську модель OpenAI або Anthropic
Нижчу вартість рутинної роботи на кшталт «постав це на всю стійку»	Модель середнього рівня тих самих постачальників
Щоб нічого не залишало вашу машину	Локальний сервер (Ollama, vLLM, LocalAI) з моделлю, міцною у викликах інструментів

Невеликі локальні моделі — типова причина ситуації «спілкується, але ніколи не планує». Перш ніж вирішити, що асистент зламаний, спробуйте той самий запит один раз на розміщеній у хмарі моделі — якщо там усе працює, проблема була в моделі, а не в налаштуваннях.

Де зберігаються налаштування

Ваша кінцева точка й ключ записуються у assistant_settings.json у каталозі даних застосунку, і бекенд читає їх під час надсилання запиту. Вони не надсилаються нікуди, крім налаштованої вами кінцевої точки.

Одне налаштування існує лише в цьому файлі: max_tokens — бюджет відповіді, що передається моделі. Типово 8192, обмежений діапазоном 1024–64000. Збільште вручну, якщо довгі відповіді обриваються.

Як просити про роботу

Пишіть звичайною мовою те, що вам потрібно. Кілька прикладів:

• Прогрій усі облікові записи по 20 хвилин
• Чому мої останні завдання зазнали невдачі?
• Опублікуй на всіх пристроях завтра о 09:00
• Підпишися на ці п'ять облікових записів із телефонів у групі Marketing

Запит зазвичай проходить три кроки:

1. Він з'ясовує. Які пристрої онлайн, які облікові записи авторизовані, які параметри приймає скрипт.
2. Він планує. Обчислює, скільки саме завдань дасть запит, і показує підсумки — скільки завдань, на скількох пристроях і облікових записах.
3. Ви підтверджуєте. Лише тоді завдання записуються.

Якщо запит двозначний так, що це змінює кількість створених завдань, асистент запитує, а не вгадує.

Який вигляд має запит від початку до кінця

Ви: прогрій усі авторизовані облікові записи по 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 Застосунок не зміг встановити з'єднання. Перевірте адресу та чи справді локальна кінцева точка слухає на тому порту.

Модель відповідає, але нічого не планує Найімовірніше, вона не викликає інструментів. Спробуйте модель із міцною підтримкою інструментів і перевірте, чи Формат API відповідає діалекту вашої кінцевої точки.

Кожна відповідь обривається Деякі сумісні з OpenAI сервери типово сильно обмежують вивід. Підніміть ліміт на сервері або збільште max_tokens у assistant_settings.json.

Він постійно перепитує про платформу Ця збірка керує і TikTok, і Instagram. Назвіть потрібну прямо в запиті.

Картка підтвердження не підтверджується Плани втрачають чинність через 15 хвилин. Попросіть те саме ще раз, щоб отримати свіжий.

Завдання створено, але нічого не виконується Найімовірніше, вимкнено Auto WakeUp Agent — асистент попереджає про це перед підтвердженням. Увімкніть його знову в Налаштуваннях.

Далі

• Власні скрипти — пишіть і реєструйте автоматизацію, якої немає у вбудованих скриптах
• Огляд локального API — керуйте тією самою чергою завдань зі своїх програм
• Налаштування завдань — як завдання з черги підхоплюються й виконуються