Macro o funzioni AI? Comprendere gli strumenti ONLYOFFICE

4 febbraio 2026Da Alice

ONLYOFFICE ti offre strumenti potenti per automatizzare il lavoro sui documenti usando macro e funzioni AI aiutandoti a risparmiare tempo, ridurre il lavoro manuale e lavorare in modo più efficiente.

Entrambi ti aiutano a lavorare più velocemente e in modo più intelligente, ma funzionano in modo diverso e rispondono a esigenze diverse. Che tu sia uno sviluppatore che crea soluzioni personalizzate o semplicemente qualcuno che vuole lavorare in modo più efficiente, questa guida ti aiuterà a scegliere lo strumento giusto per le tue esigenze.

Macros or AI Functions? Understanding ONLYOFFICE Tools

Capire le basi

Cosa sono le macro di ONLYOFFICE?

Le macro di ONLYOFFICE sono piccoli script che automatizzano attività ripetitive in documenti, fogli di calcolo e presentazioni. Usano JavaScript e l’Office API, permettendoti di formattare i contenuti, aggiornare i dati e creare flussi di lavoro personalizzati direttamente nell’editor.

Come usare le macro:

Apri la scheda Visualizza e fai clic su Macro
Scrivi codice JavaScript usando l’Office API
Fai clic su Esegui per avviare la macro
Lo script modifica direttamente il documento

Nota! Dalla versione 7.1, le macro vengono eseguite in modalità strict. Questo significa che devi dichiarare tutte le variabili con let o const prima di usarle. Non puoi usare le funzioni window, document o alert .
Esempio: colorare le righe di una tabella

(function () {
  let worksheet = Api.GetActiveSheet();
  for (let i = 1; i < 200; i += 2) {
    let rowOdd = i,
      rowEven = i + 1;
    worksheet.GetRange(
      "A" + rowOdd + ":S" + rowOdd).SetFillColor(Api.CreateColorFromRGB(138, 181, 155)
      );
    worksheet.GetRange(
      "A" + rowEven + ":S" + rowEven).SetFillColor(Api.CreateColorFromRGB(216, 227, 220)
      );
  }
})();

Questa macro colora alternativamente 200 righe in meno di un secondo, un’operazione che manualmente richiederebbe parecchio tempo.

Cosa sono le funzioni AI di ONLYOFFICE?

Le funzioni AI collegano ONLYOFFICE a modelli di intelligenza artificiale come ChatGPT, e consentono di eseguire azioni sui documenti basate sull’AI tramite prompt, permettendo all’editor di svolgere operazioni automatizzate in base alla tua richiesta. Le funzioni AI fanno parte del plugin AI (attualmente in beta), introdotto nella versione 2.4.2.

Configurazione

Clona il repository onlyoffice.github.io sulla tua macchina locale.
Scrivi la tua funzione AI nella cartella helpers (sdkjs-plugins/content/ai/.dev/helpers).
A seconda del tipo di editor, inseriscila nella cartella cell, slide o word.
Aggiorna la versione corrente del plugin AI in config.js per evitare problemi di cache
(ad esempio, 3.0.3 → 3.0.4).
Esegui il file helpers.py.
Seleziona tutti i file del plugin nella cartella ai (sdkjs-plugins/content/ai), comprimili in un archivio zip e rinominalo in ai.plugin.
Inserisci di nuovo il file in sdkjs-plugins/content/ai/deploy.
Invia le modifiche.
Costruisci il tuo sito GitHub Pages a partire da questo repository (vedi la documentazione di GitHub Pages).
Prepara un link al tuo store personalizzato aggiungendo /store/index.html all’URL delle tue GitHub Pages:
https://YOUR-USERNAME.github.io/onlyoffice.github.io/store/index.html
Vai su Plugin → Gestione plugin.
Fai clic sull’icona Store (</>) in alto a destra nella Gestione plugin e inserisci l’URL del tuo store personalizzato.
Aggiorna il plugin AI.

Nota! Per istruzioni più dettagliate, visita questo articolo.

Come usare le funzioni AI

Configura il tuo provider AI e la API Key, se necessario.
Premi Ctrl + / per aprire la chat AI.
Scrivi quello che vuoi (ad esempio “Spiega questo testo”).
L’AI seleziona la funzione giusta ed esegue l’operazione.
Il risultato appare nel documento.

Le funzioni AI ricordano la conversazione. Puoi fare domande di follow-up o affinare i risultati. Premi Ctrl + Alt + / per ricominciare da zero.

Esempio: aggiungere commenti AI

La funzione commentText aggiunge commenti intelligenti al testo selezionato:

Seleziona parte del testo nel documento.
Premi Ctrl + / per aprire la chat AI.
Scrivi: “Spiega questo testo”.
Premi Invio.

L’AI legge il testo, genera una spiegazione e la aggiunge come commento nel documento.

Ecco cosa succede dietro le quinte:

// Simplified structure of an AI Function
func.call = async function (params) {
  // 1. Get the selected text
  let text = await Asc.Editor.callCommand(function () {
    let doc = Api.GetDocument();
    let range = doc.GetRangeBySelect();
    return range ? range.GetText() : "";
  });
  // 2. Ask the AI model
  let requestEngine = AI.Request.create(AI.ActionType.Chat);
  let argPrompt = params.prompt + ":\n" + text;
  // 3. Add the AI's answer as a comment
  await requestEngine.chatRequest(argPrompt, false, async function (data) {
    await Asc.Editor.callCommand(function () {
      let doc = Api.GetDocument();
      let range = doc.GetRangeBySelect();
      range.AddComment(data, model, "uid" + model);
    });
  });
};

Puoi vedere il codice completo della funzione commentText qui.

Perché le funzioni AI sono più flessibili

Le funzioni AI richiamano CallCommand separatamente (vedi le righe nel codice sopra), il che consente di eseguire logica personalizzata prima e dopo le operazioni sul documento. Questo le rende perfette per l’integrazione dell’AI: puoi inviare richieste al modello AI, elaborare la risposta e poi aggiornare il documento. L’app Macro invece racchiude tutto all’interno di CallCommand, un approccio più semplice ma meno flessibile.

Differenze principali

Le macro servono per la manipolazione diretta dei documenti offline. Le funzioni AI servono per integrare modelli di intelligenza artificiale in ONLYOFFICE.

Ecco il confronto:

Aspetto	Macro	Funzioni AI
Configurazione	Semplice – già integrate	Più complessa – configurazione del provider AI + funzioni personalizzate
Costo	Gratuito	A pagamento (costi del provider AI)
Internet	Funziona offline	Richiede una connessione a un servizio AI
Prerequisiti	JavaScript + Office API	JavaScript + Office API + modifiche all’agente AI
Curva di apprendimento	Ripida per i non programmatori	Ripida per i non programmatori
Coerenza dei risultati	Output sempre identico	Può variare
Flessibilità	Limitata – tutto racchiuso in `CallCommand`	Maggiore – `CallCommand` invocato separatamente
Prestazioni	Veloci – esecuzione diretta	Variabili – dipendono dai tempi di risposta dell’AI
Supporto versioni	Disponibili dalle prime versioni	Beta (dalla v2.4.2)
Ideali per	Sviluppatori, controllo preciso, automazione offline	Attività assistite dall’AI, operazioni e elaborazione dei documenti
Privacy	Esecuzione solo locale	Dati inviati a un servizio AI esterno

Quando usare ciascuno strumento

Macro

Scegli le macro quando devi manipolare direttamente i documenti:

Lavoro offline – non serve una connessione internet.
Nessun costo – automatizza quanto vuoi gratuitamente.
Operazioni dirette sui documenti – formattazione, manipolazione dei dati, calcoli.
Risultati esatti – lo stesso input produce sempre lo stesso output.
Prototipazione rapida – scrivi il codice e testalo subito nell’editor.
Lavoro in produzione – report finanziari, documenti di conformità, flussi di lavoro automatizzati.

Funzioni AI

Scegli le funzioni AI quando l’automazione richiede capacità di intelligenza artificiale:

Integrazione di modelli AI – collegamento a servizi AI e utilizzo dei loro output.
Automazione dei documenti – applicazione diretta dei risultati AI al documento.
Elaborazione del contesto – gestione dei contenuti tenendo conto della selezione o della struttura del documento.
Logica avanzata – maggiore flessibilità per eseguire codice personalizzato prima/dopo le operazioni sul documento.

Conclusione

Le macro e le funzioni AI di ONLYOFFICE servono a scopi diversi. La differenza chiave è semplice:

Le macro servono per la manipolazione diretta dei documenti. Sono gratuite, funzionano offline e sono perfette per qualsiasi automazione che non richieda l’AI. Usale per formattazione, calcoli, manipolazione dei dati e formule personalizzate.

Le funzioni AI servono per integrare modelli di intelligenza artificiale in ONLYOFFICE. Sono più complesse da sviluppare rispetto alle macro, richiedono internet e costi legati al provider AI, ma sono la scelta giusta quando servono capacità AI. Usale per generare contenuti, elaborare documenti e automatizzare attività documentali con l’AI.

ONLYOFFICE continua a migliorare entrambi gli strumenti. Le macro stanno ricevendo nuove funzionalità come le funzioni asincrone. Le funzioni AI stanno uscendo dalla beta con maggiore affidabilità e più capacità. Conoscere entrambi ti dà tutta la potenza dell’automazione in ONLYOFFICE.