> ## Documentation Index > Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Revisione documento > Ricevi feedback basato sull'AI sulla struttura, la chiarezza e la completezza del documento. La Revisione documento fornisce feedback strutturato e pratico sulla tua scrittura. Invece di porre domande generali all'Assistant, la Revisione documento analizza l'intero documento e offre indicazioni su struttura, chiarezza, completezza e qualità complessiva. Questo ti aiuta a individuare i problemi prima di condividere, migliorare la qualità dei contenuti e ottenere una prospettiva esterna sul tuo lavoro – tutto senza uscire da Craft. ## Cosa fa la Revisione documento La Revisione documento esamina il tuo documento su più dimensioni: **Struttura e organizzazione:** * Flusso logico e progressione * Gerarchia e coerenza dei titoli * Bilanciamento delle sezioni e ritmo * Architettura delle informazioni **Chiarezza e leggibilità:** * Complessità e lunghezza delle frasi * Uso di gergo e linguaggio tecnico * Transizioni tra le idee * Punteggio di leggibilità complessivo **Completezza:** * Contesto o background mancante * Lacune nelle spiegazioni * Domande senza risposta * Aree che necessitano di espansione **Segnali di qualità:** * Coerenza del tono * Problemi di formattazione * Ridondanze e ripetizioni * Opportunità di miglioramento La revisione è obiettiva, specifica e pratica – ricevi suggerimenti concreti, non feedback vaghi. ## Come avviare la Revisione documento Apri il documento che vuoi revisionare. Clicca sull'icona dell'Assistant nell'angolo in basso. Seleziona **Nuova chat**. Scegli **Revisione documento** dal selettore di modalità. Attendi il completamento dell'analisi (di solito 10-30 secondi). L'Assistant leggerà l'intero documento e fornirà feedback strutturato organizzato per categoria. La Revisione documento funziona con tutti i modelli, ma **Max** fornisce il feedback più approfondito e sfumato, specialmente per documenti lunghi o complessi. Per controlli rapidi, **Fast** offre un buon equilibrio tra profondità e velocità. ## Revisione documento vs. chat generale con l'Assistant | Funzionalità | Revisione documento | Chat generale con l'Assistant | | ------------------------ | ------------------------------------------------- | ------------------------------------------------- | | **Scopo** | Feedback strutturato sul documento | Conversazione e attività a risposta aperta | | **Ambito** | Analisi dell'intero documento | Risponde a domande specifiche | | **Formato output** | Organizzato per categorie di feedback | Risposte conversazionali | | **Profondità analisi** | Completa, multidimensionale | Focalizzata sulla tua domanda specifica | | **Ideale per** | Controlli di qualità, revisioni pre-pubblicazione | Modifiche rapide, riepiloghi, query sui contenuti | | **Domande di follow-up** | Puoi fare domande di chiarimento | Conversazione continua | | **Utilizzo** | Maggiore (analizza il documento completo) | Varia in base alla complessità della query | Usa la **Revisione documento** quando vuoi un feedback completo sull'intero documento. Usa la **chat generale** quando hai domande o attività specifiche. ## Quando usare la Revisione documento La Revisione documento è più utile in questi scenari: ### Prima di condividere esternamente Rivedi presentazioni, proposte o documenti rivolti ai clienti per individuare problemi strutturali, sezioni poco chiare o contesto mancante prima di inviarli. ### Controllo di qualità Esegui revisioni periodiche su documentazione importante, wiki di team o articoli di knowledge base per mantenere alta la qualità e la coerenza nel tempo. ### Miglioramento dei contenuti Ottieni suggerimenti pratici per post del blog, rapporti o testi di lunga forma. L'Assistant può identificare le aree che necessitano di espansione, semplificazione o ristrutturazione. ### Preparazione alla collaborazione Prima di condividere con i colleghi, assicurati che il documento sia chiaro, completo e ben organizzato. Questo riduce i botta e risposta e migliora l'efficienza della collaborazione. ### Apprendimento e sviluppo delle competenze Usa le revisioni per comprendere i pattern nella tua scrittura – problemi ricorrenti di chiarezza, tendenze strutturali o aree in cui hai costantemente bisogno di migliorare. Puoi eseguire la Revisione documento più volte. Apporta modifiche in base al feedback, poi rivedi di nuovo per vedere se i problemi sono risolti. Questo approccio iterativo ti aiuta a capire cosa funziona e a perfezionare progressivamente i tuoi contenuti. ## Comprendere il feedback Il feedback della Revisione documento è organizzato in categorie chiare. Ecco come interpretarlo e come agire: ### Feedback sulla struttura **Cosa ti dice:** Quanto scorre bene il tuo contenuto, se le sezioni sono bilanciate e se l'architettura delle informazioni ha senso. **Esempio di feedback:** * "L'introduzione è troppo lunga rispetto al resto del documento" * "La Sezione 3 manca di una transizione chiara dalla Sezione 2" * "La gerarchia dei titoli salta da H2 a H4" **Come usarlo:** Riorganizza le sezioni, regola il ritmo, correggi i livelli dei titoli o aggiungi contenuti di transizione. ### Feedback sulla chiarezza **Cosa ti dice:** Se la tua scrittura è facile da capire, se le frasi sono troppo complesse e dove i lettori potrebbero confondersi. **Esempio di feedback:** * "Questo paragrafo usa molto la forma passiva, rendendolo difficile da seguire" * "Il gergo tecnico nella prima sezione potrebbe confondere i lettori non esperti" * "La lunghezza media delle frasi è di 35 parole – considera di spezzarle in frasi più brevi" **Come usarlo:** Semplifica le frasi, sostituisci il gergo con un linguaggio semplice o aggiungi definizioni per i termini tecnici. ### Feedback sulla completezza **Cosa ti dice:** Lacune nei tuoi contenuti – contesto mancante, domande senza risposta o aree che necessitano di più dettagli. **Esempio di feedback:** * "Il documento menziona 'il nuovo processo' ma non lo definisce mai" * "I passi 2 e 3 presuppongono conoscenze pregresse non trattate nell'introduzione" * "Non è presente una conclusione o i prossimi passi" **Come usarlo:** Aggiungi il background mancante, espandi le sezioni scarne o includi riepiloghi e conclusioni. ### Feedback sulla qualità **Cosa ti dice:** Coerenza del tono, problemi di formattazione e opportunità per raffinare i tuoi contenuti. **Esempio di feedback:** * "Il tono cambia da formale a informale tra le sezioni" * "I punti elenco hanno una formattazione incoerente (alcuni terminano con il punto, altri no)" * "Questo concetto viene spiegato due volte – considera di consolidarlo" **Come usarlo:** Standardizza la formattazione, mantieni un tono coerente, elimina le ridondanze. ## Utilizzo La Revisione documento consuma più quota AI rispetto a una semplice domanda perché analizza l'intero documento in un unico passaggio. Documenti più lunghi e complessi consumano di più. Usa **Fast** per revisioni più rapide e leggere. L'utilizzo effettivo dipende dalla lunghezza del documento, dalla struttura, dalla complessità della formattazione e dal modello scelto. Controlla il tuo utilizzo nel menu dell'Assistant sotto **Utilizzo e limiti**. Il feedback completo spesso fa risparmiare tempo e migliora la qualità in modo più efficiente rispetto a più query individuali. ## Consigli per revisioni migliori **1. Prepara prima il documento** Assicurati che il documento sia ragionevolmente completo prima di eseguire una revisione. L'Assistant fornisce un feedback migliore su bozze finite piuttosto che su schemi approssimativi. **2. Specifica il tuo pubblico** In un prompt di follow-up, indica all'Assistant a chi è destinato il documento: * "Questo è per un team tecnico che conosce il prodotto" * "Il pubblico è composto da stakeholder non tecnici" * "Scritto per nuovi utenti che non hanno mai usato Craft" Questo contesto aiuta l'Assistant a personalizzare il feedback in base alle tue esigenze specifiche. **3. Chiedi un feedback prioritario** Se la revisione identifica molti problemi, chiedi all'Assistant di dare la priorità: * "Quali 3 problemi devo risolvere per primi?" * "Qual è il problema strutturale più critico?" * "Concentrati solo sui problemi di chiarezza" **4. Richiedi tipi specifici di feedback** Puoi guidare la revisione chiedendo un'analisi mirata: * "Rivedi questo per la coerenza del tono" * "Controlla solo la completezza e il contesto mancante" * "Concentrati sul fatto che la struttura abbia senso per un pubblico principiante" **5. Usa il modello giusto** * **On-device:** Non consigliato per la Revisione documento (contesto limitato) * **Core:** Controlli strutturali rapidi su documenti brevi * **Fast:** Buon equilibrio per la maggior parte delle revisioni (500-2000 parole) * **Max:** Ideale per documenti lunghi e complessi o quando hai bisogno del feedback più approfondito ## Esempio: Prima di pubblicare un post del blog Sara scrive un post del blog sull'uso delle Collezioni in Craft. Prima di pubblicarlo, vuole assicurarsi che sia chiaro e completo. Sara apre la bozza del post del blog in Craft. Clicca sull'icona dell'Assistant e seleziona **Revisione documento**. L'Assistant analizza il documento e fornisce feedback: * **Struttura:** "L'introduzione è solida, ma la Sezione 2 è due volte più lunga delle Sezioni 3 e 4 messe insieme. Considera di dividerla in due parti." * **Chiarezza:** "Diversi termini tecnici (relazioni, proprietà, viste) vengono usati prima di essere definiti. Aggiungi un glossario o definiscili al primo utilizzo." * **Completezza:** "Il post spiega *cosa* sono le Collezioni ma non tratta *quando* usarle rispetto a cartelle o tag." * **Qualità:** "Il tono è coerente. Una sezione ridondante alla fine riprende l'introduzione – considera di rimuoverla." Sara apporta modifiche in base al feedback: divide la Sezione 2, aggiunge definizioni, include una sezione "Quando usare le Collezioni" e rimuove le ridondanze. Esegue di nuovo la Revisione documento. L'Assistant conferma che i problemi sono risolti. Sara pubblica con fiducia, sapendo che il contenuto è chiaro e completo. ## Limitazioni La Revisione documento fornisce feedback ma non applica le modifiche direttamente. Per agire sui suggerimenti, passa alla modalità **Esegui** con un modello **Fast** o **Max** e chiedi all'Assistant di implementare le modifiche raccomandate. Consulta [Modifica con Craft Assistant](/it/ai-assistant/editing). Per documenti molto brevi (meno di 200 parole), la Revisione documento potrebbe non fornire molto valore – la chat generale con l'Assistant è spesso più appropriata per attività rapide. ## Articoli correlati Scopri come lavorare con l'Assistant e avviare conversazioni Seleziona il modello giusto per la Revisione documento e altre attività Applica i suggerimenti della revisione direttamente in modalità Esegui Crea istruzioni di revisione riutilizzabili per feedback coerenti Scopri l'utilizzo AI per la Revisione documento e altre funzionalità