Sfoglia la guida utente

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

Apri Markdown
In questa pagina

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

CodiceChe cosa significaChe cosa puoi fare
approval_requiredL'agente non è ancora approvato. Finché non lo è, può solo leggere lo stato.Apri Shotomatic e seleziona Consenti sulla scheda di approvazione.
permission_requiredmacOS 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_featureLa 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_unavailableLa 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_foundL'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_conflictIl 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_installedAcquisizione siti web richiede il browser di Shotomatic, che non è ancora installato.Apri la pagina Acquisizione siti web in Shotomatic e installa il browser.
invalid_requestL'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_declinedHai selezionato Annulla su una scheda di conferma.Niente. Non è stato eliminato né pianificato nulla.
confirmation_timeoutNessuno ha risposto a una scheda di conferma entro un minuto.Chiedi di nuovo quando sei al computer.
unavailableLa 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.
failedQualcos'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.

Errori degli agenti e soluzioni | Guida utente | Shotomatic