Caricamento, indicizzazione rapida e indicizzazione batch

Un file caricato non è ancora una prova ricercabile. Segui l'elaborazione fino al suo stato finale e distingui i ritardi dai guasti.

Questi passaggi si riferiscono alle funzionalità identificate nel codice dell'applicazione. Questo materiale non è stato convalidato su un'istanza live; controlla la documentazione e le opzioni nella tua versione.

Come funziona, passo dopo passo

I buoni documenti vengono prima delle buone risposte

Prepara testo leggibile, titoli chiari, tabelle con intestazioni e fonti senza duplicati inutili. Il Chunking divide un documento in passaggi recuperabili separatamente; la sovrapposizione preserva la continuità tra i vicini. Un pezzo corto può perdere condizioni, mentre uno grande introduce rumore. I metadati preservano l'origine, la posizione e la versione, oltre all'ambito di accesso laddove imposto dall'implementazione. Il caricamento memorizza il file; l'indicizzazione lo rende ricercabile. Quando una fonte cambia, controlla che i vecchi blocchi scompaiano e che quelli nuovi vengano recuperati prima di dichiarare corrente la knowledge base.

Gli errori necessitano di percorsi espliciti

Un timeout è diverso da un errore di autorizzazione. Riprova solo errori temporanei, con tentativi limitati e ritardi crescenti. Un'operazione con effetti collaterali può essere eseguita prima che la sua risposta venga persa; riprovare senza una chiave di idempotenza può duplicare l'effetto. Lo streaming mostra l'avanzamento ma non garantisce il completamento. I checkpoint possono consentire la ripresa delle fasi non riuscite entro i limiti di runtime. Memorizza l'identificatore dell'esecuzione, la fase, la durata e l'errore rimuovendo i segreti dai log. Misura i percorsi lenti e le medie.

Il costo appartiene all'intero percorso

Conta le chiamate ai modelli, i token di input e output, gli incorporamenti, la riclassificazione, la visione e gli strumenti. Il ragionamento può consumare token fatturabili senza una risposta visibile altrettanto lunga. I costi di indicizzazione e i costi di conversazione differiscono. Utilizza i prezzi correnti anziché un numero permanente di un corso. Una stima semplice è token/1.000.000 × prezzo più operazioni aggiuntive; i crediti dell'applicazione possono avere la propria conversione. Confronta i costi per attività riuscita, non solo per chiamata. L'esecuzione parallela può ridurre la latenza aumentando al contempo il consumo totale. Un budget necessita di una condizione di arresto verificata.

Lo schema esplicativo

Seguire le frecce continue per il flusso principale. Le frecce blu tratteggiate forniscono dati o contesto; le frecce rosa tratteggiate mostrano feedback o risultati restituiti. Colori e forme distinguono modelli, negozi, decisioni e risultati. Su schermi piccoli, scorri in orizzontale per seguire l’intero schema.

Un esempio completo

Carica la policy in RAG. Fast avvia l'elaborazione ordinaria; batch può rinviare le operazioni del fornitore. Controlla le notifiche e lo stato del documento prima di testare una domanda.

Provalo tu stesso

1. Carica un documento sintetico e segui il caricamento, l'elaborazione e il test delle query.
2. Registrare l'input, la fonte e il risultato atteso prima di eseguire l'esperimento. Utilizzare solo i dati fittizi nell'esempio.
3. Seguire le fasi del diagramma. Ad ogni passaggio registrare quali informazioni vengono ricevute e prodotte; non confondere il risultato intermedio con il risultato finale.
4. Ripetere dopo aver rimosso le informazioni necessarie o reso ambiguo l'input. Controlla se il sistema chiarisce, ferma o inventa una risposta.
5. Confrontare con la soluzione spiegata. Conserva la configurazione, la data, il risultato e una spiegazione delle differenze. Cambia una cosa e riprova.

Una soluzione spiegata

Il documento è ricercabile solo dopo l'avvenuta elaborazione; conservare la fase dell'errore e il messaggio per la diagnosi. Un esercizio riuscito ti consente di mostrare la connessione tra input, fasi e risultato. Quando mancano le informazioni, una risposta cauta è più utile dei dettagli inventati. Confrontare non solo stile: verificare anche condizioni, fonti e operazioni.

Quando è utile e quali sono i suoi limiti

Controlla i limiti di formato e dimensione nella versione corrente. Scegli questo approccio quando migliora un bisogno misurato. Mantieni una linea di base semplice e confronta i risultati utilizzando input identici. Un esempio di successo non stabilisce l’affidabilità in ogni situazione.

Verifica ciò che hai imparato

Il caricamento completato significa che un documento è pronto per RAG?

No. Anche l'estrazione, la suddivisione in blocchi e l'indicizzazione devono essere completate correttamente.

Un timeout dimostra che l'operazione non è stata eseguita?

No. Controlla lo stato prima di ritentare un'azione con effetti collaterali.

Quale risultato dovrebbe produrre questo esercizio?

Il documento è ricercabile solo dopo l'avvenuta elaborazione; conservare la fase dell'errore e il messaggio per la diagnosi.

Termini da ricordare

• Pezzo: Un passaggio di documento che può essere recuperato separatamente.
• Idempotenza: Ripetizione controllata senza duplicare un effetto.
• Latență / Latenza: tempo necessario per ottenere un risultato utile.

Fonti e il prossimo passo

• Lewis et al. — Generazione aumentata di recupero
• LangGraph — flussi di lavoro e agenti
• OpenRouter — token di ragionamento

Per preparare: D01 — Preparazione dei documenti per l'IA