Strumenti DOCX

Presentazione

Strumenti DOCX professionali per creare, modificare e gestire documenti Word.

Con questa skill puoi:

• Creare nuovi file .docx con controllo completo su stili, tabelle e layout
• Aprire e modificare documenti esistenti a livello OOXML (XML) quando serve massima precisione
• Leggere, ripulire e accettare revisioni e commenti
• Convertire tra formati come .doc, .docx, PDF, HTML e ODT
• Validare e riparare la struttura OOXML prima di inviare documenti ai clienti
• Confrontare due versioni di un documento e generare un redline con revisioni tracciate

Per iniziare

Aggiungi i file di origine allo spazio di lavoro del progetto e attiva la skill Strumenti DOCX. L’agente ti guiderà passo dopo passo.

Workflow tipici

• Redigere un documento Word curato: Chiedi all’agente di creare un nuovo .docx con sezioni, titoli, tabelle e stili necessari. Dietro le quinte usa docx_build, così il file si apre in modo pulito in Word.
• Rivedere le revisioni tracciate: Quando un documento ha una lunga storia di modifiche, l’agente può usare docx_extract_text per mostrare una vista Markdown più leggibile, oppure docx_accept_changes per consolidare tutte le revisioni in una nuova versione finale.
• Chirurgia a livello XML: Per problemi complessi di formattazione o corruzione, l’agente può eseguire docx_unpack per estrarre l’XML, modificare direttamente, usare docx_validate per trovare problemi strutturali e poi docx_pack per generare un nuovo .docx pulito.
• Convertire i formati in sicurezza: Usa docx_convert quando devi passare da .doc a .docx, PDF, HTML o ODT preservando il più possibile la struttura.
• Confrontare versioni con redline: Dopo aver modificato un contratto o un rapporto, l’agente può eseguire docx_compare per generare una versione con redline che si apre in Word con la modalità Revisioni attiva.
• Generare immagini da PDF: Usa docx_pdf_to_images per produrre immagini, pagina per pagina, da un PDF per controllo visivo o per incorporarle in altri documenti.

Riferimento strumenti

La skill Strumenti DOCX espone dieci strumenti specializzati. Non serve ricordare i loro nomi: l’agente sceglie quello giusto, ma questo riferimento spiega cosa è disponibile.

Creare nuovi documenti

• docx_build: Costruisce file .docx in modo programmatico usando la libreria JavaScript docx. Ideale per documenti strutturati (contratti, report, template) con controllo preciso su sezioni, paragrafi, tabelle e formattazione.

Leggere e ripulire il contenuto

• docx_extract_text: Estrae il testo di un file .docx in formato Markdown. Puoi scegliere se:

  • mostrare sia inserimenti che eliminazioni,
  • mostrare solo il testo finale (come se tutte le revisioni fossero state accettate),
  • oppure mostrare il testo originale (come se tutte le revisioni fossero state rifiutate).

• docx_accept_changes: Accetta tutte le revisioni tracciate in un file .docx e scrive il risultato in un nuovo file. Utile quando serve una versione finale pulita, senza cronologia di modifica.

Workflow XML / OOXML

Questi strumenti vengono usati insieme quando l’agente deve lavorare direttamente con OOXML:

• docx_unpack: Decomprime un file .docx in una directory modificabile di file XML, unisce i run con formattazione identica e applica il pretty-printing per migliorare la leggibilità.
• docx_validate: Verifica un file .docx o una directory decompressa alla ricerca di problemi strutturali (file obbligatori mancanti, XML non valido, relazioni rotte) e può riparare automaticamente i problemi più comuni.
• docx_pack: Ricompatta una directory XML decompressa in un nuovo file .docx una volta superata la validazione.

Commenti di revisione e collaborazione

• docx_add_comment: Aggiunge un commento di revisione — o una risposta a un commento esistente — a un documento decompressato. I commenti vengono ancorati a frammenti di testo specifici per comparire nel punto previsto in Word.

Conversioni e confronti

• docx_convert: Usa LibreOffice in modalità headless per convertire documenti tra formati, ad esempio:

  • .doc → .docx
  • .docx → pdf
  • .docx → html
  • .odt → .docx

• docx_compare: Confronta una .docx “originale” e una .docx “modificata” e produce un terzo documento con redline. Aprendo il risultato in Word, i revisori vedono inserimenti, eliminazioni e spostamenti come revisioni tracciate.

Pagine PDF in immagini

• docx_pdf_to_images: Converte le pagine di un PDF in immagini JPEG o PNG con la risoluzione scelta. Utile per QA visivo, presentazioni o per inserire miniature di pagina in altri documenti.

Buone pratiche

• Non sovrascrivere mai il file originale: L’agente scrive sempre in un nuovo percorso (ad esempio con suffissi _clean, _final, _redlined) così puoi confrontare e tornare indietro.
• Validare prima di condividere: Per documenti critici verso clienti, chiedi all’agente di eseguire docx_validate per intercettare eventuali problemi OOXML prima dell’invio.
• Scegliere bene tra build e XML: Preferisci docx_build per nuovi documenti e usa il flusso decomprimere/validare/ricomprimere solo quando servono correzioni di basso livello o ispezione diretta dell’XML.