Errori degli agenti e soluzioni
Codici di errore e motivi di arresto che un agente IA può ricevere da Shotomatic, che cosa significano e che cosa puoi fare.
Aggiornato il 16 novembre 2026
Quando uno strumento di Shotomatic non riesce a fare ciò che l'agente ha chiesto, restituisce un errore con un code, un messaggio, l'indicazione se un nuovo tentativo può funzionare e spesso un'azione per te. Un buon agente ti riferisce quell'azione. Questa pagina elenca tutti i codici, così sai che cosa fare quando un agente ne segnala uno.
Codici di errore
| Codice | Che cosa significa | Che cosa puoi fare |
|---|---|---|
approval_required | L'agente non è ancora approvato. Finché non lo è, può solo leggere lo stato. | Apri Shotomatic e seleziona Consenti sulla scheda di approvazione. |
permission_required | macOS non ha concesso Registrazione schermo o, per la pressione dei tasti, Accessibilità. | Attiva Shotomatic in Impostazioni di Sistema > Privacy e sicurezza, poi riapri Shotomatic. Vedi autorizzazioni di macOS. |
license_limit | È stato raggiunto un limite del piano gratuito, come gli screenshot al giorno o gli URL per batch. | Usa un lavoro più piccolo, aspetta domani o consulta i prezzi. Gli screenshot già salvati restano. |
pro_feature | La richiesta usa una funzione che richiede Pro, per l'agente come per te. | Chiedi il lavoro senza quella funzione oppure passa a Pro. |
busy | È in corso un'altra acquisizione, oppure Shotomatic ti sta già chiedendo qualcosa. | Lascia finire o ferma l'altro lavoro, rispondi alla scheda aperta e poi chiedi di nuovo. |
source_unavailable | La finestra o lo schermo non c'è più o non si può acquisire. | Riapri la finestra o chiedi all'agente di scegliere un'altra sorgente. |
not_found | L'ID della sessione, del documento, del flusso di lavoro o del lavoro non esiste più. | Chiedi all'agente di elencare di nuovo gli elementi. |
revision_conflict | Il documento è cambiato dopo che l'agente l'ha letto, di solito perché l'hai modificato tu. | L'agente deve rileggere il documento e riapplicare la modifica. |
browser_not_installed | Acquisizione siti web richiede il browser di Shotomatic, che non è ancora installato. | Apri la pagina Acquisizione siti web in Shotomatic e installa il browser. |
invalid_request | L'agente ha inviato un valore che Shotomatic non può usare. | Di solito l'agente si corregge da solo. Se si ripete, riformula la richiesta. |
confirmation_declined | Hai selezionato Annulla su una scheda di conferma. | Niente. Non è stato eliminato né pianificato nulla. |
confirmation_timeout | Nessuno ha risposto a una scheda di conferma entro un minuto. | Chiedi di nuovo quando sei al computer. |
unavailable | La finestra principale di Shotomatic non è aperta, oppure l'app non è riuscita ad avviare il lavoro. | Apri Shotomatic, tieni aperta la finestra principale e chiedi di nuovo. |
failed | Qualcos'altro è andato storto. | Leggi il messaggio, riprova e contatta l'assistenza se si ripete. |
Perché un'acquisizione è in pausa
Un'Acquisizione automatica avviata da un agente va in pausa invece di premere tasti nel posto sbagliato:
- Un'altra finestra è in primo piano. Shotomatic non preme mai un tasto se la finestra acquisita non è in primo piano. Riportala in primo piano e di' all'agente di riprendere. Non usare il computer durante l'acquisizione.
- Lo schermo è bloccato. Sbloccalo e di' all'agente di riprendere.
Perché un'acquisizione è terminata
Quando un lavoro finisce, l'agente riceve un motivo. Questi sono normali:
- Il contenuto ha smesso di cambiare. Con la pressione di un tasto, Shotomatic si ferma quando la pagina non cambia più, per esempio alla fine di un libro.
- Condizione di arresto raggiunta. È stato raggiunto il numero di screenshot, la durata o l'ora di fine che avevi chiesto.
- Fermata da te o dall'agente. Hai selezionato Termina acquisizione, oppure l'agente ha fermato il lavoro. Gli screenshot già fatti restano.
Questi richiedono attenzione:
- Limite gratuito raggiunto. Il limite del piano gratuito ha terminato l'acquisizione. Gli screenshot salvati fino a quel momento sono nella Cronologia acquisizioni. Con il piano gratuito, un'Acquisizione da azioni termina dopo 5 passaggi.
- Finestra chiusa. La finestra acquisita è stata chiusa durante l'acquisizione.
- La finestra non è rimasta in primo piano. Shotomatic non è riuscito a portare la finestra in primo piano. Tienila visibile, non usare il computer e chiedi all'agente di ricominciare.
- Sessione terminata altrove. La sessione di acquisizione è stata chiusa in Shotomatic mentre l'acquisizione era in corso.
Non riesci a risolvere? Vedi Risoluzione dei problemi o l'elenco per i client.