Assistente IA

L'assistente IA ti permette di descrivere il lavoro in linguaggio comune e lasciare che TikMatrix lo accodi per te. Legge i tuoi dispositivi, gli account e lo storico delle attività, ti mostra esattamente cosa creerebbe e attende la tua approvazione prima di scrivere qualsiasi cosa.

Richiede Pro

L'assistente è disponibile dal piano Pro in su, lo stesso requisito dell'API locale di automazione.

Cos'è (e cosa non è)

L'assistente non tocca direttamente i tuoi telefoni. Lavora come lavori tu: guarda cosa hai e poi accoda attività, che il normale esecutore di attività preleva ed esegue. Tutto ciò che crea appare nell'elenco attività come qualsiasi altra, con la sorgente assistant.

Non può nemmeno scrivere nulla di propria iniziativa. Ogni azione che cambia lo stato ferma la conversazione e chiede prima a te — vedi Nulla viene eseguito senza la tua approvazione.

Configurazione

Il modello lo fornisci tu. TikMatrix non ne include uno e non fa da tramite per le tue richieste: l'app parla con l'endpoint che configuri, direttamente dalla tua macchina.

1. Clicca Assistente nella barra di navigazione a sinistra.
2. Clicca Impostazioni del modello.
3. Compila:

Campo	Cosa inserire
Endpoint	L'URL completo di chat-completions, es. https://api.openai.com/v1/chat/completions
Modello	L'id del modello, es. gpt-4o o claude-sonnet-4-5
Chiave API	La tua chiave per quel fornitore
Formato API	Lascia su Rileva dall'endpoint, salvo che sbagli
Limite di attività per conferma	Il massimo di attività che una singola approvazione può creare (predefinito 200)

4. Clicca Salva.

Una volta accettate le impostazioni, la riga di stato in cima al pannello mostra il modello in uso, così vedi a colpo d'occhio verso quale endpoint andrà una conversazione.

Quali endpoint funzionano

Sono supportati due formati:

• Compatibile OpenAI — qualsiasi endpoint che parli POST /v1/chat/completions. Comprende OpenAI stesso e la maggior parte dei server self-hosted: vLLM, LocalAI, il livello compatibile OpenAI di Ollama, DeepSeek, OpenRouter e simili.
• Anthropic — endpoint che parlano POST /v1/messages.

Formato API si lascia normalmente su Rileva dall'endpoint: un URL che contiene api.anthropic.com o /v1/messages è trattato come Anthropic, tutto il resto come compatibile OpenAI. Impostalo esplicitamente solo se usi un proxy il cui URL non rivela il dialetto.

Scegli un modello capace di usare strumenti

L'assistente funziona interamente tramite chiamate a strumenti. Un modello senza un supporto affidabile agli strumenti chiacchiererà con te ma non riuscirà mai a pianificare nulla.

Come scegliere un modello

Se vuoi	Usa
La pianificazione più affidabile, con meno supervisione	Un modello di punta attuale di OpenAI o Anthropic
Costi più bassi sul lavoro di routine «accoda questo su tutto il rack»	Un modello di fascia media degli stessi fornitori
Che nulla lasci la tua macchina	Un server locale (Ollama, vLLM, LocalAI) con un modello solido nelle chiamate a strumenti

I modelli locali piccoli sono la causa più comune del «chiacchiera ma non pianifica mai». Prima di concludere che l'assistente è rotto, prova la stessa richiesta una volta su un modello ospitato: se lì funziona, il problema era il modello e non la configurazione.

Dove sono salvate le impostazioni

Endpoint e chiave vengono scritti in assistant_settings.json, nella directory dati dell'app, e letti dal backend quando invia una richiesta. Non vengono inviati da nessun'altra parte se non all'endpoint che hai configurato.

Un'impostazione vive solo in quel file: max_tokens, il budget di risposta inviato al modello. Vale 8192 di default ed è limitato all'intervallo 1024–64000. Alzalo a mano se le risposte lunghe vengono tagliate.

Chiedere del lavoro

Scrivi ciò che vuoi in linguaggio comune. Qualche esempio:

• Scalda tutti gli account per 20 minuti
• Perché le mie ultime attività sono fallite?
• Pubblica su tutti i dispositivi domani alle 09:00
• Segui questi cinque account dai telefoni del gruppo Marketing

Una richiesta passa di norma per tre fasi:

1. Consulta. Quali dispositivi sono online, quali account sono connessi, quali parametri accetta lo script.
2. Pianifica. Calcola esattamente quante attività produce la richiesta e ti mostra i totali: quante attività, su quanti dispositivi e account.
3. Confermi tu. Solo allora le attività vengono scritte.

Se una richiesta è ambigua in un modo che cambia quante attività verranno create, l'assistente chiede invece di indovinare.

Com'è una richiesta dall'inizio alla fine

Tu: scalda per 20 minuti tutti gli account connessi, a partire da domani alle 9

Assistente: (chiama get_script_schema, list_devices, list_accounts e poi plan_tasks) 34 attività di riscaldamento su 12 dispositivi e 34 account, 20 minuti ciascuna, avvio il 2026-08-27 alle 09:00. Due account non sono connessi e sono stati esclusi.

Compare una scheda di conferma che elenca ogni riga che sta per creare — dispositivo, account e destinazione quando lo script ne prende una — più l'esatta script_config che verrà scritta. Premi Conferma e 34 attività compaiono nell'elenco.

Indicare il momento

Le attività possono essere accodate per dopo: menziona un orario e l'assistente lo inserisce nel piano come orario di avvio, che la scheda mostra prima dell'approvazione. È anche la risposta giusta quando la richiesta è grande: distribuire i follow di un intero rack sulla giornata sembra molto meno automatizzato che spararli tutti insieme, e l'assistente lo propone da solo sulle richieste che sembrano rischiose.

Sulle build che pilotano entrambe le app

Una build di TikMatrix configurata sia per TikTok sia per Instagram non prova a indovinare quale intendi: una richiesta senza piattaforma torna indietro con una domanda. Di' «pubblica su TikTok sul gruppo Marketing» invece di «pubblica sul gruppo Marketing» e passerà direttamente alla pianificazione. Le build a piattaforma singola non lo chiedono mai.

Nulla viene eseguito senza la tua approvazione

Questo è imposto dal codice, non chiedendolo gentilmente al modello.

Quando l'assistente sta per fare qualcosa che cambia lo stato, la conversazione si ferma e compare una scheda di conferma che mostra cosa sta per accadere. La chiamata viene eseguita solo dopo che premi il pulsante di conferma.

Quattro azioni sono protette così:

Azione	Cosa fa
create_tasks	Accoda le attività pianificate
stop_task	Ferma un'attività in esecuzione
retry_task	Riaccoda un'attività fallita
create_custom_script	Scrive e registra un nuovo file di script

La creazione di attività ha sopra un secondo lucchetto: il pulsante di conferma può eseguire soltanto il piano che ti è stato mostrato. L'assistente non può rivedere i parametri tra l'anteprima e la tua approvazione: un piano è monouso e scade dopo 15 minuti, quindi un'anteprima da cui ti sei allontanato non può essere confermata più tardi contro un elenco di dispositivi nel frattempo cambiato.

La scheda non è nemmeno un riassunto scritto dal modello: disegna le righe reali del piano e la script_config reale, quindi ciò che approvi è ciò che viene scritto.

Rifiutare è una risposta normale, non un errore: al modello viene comunicato che hai detto di no, e può proporre altro invece di ritentare la stessa chiamata.

Il tetto di attività

Una conferma può creare al massimo 200 attività per impostazione predefinita. È un freno contro una richiesta interpretata male — perché «scalda i miei account» non diventi mille attività che scopri la mattina dopo. Lanci più grandi restano possibili: l'assistente li divide in lotti che confermi uno alla volta.

Puoi cambiare il limite in Impostazioni del modello → Limite di attività per conferma. I valori sopra 2000 vengono ridotti.

Cosa può vedere l'assistente

Questo lo usa liberamente, senza chiedere:

Strumento	Cosa legge
list_devices	Dispositivi collegati, se online o occupati, appartenenza ai gruppi
list_accounts	Account, il dispositivo di ciascuno e se è connesso
list_groups	Gruppi di dispositivi e loro dimensioni
get_script_schema	Tutti gli script eseguibili da questa build e i parametri esatti
list_tasks	L'elenco attività, filtrabile per stato, dispositivo o script
get_task_log	Il registro di una singola attività: di solito lì un errore si spiega da sé
get_activity_log	Attività recente degli account
device_screenshot	Cosa c'è adesso sullo schermo di un dispositivo
list_custom_scripts	I tuoi script personalizzati registrati
get_custom_script_guide	Come scrivere uno script personalizzato
plan_tasks	Calcola cosa creerebbe una richiesta, senza crearlo

Gli screenshot vanno al tuo fornitore di modello

device_screenshot invia un'immagine dello schermo del telefono all'endpoint che hai configurato. Se una schermata potrebbe mostrare qualcosa che preferiresti non inviare a un fornitore terzo, evita di chiedere screenshot oppure punta l'assistente a un modello ospitato da te.

Cosa lascia la tua macchina

Tutto ciò che l'assistente legge viene inviato al tuo endpoint come parte della conversazione: è così che il modello lo vede. In pratica significa numeri di serie dei dispositivi e nomi dei gruppi, nomi utente degli account e il loro stato di accesso, righe di attività e registri delle attività, e ogni screenshot che richiedi. Chiavi API, credenziali proxy e password degli account non rientrano tra le cose che può leggere, quindi non finiscono mai nel payload.

Se quell'elenco è più di quanto tu voglia consegnare a un fornitore terzo, punta l'endpoint a un modello che gestisci tu; nient'altro della funzione cambia.

Scrivere script personalizzati

Se nessuno script integrato copre ciò che ti serve, l'assistente può scriverne uno. Descrivi il lavoro in linguaggio comune; leggerà la guida allo scripting, redigerà un programma e te lo mostrerà.

La scheda di conferma di questa azione lo dice chiaramente: lo script viene scritto su disco e registrato per poter essere eseguito come qualsiasi integrato. Leggilo prima di approvarlo. Gli script finiscono in una cartella assistant_scripts nella directory dati dell'app, così tutto ciò che ha scritto si può controllare, modificare o eliminare in un solo posto.

Alcuni limiti che l'app impone a qualunque cosa il modello proponga:

• Come interprete si possono registrare solo python, python3, node, bun e deno — nulla che avvii una shell con un payload dietro.
• Il nome del file deve essere un nome semplice: niente separatori di percorso, niente .., niente punto iniziale, al massimo 64 caratteri.
• Il sorgente è limitato a 200 KB e la piattaforma dev'essere generic, tiktok o instagram.

Da lì in poi uno script registrato è un normale script personalizzato: puoi aprirlo in Dispositivi → Script personalizzati, modificare il comando, cambiare il timeout o disabilitarlo. Vedi Script personalizzati per cosa può fare uno script una volta registrato.

Limiti da conoscere

• Una richiesta, dodici passi. Se dopo dodici chiamate a strumenti l'assistente non ha finito, si ferma e riferisce cosa è rimasto irrisolto, invece di bruciare i tuoi token in un ciclo.
• La conversazione non è un archivio. Vive in memoria — le otto conversazioni più recenti, e gli ultimi 120 turni di ciascuna — e si perde al riavvio dell'app. Ciò che vale la pena conservare finisce come attività, e le attività sono nel database.
• Cambiare schermata è sicuro. Il thread e ogni conferma in sospeso vengono ripristinati al tuo ritorno.
• Ferma chiude il ciclo al successivo punto di controllo. Non può interrompere una chiamata al modello già partita, quindi il passo corrente si conclude prima.
• I token li paghi tu. Ogni richiesta porta con sé il catalogo degli script e la conversazione fino a quel punto, quindi un thread lungo costa più per messaggio di uno nuovo. Per un lavoro non correlato, iniziare una nuova conversazione costa meno che proseguire una vecchia.

Risoluzione dei problemi

API access requires Pro or higher plan La tua licenza è Starter o inattiva. Controlla Impostazioni → Licenza.

The app is still starting up. Try again in a moment. Il pannello si è aperto prima che i servizi in background finissero di avviarsi. Attendi qualche secondo e reinvia.

No model endpoint configured / No API key configured / No model configured Apri Impostazioni del modello e compila tutti e tre: endpoint, modello e chiave API.

Could not reach the model endpoint L'app non è riuscita ad aprire una connessione. Controlla l'URL e che un endpoint locale sia davvero in ascolto su quella porta.

Il modello risponde ma non pianifica mai nulla Probabilmente non sta chiamando strumenti. Prova un modello con solido supporto agli strumenti e verifica che Formato API corrisponda al dialetto del tuo endpoint.

Ogni risposta viene troncata Alcuni server compatibili OpenAI limitano parecchio l'output per impostazione predefinita. Alza il limite sul server, o alza max_tokens in assistant_settings.json.

Continua a chiedere quale piattaforma Questa build pilota sia TikTok sia Instagram. Nomina quella che vuoi nella richiesta.

Una scheda di conferma non conferma I piani scadono dopo 15 minuti. Richiedi la stessa cosa per ottenerne uno nuovo.

Le attività sono state create ma non parte nulla Probabilmente l'Auto WakeUp Agent è spento — l'assistente avvisa di questo prima della conferma. Riattivalo in Impostazioni.

Prossimi passi

• Script personalizzati — scrivi e registra automazioni che gli script integrati non coprono
• Panoramica dell'API locale — pilota la stessa coda attività dai tuoi programmi
• Impostazioni attività — come le attività accodate vengono prese in carico ed eseguite