# Errori degli agenti e soluzioni | Guida utente | Shotomatic

> Codici di errore e motivi di arresto che un agente IA può ricevere da Shotomatic, che cosa significano e che cosa puoi fare.

- Tipo: Pagina web pubblica
- Pagina canonica: [https://www.shotomatic.com/it/guide/ai-agents/errors](https://www.shotomatic.com/it/guide/ai-agents/errors)
- Pagina Markdown: [https://www.shotomatic.com/it/guide/ai-agents/errors.md](https://www.shotomatic.com/it/guide/ai-agents/errors.md)

Sfoglia la guida utente

In questa pagina

1.  [Codici di errore](#codici-di-errore)
2.  [Perché un'acquisizione è in pausa](#perché-unacquisizione-è-in-pausa)
3.  [Perché un'acquisizione è terminata](#perché-unacquisizione-è-terminata)

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](https://www.shotomatic.com/it/guide/get-started/macos-permissions).

`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](https://www.shotomatic.com/it/pricing). 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](mailto:support@shotomatic.com) 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](https://www.shotomatic.com/it/guide/troubleshooting/common-issues#un-agente-ia-non-riesce-a-collegarsi-o-a-usare-shotomatic) o [l'elenco per i client](https://www.shotomatic.com/it/guide/ai-agents/other-agents#risoluzione-dei-problemi).

## In questa pagina

1.  [Codici di errore](#codici-di-errore)
2.  [Perché un'acquisizione è in pausa](#perché-unacquisizione-è-in-pausa)
3.  [Perché un'acquisizione è terminata](#perché-unacquisizione-è-terminata)

## Informazioni su questa versione

Questa pagina Markdown viene generata dalla pagina pubblica di Shotomatic renderizzata sul server. I controlli interattivi e la navigazione del sito non sono inclusi. Per citare o condividere il contenuto, usa la pagina canonica.
