Risolvere problemi di caricamento falliti

Se un caricamento si blocca o un lavoro di elaborazione termina con Fallito, questa guida ti accompagna attraverso le cause più comuni.

1. Controlla il pannello di stato del lavoro

Apri Caricamenti → Elaborazione nella barra laterale. Ogni lavoro mostra uno stato:

In coda. Caricamento terminato; in attesa di un worker.
In elaborazione. OCR, strutturazione ed embedding sono in corso.
Elaborato / in attesa di revisione. In attesa di revisione prima della pubblicazione.
Completato. Fatto — il documento è nella tua Libreria.
Errore. Qualcosa è andato storto. Clicca sulla riga per un messaggio di errore leggibile.

Il motivo del fallimento quasi sempre ti dice esattamente cosa correggere.

2. Ricarica dopo aver controllato il file

La maggior parte dei fallimenti di caricamento rientra in una di queste categorie:

Formato non supportato. Vedi Formati di file supportati. Converti con uno strumento gratuito e riprova.
PDF criptato / protetto da password. Rimuovi la password (Acrobat, Anteprima su macOS, o qpdf --decrypt), poi ricarica.
File corrotto. Apri il file localmente prima. Se il tuo visualizzatore PDF non riesce a leggerlo, nemmeno Vulgate può. Ri-esporta dalla fonte.
PDF vuoto o tutto immagini senza contrasto. L'OCR ha bisogno di almeno qualche contenuto leggibile. Aumenta il contrasto in uno strumento come Acrobat o Anteprima, poi riprova.
File audio senza contenuto udibile. Qualche secondo di silenzio va bene, ma un file intero di silenzio fallirà.

3. Blocchi lato browser

Se la barra di avanzamento Caricamento si blocca a metà:

Interruzione di rete. Aggiorna la pagina — Vulgate riprende il caricamento da dove si era interrotto per i file che usano il caricamento multipart.
Interferenza di estensioni del browser. Prova una finestra in Incognito / Privata con le estensioni disabilitate.
Proxy aziendale che blocca lo storage. Vulgate carica i file su Cloudflare R2 tramite un URL firmato (API compatibile S3); alcuni proxy aziendali bloccano il traffico diretto allo storage. Prova una rete diversa o contatta il tuo team IT.

4. Limite di spesa raggiunto

Se il lavoro dice Hai superato il limite di spesa per il tuo piano, hai esaurito i crediti di elaborazione mensili del tuo piano. Aspetta il prossimo ciclo di fatturazione, o apri Impostazioni → Fatturazione e passa a un livello superiore. Vedi Modificare il tuo piano.

5. Trascrizione audio specificamente

Mancata corrispondenza della lingua. Vulgate rileva automaticamente la lingua; se il tuo file è multilingue, i risultati potrebbero soffrirne. Dividi il file per lingua e ricarica.
Audio silenzioso. Verifica che il file si riproduca in modo udibile localmente prima.
File molto lungo. I file oltre le due ore a volte vanno in timeout. Dividi in parti (ffmpeg -i input.mp3 -f segment -segment_time 3600 -c copy chunk_%03d.mp3) e ricarica.

Vedi Perché la trascrizione audio è fallita per un debugging più approfondito.

6. Ancora bloccato?

Se nulla di quanto sopra aiuta, scrivici a info@vulgate.ai con:

L'ID del lavoro dalla riga fallita (l'UUID mostrato nella tabella dei lavori).
Il nome del file originale.
Una copia del file, se puoi condividerla.

Analizzeremo i log e risponderemo entro un giorno lavorativo.