Asystent AI
Asystent AI pozwala opisać pracę zwykłym językiem i zlecić TikMatrixowi jej zakolejkowanie. Czyta twoje urządzenia, konta i historię zadań, pokazuje dokładnie, co by utworzył, i czeka na twoją akceptację, zanim cokolwiek zostanie zapisane.
Asystent jest dostępny od planu Pro wzwyż — to samo wymaganie co dla lokalnego API automatyzacji.
Czym jest (a czym nie)
Asystent nie dotyka twoich telefonów bezpośrednio. Pracuje tak jak ty: patrzy, co masz, a potem kolejkuje zadania, które podejmuje i wykonuje zwykły wykonawca zadań. Wszystko, co utworzy, pojawia się na liście zadań jak każde inne, oznaczone źródłem assistant.
Nie może też sam niczego zapisać. Każde działanie zmieniające stan zatrzymuje rozmowę i najpierw pyta ciebie — zobacz Nic nie zadziała bez twojej zgody.
Konfiguracja
Model dostarczasz sam. TikMatrix nie dołącza żadnego i nie pośredniczy w twoich żądaniach — aplikacja rozmawia z endpointem, który skonfigurujesz, bezpośrednio z twojej maszyny.
- Kliknij Asystent na lewym pasku nawigacji.
- Kliknij Ustawienia modelu.
- Wypełnij:
| Pole | Co wpisać |
|---|---|
| Endpoint | Pełny adres chat-completions, np. https://api.openai.com/v1/chat/completions |
| Model | Identyfikator modelu, np. gpt-4o albo claude-sonnet-4-5 |
| Klucz API | Twój klucz do tego dostawcy |
| Format API | Zostaw na Wykryj z endpointu, chyba że pomyli się w wykrywaniu |
| Limit zadań na jedno potwierdzenie | Najwięcej zadań, jakie może utworzyć jedna akceptacja (domyślnie 200) |
- Kliknij Zapisz.
Po przyjęciu ustawień wiersz stanu na górze panelu pokazuje używany model, więc od razu widzisz, do którego endpointu pójdzie rozmowa.
Jakie endpointy działają
Obsługiwane są dwa formaty:
- Zgodny z OpenAI — dowolny endpoint mówiący
POST /v1/chat/completions. Obejmuje to samo OpenAI i większość serwerów uruchamianych we własnym zakresie: vLLM, LocalAI, warstwę zgodną z OpenAI w Ollamie, DeepSeek, OpenRouter i podobne. - Anthropic — endpointy mówiące
POST /v1/messages.
Format API zwykle zostawia się na Wykryj z endpointu: adres zawierający api.anthropic.com albo /v1/messages traktowany jest jako Anthropic, cała reszta jako zgodna z OpenAI. Ustawiaj to ręcznie tylko wtedy, gdy używasz proxy, którego adres nie zdradza dialektu.
Asystent działa wyłącznie przez wywołania narzędzi. Model bez niezawodnej obsługi narzędzi będzie z tobą rozmawiał, ale nigdy nie zdoła niczego zaplanować.
Jak wybrać model
| Jeśli chcesz | Użyj |
|---|---|
| Najbardziej niezawodnego planowania, najmniej nadzoru | Aktualnego czołowego modelu OpenAI lub Anthropic |
| Niższych kosztów przy rutynowym „wrzuć to na całą półkę" | Modelu średniej klasy od tych samych dostawców |
| Żeby nic nie opuszczało twojej maszyny | Lokalnego serwera (Ollama, vLLM, LocalAI) z modelem solidnym w wywoływaniu narzędzi |
Małe modele lokalne to typowa przyczyna sytuacji „rozmawia, ale nigdy nie planuje". Zanim uznasz, że asystent jest zepsuty, spróbuj tego samego zapytania raz na modelu hostowanym — jeśli tam zadziała, problemem był model, a nie konfiguracja.
Gdzie przechowywane są ustawienia
Twój endpoint i klucz zapisywane są w assistant_settings.json w katalogu danych aplikacji i odczytywane przez backend przy wysyłaniu żądania. Nie są wysyłane nigdzie poza skonfigurowany przez ciebie endpoint.
Jedno ustawienie istnieje tylko w tym pliku: max_tokens, czyli budżet odpowiedzi wysyłany do modelu. Domyślnie 8192, ograniczony do zakresu 1024–64000. Podnieś go ręcznie, jeśli długie odpowiedzi są ucinane.
Zlecanie pracy
Napisz zwykłym językiem, czego chcesz. Kilka przykładów:
- Rozgrzej wszystkie konta przez 20 minut
- Dlaczego moje ostatnie zadania się nie powiodły?
- Opublikuj na wszystkich urządzeniach jutro o 09:00
- Zaobserwuj te pięć kont z telefonów w grupie Marketing
Żądanie przechodzi zwykle przez trzy kroki:
- Sprawdza. Które urządzenia są online, które konta są zalogowane, jakie parametry przyjmuje skrypt.
- Planuje. Wylicza, ile dokładnie zadań powstanie z żądania, i pokazuje sumy — ile zadań, na ilu urządzeniach i kontach.
- Ty potwierdzasz. Dopiero wtedy zadania są zapisywane.
Jeśli żądanie jest niejednoznaczne w sposób zmieniający liczbę tworzonych zadań, asystent pyta, zamiast zgadywać.
Jak wygląda żądanie od początku do końca
Ty: rozgrzej wszystkie zalogowane konta przez 20 minut, start jutro o 9 rano
Asystent: (woła
get_script_schema,list_devices,list_accounts, a potemplan_tasks) 34 zadania rozgrzewki na 12 urządzeniach i 34 kontach, po 20 minut każde, start 2026-08-27 09:00. Dwa konta nie są zalogowane i zostały pominięte.
Pojawia si ę karta potwierdzenia z listą każdego wiersza, który zamierza utworzyć — urządzenie, konto oraz cel, jeśli skrypt go przyjmuje — plus dokładna script_config, która zostanie zapisana. Naciskasz Potwierdź i 34 zadania pojawiają się na liście.
Wskazanie terminu
Zadania można zakolejkować na później: wspomnij godzinę, a asystent wpisze ją do planu jako czas startu zadania, który karta pokaże przed akceptacją. To także właściwa odpowiedź, gdy żądanie jest duże — rozłożenie obserwacji z całej półki na cały dzień wygląda znacznie mniej automatycznie niż wystrzelenie ich naraz, a przy żądaniach wyglądających ryzykownie asystent sam to zaproponuje.
W kompilacjach obsługujących obie aplikacje
Kompilacja TikMatrix skonfigurowana dla TikToka i Instagrama nie zgaduje, którą masz na myśli, i nawet nie próbuje — żądanie bez platformy wraca z pytaniem. Powiedz „opublikuj na TikToku w grupie Marketing" zamiast „opublikuj w grupie Marketing", a przejdzie od razu do planowania. Kompilacje jednoplatformowe nigdy o to nie pytają.
Nic nie zadziała bez twojej zgody
Jest to wymuszone w kodzie, a nie przez uprzejmą prośbę do modelu.
Kiedy asystent sięga po cokolwiek, co zmienia stan, rozmowa zatrzymuje się i pojawia się karta potwierdzenia pokazująca, co ma się wydarzyć. Wywołanie wykonuje się dopiero po naciśnięciu przez ciebie przycisku potwierdzenia.
Cztery działania są tak zabezpieczone:
| Działanie | Co robi |
|---|---|
create_tasks | Kolejkuje zaplanowane zadania |
stop_task | Zatrzymuje działające zadanie |
retry_task | Ponownie kolejkuje nieudane zadanie |
create_custom_script | Zapisuje i rejestruje nowy plik skryptu |
Tworzenie zadań ma na dodatek drugą blokadę: przycisk potwierdzenia może wykonać wyłącznie ten plan, który ci pokazano. Asystent nie może zmienić parametrów między podglądem a twoją akceptacją — plan jest jednorazowy i wygasa po 15 minutach, więc podglądu, od którego odszedłeś, nie da się potwierdzić później wobec listy urządzeń, która zdążyła się zmienić.
Karta nie jest też streszczeniem napisanym przez model. Rysuje rzeczywiste wiersze planu i rzeczywistą script_config, więc to, co akceptujesz, jest tym, co zostanie zapisane.
Odmowa to normalna odpowiedź, a nie błąd: model dostaje informację, że powiedziałeś nie, i może zaproponować coś innego zamiast powtarzać to samo wywołanie.
Górny limit zadań
Jedno potwierdzenie może domyślnie utworzyć najwyżej 200 zadań. To hamulec na wypadek źle zrozumianego żądania — żeby „rozgrzej moje konta" nie zamieniło się w tysiąc zadań, które odkryjesz rano. Większe przebiegi nadal są możliwe: asystent dzieli je na partie potwierdzane pojedynczo.
Limit zmienisz w Ustawienia modelu → Limit zadań na jedno potwierdzenie. Wartości powyżej 2000 są przycinane.
Co asystent widzi
Z tego korzysta swobodnie, bez pytania:
| Narzędzie | Co czyta |
|---|---|
list_devices | Podłączone urządzenia, czy są online lub zajęte, przynależność do grup |
list_accounts | Konta, urządzenie każdego z nich i czy jest zalogowane |
list_groups | Grupy urządzeń i ich rozmiary |
get_script_schema | Wszystkie skrypty, jakie potrafi uruchomić ta kompilacja, i ich dokładne parametry |
list_tasks | Listę zadań, filtrowalną po statusie, urządzeniu lub skrypcie |
get_task_log | Dziennik jednego zadania — zwykle to tam niepowodzenie samo się tłumaczy |
get_activity_log | Ostatnią aktywność kont |
device_screenshot | Co jest teraz na ekranie urządzenia |
list_custom_scripts | Twoje zarejestrowane własne skrypty |
get_custom_script_guide | Jak napisać własny skrypt |
plan_tasks | Wylicza, co powstałoby z żądania, nie tworząc niczego |
device_screenshot wysyła obraz ekranu telefonu do skonfigurowanego przez ciebie endpointu. Jeśli na ekranie może pojawić się coś, czego wolałbyś nie wysyłać zewnętrznemu dostawcy, nie proś o zrzuty albo skieruj asystenta na model, który hostujesz sam.
Co opuszcza twoją maszynę
Wszystko, co asystent przeczyta, trafia do twojego endpointu jako część rozmowy — tak właśnie model to widzi. W praktyce oznacza to numery seryjne urządzeń i nazwy grup, nazwy użytkowników kont i ich stan zalogowania, wiersze zadań i dzienniki zadań oraz każdy zrzut ekranu, o który poprosisz. Kluczy API, danych logowania do proxy ani haseł kont nie ma wśród rzeczy, które może przeczytać, więc nigdy nie znajdą się w wysyłanych danych.
Jeśli ta lista przekracza to, co chcesz oddać zewnętrznemu dostawcy, skieruj endpoint na model, który uruchamiasz sam; poza tym w tej funkcji nic się nie zmienia.
Pisanie własnych skryptów
Jeśli żaden wbudowany skrypt nie obejmuje tego, czego potrzebujesz, asystent może napisać nowy. Opisz zadanie zwykłym językiem; przeczyta przewodnik po pisaniu skryptów, napisze program i pokaże ci go.
Karta potwierdzenia dla tej akcji wyraźnie o tym mówi: skrypt zostaje zapisany na dysku i zarejestrowany tak, by dało się go uruchamiać jak każdy wbudowany. Przeczytaj go przed akceptacją. Skrypty lądują w folderze assistant_scripts w katalogu danych aplikacji, więc wszystko, co napisał, możesz sprawdzić, zmienić albo usunąć w jednym miejscu.
Kilka ograniczeń, które aplikacja narzuca temu, co zaproponuje model:
- Jako interpreter można zarejestrować tylko
python,python3,node,bunideno— nic, co uruchomiłoby powłokę z doczepionym ładunkiem. - Nazwa pliku musi być zwykłą nazwą: bez separatorów ścieżki, bez
.., bez kropki na początku, najwyżej 64 znaki. - Kod źródłowy jest ograniczony do 200 KB, a platforma musi być
generic,tiktokalboinstagram.
Od tej chwili zarejestrowany skrypt jest zwyczajnym własnym skryptem: możesz go otworzyć w Urządzenia → Własne skrypty, zmienić polecenie, limit czasu albo go wyłączyć. Co skrypt może robić po rejestracji — zobacz Własne skrypty.
Ograniczenia warte poznania
- Jedno żądanie, dwanaście kroków. Jeśli asystent nie skończy po dwunastu wywołaniach narzędzi, zatrzymuje się i zgłasza, co pozostało nierozwiązane, zamiast palić twoje tokeny w pętli.
- Rozmowa nie jest archiwum. Trzymana jest w pamięci — osiem najnowszych rozmów i po 120 ostatnich tur każdej — i znika po restarcie aplikacji. To, co warto zachować, kończy jako zadanie, a zadania są w bazie danych.
- Przejście na inny ekran jest bezpieczne. Wątek i każde oczekujące potwierdzenie zostają przywrócone po powrocie.
- Zatrzymaj kończy pętlę w najbliższym punkcie kontrolnym. Nie przerwie wywołania modelu, które już poleciało, więc bieżący krok najpierw się dokończy.
- Tokeny płacisz ty. Każde żądanie niesie katalog skryptów i całą dotychczasową rozmowę, więc długi wątek kosztuje więcej na wiadomość niż świeży. Do niepowiązanej pracy taniej jest zacząć nową rozmowę niż ciągnąć starą.
Rozwiązywanie problemów
API access requires Pro or higher plan
Twoja licencja to Starter albo jest nieaktywna. Sprawdź Ustawienia → Licencja.
The app is still starting up. Try again in a moment.
Panel otworzył się, zanim usługi w tle skończyły się uruchamiać. Odczekaj kilka sekund i wyślij ponownie.
No model endpoint configured / No API key configured / No model configured
Otwórz Ustawienia modelu i wypełnij wszystkie trzy: endpoint, model i klucz API.
Could not reach the model endpoint
Aplikacja nie mogła otworzyć połączenia. Sprawdź adres i to, czy lokalny endpoint faktycznie nasłuchuje na tym porcie.
Model odpowiada, ale nigdy nic nie planuje Prawdopodobnie nie woła narzędzi. Spróbuj modelu z solidną obsługą narzędzi i sprawdź, czy Format API pasuje do dialektu twojego endpointu.
Każda odpowiedź jest ucięta
Niektóre serwery zgodne z OpenAI domyślnie mocno ograniczają wyjście. Podnieś limit na serwerze albo zwiększ max_tokens w assistant_settings.json.
Ciągle pyta o platformę Ta kompilacja obsługuje TikToka i Instagrama. Wskaż w żądaniu, o którą ci chodzi.
Karta potwierdzenia nie chce potwierdzić Plany wygasają po 15 minutach. Poproś o to samo jeszcze raz, by dostać świeży.
Zadania zostały utworzone, ale nic nie działa Prawdopodobnie wyłączony jest Auto WakeUp Agent — asystent ostrzega o tym przed potwierdzeniem. Włącz go ponownie w Ustawieniach.
Dalsze kroki
- Własne skrypty — pisz i rejestruj automatyzację, której nie obejmują skrypty wbudowane
- Przegląd lokalnego API — steruj tą samą kolejką zadań z własnych programów
- Ustawienia zadań — jak zakolejkowane zadania są podejmowane i wykonywane