Caricare Documenti

Tempo Stimato

⏱️ 5-10 minuti per completare questa sezione

🎯 Obiettivo

Impara a caricare documenti in Emblema utilizzando il sistema di drag & drop e le opzioni avanzate di configurazione. Al termine saprai gestire caricamenti singoli e multipli, configurare il chunking ottimale e monitorare lo stato di elaborazione.

📁 Formati Supportati

Emblema supporta una vasta gamma di formati di file per coprire tutte le tue esigenze:

📄 Documenti di Testo

• PDF - Documenti portabili (raccomandato per testi complessi)
• DOCX - Documenti Microsoft Word
• TXT - File di testo semplice
• MD - File Markdown

🎵 File Audio

• MP3 - Audio compresso (più comune)
• WAV - Audio non compresso (alta qualità)
• M4A - Audio Apple/iTunes
• AAC - Audio compresso avanzato
• OGG - Audio open source

🎥 File Video

• MP4 - Video standard (raccomandato)
• MOV - Video QuickTime
• AVI - Video Windows
• MKV - Contenitore video open source
• WEBM - Video web

📧 Altri Formati

• EML - Email salvate
• PNG, JPG, GIF - Immagini (per estrazione testo OCR)

📊 Presentazioni

• PPTX - Presentazioni PowerPoint
• PPT - Presentazioni PowerPoint legacy (supporto limitato)

🚀 Metodi di Caricamento

Metodo 1: Drag & Drop (Consigliato)

Il modo più veloce per caricare file è trascinarli direttamente nell'interfaccia:

1. Apri la sezione "Documenti sorgenti" della tua Knowledge Base
2. Trascina i file dal tuo computer direttamente nell'area della tabella
3. Rilascia i file quando vedi l'indicatore di rilascio
4. Configura le opzioni (vedi sezione successiva)
5. Premi "Carica file" per iniziare l'elaborazione

[Screenshot placeholder: Interfaccia drag & drop con indicatore di rilascio attivo]

Vantaggi del Drag & Drop:

• ⚡ Velocità: caricamento immediato
• 📦 Multipli: puoi trascinare più file insieme
• 🎯 Intuitivo: trascina ovunque nella pagina
• 📱 Supporto touch: funziona su tablet

💡 Suggerimento: Puoi trascinare file ovunque nella pagina - non solo nell'area specificata. L'interfaccia si adatterà automaticamente.

Metodo 2: Selezione File Tradizionale

Per un controllo più preciso:

1. Clicca nell'area documenti quando non ci sono file caricati
2. Seleziona file dal browser di sistema
3. Conferma la selezione per aggiungerli alla coda

Metodo 3: Caricamento da URL

Per documenti online:

1. Scegli "URL" come tipo sorgente durante la creazione documento
2. Inserisci l'URL completo del documento
3. Verifica l'accessibilità - l'URL deve essere pubblico
4. Configura l'elaborazione e salva

[Screenshot placeholder: Form di creazione documento da URL]

⚙️ Configurazione Avanzata

Preset di Chunking

Emblema seleziona automaticamente il preset migliore basandosi sul tipo di file, ma puoi personalizzarlo:

Preset	Dimensione Chunk	Uso Consigliato	Strategia
Default	512 token	Documenti generici, PDF	Ricorsivo
Meeting	400 token	Audio/Video meeting	Diarizzazione speaker
Executive	300 token	Riassunti, briefing	Semantico
Technical	600 token	Manuali, documentazione	Ricorsivo
Q&A	200 token	FAQ, domande-risposte	Per frasi

[Screenshot placeholder: Selezione preset di chunking con dettagli]

Configurazione Personalizzata

Per esigenze specifiche, puoi configurare:

• Dimensione Chunk: Numero di token per segmento (128-800)
• Sovrapposizione: Token condivisi tra chunk (10-20% raccomandato)
• Strategia: Metodo di suddivisione del contenuto
• Lingua Audio: Per trascrizioni (it, en, fr, de, es, ecc.)
• Modello Embedding: BGE-M3 (predefinito e ottimizzato)

💡 Suggerimento: Il preset "Meeting" attiva automaticamente la diarizzazione speaker per distinguere chi parla nei file audio/video.

📊 Monitoraggio Caricamento

Stato Elaborazione

Ogni file passa attraverso diverse fasi:

1. ⏳ In coda: File in attesa di elaborazione
2. 🔄 Ottimizzazione: Conversione nel formato migliore
3. ✂️ Chunking: Suddivisione intelligente del contenuto
4. 🧠 Embedding: Generazione vettori per ricerca semantica
5. ✅ Completato: File pronto per l'uso

[Screenshot placeholder: Barra di progresso con fasi di elaborazione]

Caricamenti Grandi (>50MB)

Per file molto grandi, Emblema usa il caricamento a chunk:

• Pausa/Riprendi: Puoi interrompere e riprendere il caricamento
• Recupero automatico: Riprende da dove si era interrotto
• Progresso dettagliato: Mostra chunk caricati vs totali
• Controllo qualità: Verifica integrità durante l'upload

[Screenshot placeholder: Caricamento chunked con controlli pausa/riprendi]

Gestione Errori

Se un caricamento fallisce:

1. Controlla formato: Verifica che il file sia supportato
2. Verifica dimensioni: Controlla i limiti di upload (default: 1GB)
3. Riprova: Usa il pulsante "Riprova" per tentare di nuovo
4. Logs dettagliati: Controlla i dettagli dell'errore nel tooltip

🎨 Personalizzazione Interfaccia

Suggerimenti di Caricamento

Puoi controllare la visibilità dei suggerimenti:

• Discreto: Hint minimali (consigliato)
• Prominente: Suggerimenti sempre visibili
• Nascosto: Nessun suggerimento

Accedi alle impostazioni tramite il menu utente → Impostazioni → Visibilità suggerimenti.

Scorciatoie da Tastiera

• Alt + H: Mostra/nasconde suggerimenti di caricamento
• Ctrl + U: Apri selettore file (quando possibile)
• Esc: Annulla caricamento in corso

🔍 Dopo il Caricamento

Verifica Risultati

Dopo l'elaborazione, verifica:

1. Numero Chunk: Controlla che il documento sia stato suddiviso correttamente
2. Token Count: Verifica il conteggio totale di token
3. Preview: Esamina l'anteprima del contenuto elaborato
4. Metadati: Controlla informazioni aggiuntive estratte

[Screenshot placeholder: Vista dettaglio documento con chunk e metadati]

Operazioni Post-Caricamento

• 📝 Modifica Chunk: Correggi o migliora il contenuto elaborato
• 📊 Visualizza Statistiche: Analizza la distribuzione dei chunk
• 🔄 Rielabora: Cambia strategia di chunking se necessario
• 📤 Esporta: Salva il contenuto elaborato in PDF/DOCX

✅ Riepilogo

Hai imparato a:

• ✓ Caricare file con drag & drop e metodi tradizionali
• ✓ Configurare preset e opzioni di chunking ottimali
• ✓ Monitorare e gestire lo stato di elaborazione
• ✓ Utilizzare caricamenti avanzati per file grandi
• ✓ Personalizzare l'interfaccia di caricamento
• ✓ Verificare i risultati dell'elaborazione

🎓 Prossimi Passi

Approfondisci la gestione documenti:

• Chunking Documenti: Ottimizza la suddivisione del contenuto
• Ricerca Semantica: Trova informazioni nei tuoi documenti
• Organizzare File: Struttura le tue Knowledge Base
• Knowledge Base Avanzate: Gestione avanzata contenuti

❓ Domande Frequenti

Q: Quali sono i limiti di dimensione file? A: Il limite predefinito è 1GB per file. Per file più grandi, contatta l'amministratore.

Q: Posso caricare più file contemporaneamente? A: Sì, puoi trascinare più file insieme. Ognuno verrà elaborato con il suo preset ottimale.

Q: Quanto tempo richiede l'elaborazione? A: Dipende dalle dimensioni e dal tipo:

• Documenti PDF: 1-5 minuti
• Audio/Video: 2-10 minuti (include trascrizione)
• File di testo: 30 secondi - 2 minuti

Q: Posso modificare la configurazione dopo il caricamento? A: Sì, puoi rielaborare i documenti con nuove impostazioni dalla vista dettaglio.

Q: I file audio vengono trascritti automaticamente? A: Sì, con riconoscimento automatico dei parlanti (diarizzazione) se usi il preset "Meeting".

🆘 Risoluzione Problemi

Se hai problemi:

• 🔍 Controlla lo stato dei servizi nella dashboard
• 📊 Verifica spazio disponibile nella tua Knowledge Base
• 🔧 Prova a cambiare preset di chunking
• 📖 Consulta gli Errori Comuni
• 🆘 Contatta il supporto per assistenza diretta