AI-assistent

Met de AI-assistent beschrijf je werk in gewone taal en zet TikMatrix het voor je in de wachtrij. Hij leest je apparaten, accounts en takengeschiedenis, laat precies zien wat hij zou aanmaken, en wacht op jouw goedkeuring voordat er iets wordt weggeschreven.

Vereist Pro

De assistent is beschikbaar vanaf het Pro-abonnement, dezelfde eis als voor de lokale automatiserings-API.

Wat het is (en niet is)

De assistent raakt je telefoons niet rechtstreeks aan. Hij werkt zoals jij: hij kijkt wat je hebt en zet dan taken in de wachtrij, die de gewone takenuitvoerder oppakt en uitvoert. Alles wat hij aanmaakt verschijnt in de takenlijst als elke andere taak, met bron assistant.

Hij kan ook niets uit zichzelf wegschrijven. Elke actie die de toestand verandert stopt het gesprek en vraagt het eerst aan jou — zie Zonder jouw goedkeuring draait er niets.

Instellen

Het model lever je zelf. TikMatrix levert er geen en zet je verzoeken niet door — de app praat rechtstreeks vanaf jouw machine met het endpoint dat je instelt.

1. Klik op Assistent in de linkernavigatiebalk.
2. Klik op Modelinstellingen.
3. Vul in:

Veld	Wat erin hoort
Endpoint	De volledige chat-completions-URL, bv. https://api.openai.com/v1/chat/completions
Model	De model-id, bv. gpt-4o of claude-sonnet-4-5
API-sleutel	Jouw sleutel voor die aanbieder
API-formaat	Laat op Afleiden uit endpoint staan, tenzij het misgokt
Takenlimiet per bevestiging	Het maximumaantal taken dat één goedkeuring mag aanmaken (standaard 200)

4. Klik op Opslaan.

Zodra de instellingen zijn geaccepteerd toont de statusregel bovenaan het paneel het gebruikte model, zodat je in één oogopslag ziet naar welk endpoint een gesprek gaat.

Welke endpoints werken

Twee protocolformaten worden ondersteund:

• OpenAI-compatibel — elk endpoint dat POST /v1/chat/completions spreekt. Dat omvat OpenAI zelf en de meeste zelf gehoste servers: vLLM, LocalAI, de OpenAI-compatibele laag van Ollama, DeepSeek, OpenRouter en dergelijke.
• Anthropic — endpoints die POST /v1/messages spreken.

API-formaat laat je normaal op Afleiden uit endpoint: een URL met api.anthropic.com of /v1/messages wordt als Anthropic behandeld, al het andere als OpenAI-compatibel. Stel het alleen expliciet in als je een proxy draait waarvan de URL het dialect niet prijsgeeft.

Kies een model dat tools kan aanroepen

De assistent werkt volledig via tool-aanroepen. Een model zonder betrouwbare toolondersteuning praat wel met je, maar komt nooit tot een plan.

Een model kiezen

Als je wilt	Gebruik dan
De betrouwbaarste planning, het minste toezicht	Een actueel topmodel van OpenAI of Anthropic
Lagere kosten bij routinewerk als "zet dit op het hele rek"	Een middenklassemodel van dezelfde aanbieders
Dat er niets van je machine af gaat	Een lokale server (Ollama, vLLM, LocalAI) met een model dat sterk is in tool-aanroepen

Kleine lokale modellen zijn de gebruikelijke oorzaak van "hij praat wel, maar plant nooit". Voordat je concludeert dat de assistent stuk is: probeer hetzelfde verzoek één keer op een gehost model — werkt het daar wel, dan lag het aan het model en niet aan de configuratie.

Waar de instellingen staan

Je endpoint en sleutel worden weggeschreven naar assistant_settings.json in de datamap van de app, en door de backend gelezen bij het versturen van een verzoek. Ze gaan nergens anders heen dan naar het endpoint dat je hebt ingesteld.

Eén instelling bestaat alleen in dat bestand: max_tokens, het antwoordbudget dat aan het model wordt meegegeven. Standaard 8192, begrensd tot het bereik 1024–64000. Verhoog het met de hand als lange antwoorden worden afgekapt.

Om werk vragen

Schrijf in gewone taal wat je wilt. Een paar voorbeelden:

• Warm alle accounts 20 minuten op
• Waarom zijn mijn laatste taken mislukt?
• Post morgen om 09:00 op alle apparaten
• Volg deze vijf accounts vanaf de telefoons in de groep Marketing

Een verzoek doorloopt normaal drie stappen:

1. Hij zoekt het op. Welke apparaten online zijn, welke accounts ingelogd zijn, welke parameters het script neemt.
2. Hij plant. Hij rekent uit hoeveel taken het verzoek precies oplevert en toont de totalen — hoeveel taken, over hoeveel apparaten en accounts.
3. Jij bevestigt. Pas dan worden de taken weggeschreven.

Is een verzoek dubbelzinnig op een manier die het aantal taken verandert, dan vraagt de assistent het na in plaats van te gokken.

Hoe een verzoek er van begin tot eind uitziet

Jij: warm alle ingelogde accounts 20 minuten op, te beginnen morgen om 9 uur

Assistent: (roept get_script_schema, list_devices, list_accounts en daarna plan_tasks aan) 34 opwarmtaken over 12 apparaten en 34 accounts, elk 20 minuten, start 2026-08-27 09:00. Twee accounts zijn niet ingelogd en zijn weggelaten.

Er verschijnt een bevestigingskaart met elke regel die hij gaat aanmaken — apparaat, account en doelwit waar het script er een neemt — plus de exacte script_config die wordt weggeschreven. Je drukt op Bevestigen en er verschijnen 34 taken in de lijst.

Zeggen wanneer

Taken kunnen voor later in de wachtrij: noem een tijdstip en de assistent zet het als starttijd in het plan, wat de kaart vóór goedkeuring toont. Dat is ook het juiste antwoord bij een groot verzoek — de volgacties van een heel rek over een dag uitsmeren oogt veel minder geautomatiseerd dan ze allemaal tegelijk afvuren, en bij riskant ogende verzoeken stelt de assistent het uit zichzelf voor.

Bij builds die beide apps aansturen

Een TikMatrix-build die voor zowel TikTok als Instagram is ingericht raadt niet welke je bedoelt, en probeert dat ook niet — een verzoek zonder platform komt terug met een vraag. Zeg "post op TikTok op de groep Marketing" in plaats van "post op de groep Marketing" en hij gaat meteen plannen. Builds met één platform vragen er nooit naar.

Zonder jouw goedkeuring draait er niets

Dit is in code afgedwongen, niet door het model netjes te vragen.

Wanneer de assistent naar iets grijpt wat de toestand verandert, stopt het gesprek en verschijnt er een bevestigingskaart die toont wat er staat te gebeuren. De aanroep draait pas nadat je op de bevestigknop hebt gedrukt.

Vier acties zijn zo afgeschermd:

Actie	Wat het doet
create_tasks	Zet de geplande taken in de wachtrij
stop_task	Stopt een lopende taak
retry_task	Zet een mislukte taak opnieuw in de wachtrij
create_custom_script	Schrijft en registreert een nieuw scriptbestand

Op het aanmaken van taken zit daarbovenop een tweede slot: de bevestigknop kan alleen het plan uitvoeren dat je te zien kreeg. De assistent kan de parameters tussen voorbeeld en goedkeuring niet meer wijzigen — een plan is eenmalig en vervalt na 15 minuten, zodat een voorbeeld waar je bij weggelopen bent niet later kan worden bevestigd tegen een inmiddels veranderde apparatenlijst.

De kaart is ook geen samenvatting die het model schreef: hij toont de echte regels van het plan en de echte script_config, dus wat je goedkeurt is wat er wordt weggeschreven.

Weigeren is een normaal antwoord en geen fout: het model krijgt te horen dat je nee zei en kan iets anders voorstellen in plaats van dezelfde aanroep te herhalen.

Het takenplafond

Eén bevestiging mag standaard hooguit 200 taken aanmaken. Dat is een rem tegen een verkeerd begrepen verzoek — zodat "warm mijn accounts op" niet duizend taken wordt die je 's ochtends ontdekt. Grotere runs blijven mogelijk: de assistent knipt ze in porties die je één voor één bevestigt.

Je verandert de limiet bij Modelinstellingen → Takenlimiet per bevestiging. Waarden boven 2000 worden afgekapt.

Wat de assistent kan zien

Dit gebruikt hij vrijelijk, zonder te vragen:

Tool	Wat het leest
list_devices	Aangesloten apparaten, of ze online of bezet zijn, groepslidmaatschap
list_accounts	Accounts, het apparaat waar elk op staat, en of het ingelogd is
list_groups	Apparaatgroepen en hun omvang
get_script_schema	Elk script dat deze build kan draaien en de exacte parameters
list_tasks	De takenlijst, te filteren op status, apparaat of script
get_task_log	Het logboek van één taak — meestal verklaart een mislukking zich daar
get_activity_log	Recente accountactiviteit
device_screenshot	Wat er nu op het scherm van een apparaat staat
list_custom_scripts	Je geregistreerde eigen scripts
get_custom_script_guide	Hoe je een eigen script schrijft
plan_tasks	Rekent uit wat een verzoek zou aanmaken, zonder het aan te maken

Schermafdrukken gaan naar je modelaanbieder

device_screenshot stuurt een afbeelding van het telefoonscherm naar het endpoint dat je hebt ingesteld. Kan er op een scherm iets staan wat je liever niet naar een externe aanbieder stuurt, vraag dan geen schermafdrukken, of richt de assistent op een model dat je zelf host.

Wat je machine verlaat

Alles wat de assistent leest wordt als onderdeel van het gesprek naar je modelendpoint gestuurd — zo ziet het model het immers. In de praktijk betekent dat: serienummers van apparaten en groepsnamen, gebruikersnamen van accounts en hun inlogstatus, takenregels en takenlogboeken, en elke schermafdruk waar je om vraagt. API-sleutels, proxygegevens en accountwachtwoorden horen niet bij wat hij kan lezen, en zitten dus nooit in de verzonden data.

Is die lijst meer dan je aan een externe aanbieder wilt geven, richt het endpoint dan op een model dat je zelf draait; verder verandert er niets aan de functie.

Eigen scripts laten schrijven

Dekt geen enkel ingebouwd script wat je nodig hebt, dan kan de assistent er een schrijven. Beschrijf de klus in gewone taal; hij leest de scripthandleiding, stelt een programma op en toont het je.

De bevestigingskaart hiervoor benoemt dat expliciet: het script wordt naar schijf geschreven en geregistreerd zodat het als elk ingebouwd script kan draaien. Lees het voordat je goedkeurt. Scripts belanden in een map assistant_scripts in de datamap van de app, zodat je alles wat hij heeft geschreven op één plek kunt nakijken, aanpassen of verwijderen.

Enkele grenzen die de app oplegt aan wat het model ook voorstelt:

• Alleen python, python3, node, bun en deno mogen als interpreter worden geregistreerd — niets wat een shell start met daarachter een lading.
• De bestandsnaam moet een gewone naam zijn: geen padscheidingstekens, geen .., geen punt vooraan, hoogstens 64 tekens.
• De broncode is begrensd op 200 KB en het platform moet generic, tiktok of instagram zijn.

Daarna is een geregistreerd script een doodgewoon eigen script: je kunt het openen bij Apparaten → Eigen scripts, de opdracht aanpassen, de time-out wijzigen of het uitschakelen. Zie Eigen scripts voor wat een script na registratie kan.

Grenzen om te kennen

• Eén verzoek, twaalf stappen. Is de assistent na twaalf tool-aanroepen niet klaar, dan stopt hij en meldt wat onopgelost bleef, in plaats van je tokens in een lus op te branden.
• Het gesprek is geen archief. Het staat in het geheugen — de acht recentste gesprekken en per gesprek de laatste 120 beurten — en verdwijnt bij een herstart van de app. Wat het bewaren waard is, wordt uiteindelijk een taak, en taken staan in de database.
• Wegnavigeren is veilig. De draad en elke openstaande bevestiging worden hersteld zodra je terugkomt.
• Stoppen beëindigt de lus bij het eerstvolgende controlepunt. Een modelaanroep die al onderweg is kan hij niet onderbreken, dus de huidige stap loopt eerst af.
• De tokens betaal jij. Elk verzoek draagt de scriptcatalogus en het gesprek tot dan toe mee, dus een lange draad kost per bericht meer dan een verse. Voor los werk is een nieuw gesprek beginnen goedkoper dan een oud voortzetten.

Problemen oplossen

API access requires Pro or higher plan Je licentie is Starter of inactief. Controleer Instellingen → Licentie.

The app is still starting up. Try again in a moment. Het paneel ging open voordat de achtergronddiensten klaar waren met starten. Wacht een paar seconden en stuur opnieuw.

No model endpoint configured / No API key configured / No model configured Open Modelinstellingen en vul alle drie in: endpoint, model en API-sleutel.

Could not reach the model endpoint De app kon geen verbinding openen. Controleer de URL, en of een lokaal endpoint werkelijk op die poort luistert.

Het model antwoordt maar plant nooit iets Waarschijnlijk roept het geen tools aan. Probeer een model dat sterk is in toolgebruik en controleer of API-formaat overeenkomt met het dialect van je endpoint.

Elk antwoord wordt afgekapt Sommige OpenAI-compatibele servers begrenzen de uitvoer standaard laag. Verhoog de limiet op de server, of verhoog max_tokens in assistant_settings.json.

Hij blijft vragen om welk platform het gaat Deze build stuurt zowel TikTok als Instagram aan. Noem in het verzoek welke je bedoelt.

Een bevestigingskaart laat zich niet bevestigen Plannen vervallen na 15 minuten. Vraag hetzelfde nog eens om een vers plan te krijgen.

Er zijn taken aangemaakt maar er draait niets Waarschijnlijk staat de Auto WakeUp Agent uit — de assistent waarschuwt hiervoor voordat je bevestigt. Zet hem weer aan bij Instellingen.

Volgende stappen

• Eigen scripts — schrijf en registreer automatisering die de ingebouwde scripts niet dekken
• Overzicht lokale API — stuur dezelfde takenwachtrij aan vanuit je eigen programma's
• Taakinstellingen — hoe taken in de wachtrij worden opgepakt en uitgevoerd