¿Macros o funciones de IA? Entendiendo las herramientas de ONLYOFFICE

5 febrero 2026Por Dea

ONLYOFFICE te ofrece potentes formas de automatizar tu trabajo con documentos mediante macros y funciones de IA, ayudándote a ahorrar tiempo, reducir el trabajo manual y trabajar de forma más eficiente.

Ambas te permiten trabajar más rápido e inteligentemente, pero funcionan de manera diferente y se adaptan a distintas necesidades. Ya seas un desarrollador que crea soluciones personalizadas o simplemente alguien que quiere ser más productivo, esta guía te ayudará a elegir la herramienta adecuada para ti.

Entendiendo lo básico

¿Qué son las macros de ONLYOFFICE?

Las macros de ONLYOFFICE son pequeños scripts que automatizan tareas repetitivas en documentos, hojas de cálculo y presentaciones. Utilizan JavaScript y la API de Office, lo que te permite dar formato al contenido, actualizar datos y crear flujos de trabajo personalizados directamente en el editor.

Cómo usar macros:

Abre la pestaña Vista y haz clic en Macros
Escribe código JavaScript usando la API de Office
Haz clic en Ejecutar para lanzar la macro
El script manipula el documento directamente

Nota! Desde la versión 7.1, las macros se ejecutan en modo estricto. Esto significa que debes declarar todas las variables con let o const antes de usarlas. No se pueden usar las funciones window, document ni alert.

Ejemplo: colorear filas de una tabla

(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)
      );
  }
})();

Esta macro colorea 200 filas de forma alternada en menos de un segundo, una tarea que llevaría bastante tiempo hacer manualmente.

¿Qué son las funciones de IA de ONLYOFFICE?

Las funciones de IA conectan ONLYOFFICE con modelos de inteligencia artificial como ChatGPT. Permiten ejecutar acciones automatizadas en documentos mediante prompts, de modo que el editor realiza operaciones basadas en tu solicitud. Las funciones de IA forman parte del plugin de IA (actualmente en beta), introducido en la versión 2.4.2.

Configuración

Clona el repositorio onlyoffice.github.io en tu máquina local.
Escribe tu función de IA en la carpeta helpers (sdkjs-plugins/content/ai/.dev/helpers).
Dependiendo del tipo de editor, colócala en la carpeta correspondiente cell, slide, o word.
Actualiza la versión actual del plugin de IA en config.js para evitar problemas de caché
(por ejemplo, 3.0.3 → 3.0.4).
Ejecuta el archivo helpers helpers.py.
Selecciona todos los archivos del plugin en la carpeta ai (sdkjs-plugins/content/ai), comprímelos en un archivo ZIP y renómbralo a ai.plugin.
Coloca el archivo nuevamente en sdkjs-plugins/content/ai/deploy.
Sube los cambios.
Construye tu sitio de GitHub Pages desde este repositorio(consulta la documentación deGitHub Pages).
Prepara un enlace a tu tienda personalizada añadiendo /store/index.html a la URL de GitHub Pages:
https://YOUR-USERNAME.github.io/onlyoffice.github.io/store/index.html
Ve a Extensiones → Administrador de plugins.
Haz clic en el icono Store (</>) en la esquina superior derecha del Administrador de plugins e introduce la URL de tu tienda personalizada.
Actualiza el plugin de IA.

Nota: Para instrucciones más detalladas, visita este artículo.

Cómo usar las funciones de IA

Configura tu proveedor de IA y la clave de la API si es necesario.
Presiona Ctrl + / para abrir el chat de IA.
Escribe lo que quieras (por ejemplo, “Explica este texto”).
La IA selecciona la función adecuada y realiza el trabajo.
El resultado aparece en tu documento.

Las funciones de IA recuerdan tu conversación. Puedes hacer preguntas de seguimiento o refinar los resultados. Presiona Ctrl + Alt + / para empezar desde cero.

Ejemplo: añadir comentarios con IA

La función commentText agrega comentarios inteligentes al texto seleccionado:

Selecciona un fragmento de texto en tu documento.
Presiona Ctrl + / para abrir el chat de IA.
Escribe: “Explica este texto”.
Presiona Enter.

La IA lee el texto, genera una explicación y la añade como un comentario en tu documento.

Cómo funciona internamente:

// 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);
    });
  });
};

Puedes ver el código completo de la función commentText aquí.

Por qué las funciones de IA son más flexibles

Las funciones de IA invocan CallCommand por separado (ver las líneas en el código anterior), lo que permite ejecutar lógica personalizada antes y después de las operaciones sobre el documento. Esto las hace ideales para la integración con IA: puedes enviar solicitudes al modelo de IA, procesar la respuesta y luego actualizar el documento. La aplicación de Macros encapsula todo dentro de CallCommand, lo cual es más sencillo, pero menos flexible.

Diferencias principales

Las macros están pensadas para la manipulación directa y sin conexión de documentos. Las funciones de IA sirven para integrar modelos de IA con ONLYOFFICE.

Comparación:

Aspecto	Macro	Función de IA
Configuración	Fácil – ya integradas	Más compleja – proveedor de IA + funciones personalizadas
Costo	Gratis	De pago (el proveedor de IA cobra)
Internet	Funciona sin conexión	Requiere conexión a un servicio de IA
Requisitos previos	JavaScript + API de Office	JavaScript + API de Office + modificaciones del agente de IA
Curva de aprendizaje	Pronunciada para no programadores	Pronunciada para no programadores
Consistencia de resultados	Siempre el mismo resultado	Puede variar
Flexibilidad	Limitada – envuelta en `CallCommand`	Más flexible – invoca `CallCommand` por separado
Rendimiento	Rápido – ejecución directa	Variable – depende del tiempo de respuesta de la IA
Compatibilidad de versiones	Disponible desde versiones tempranas	Beta (desde la v2.4.2)
Ideal para	Desarrolladores, control preciso, automatización sin conexión	Tareas asistidas por IA, operaciones y procesamiento de documentos
Privacidad	Ejecución local únicamente	Los datos se envían a un servicio externo de IA

Cuándo usar cada herramienta

Macros

Elige macros cuando necesites manipular documentos directamente:

Trabajo sin conexión: no se requiere conexión a internet.
Sin costo: automatiza todo lo que quieras de forma gratuita.
Operaciones directas sobre el documento: formato, manipulación de datos, cálculos.
Resultados exactos: la misma entrada siempre produce el mismo resultado.
Prototipado rápido: escribe el código y pruébalo inmediatamente en el editor.
Trabajo en producción: informes financieros, documentos de cumplimiento normativo, flujos de trabajo automatizados.

Funciones de IA

Elige funciones de IA cuando tu automatización requiera capacidades de inteligencia artificial:

Integración con modelos de IA: conecta con servicios de IA y utiliza sus resultados.
Automatización de documentos: aplica directamente los resultados de la IA al documento.
Procesamiento con contexto: maneja el contenido teniendo en cuenta la selección o la estructura del documento.
Lógica avanzada: mayor flexibilidad para ejecutar código personalizado antes y después de las operaciones sobre el documento.

Conclusión

Las macros y las funciones de IA de ONLYOFFICE cumplen propósitos diferentes. La distinción clave es sencilla:

Las macros están pensadas para la manipulación directa de documentos. Son gratuitas, funcionan sin conexión y son ideales para cualquier automatización que no necesite IA. Úsalas para formato, cálculos, manipulación de datos y fórmulas personalizadas.

Las funciones de IA sirven para integrar modelos de inteligencia artificial con ONLYOFFICE. Son más complejas de desarrollar que las macros, requieren conexión a internet y costos asociados al proveedor de IA, pero son la opción correcta cuando necesitas capacidades de IA. Úsalas para generación de contenido, procesamiento de documentos y automatización de tareas con IA.

ONLYOFFICE continúa mejorando ambas herramientas. Las macros están incorporando nuevas funciones, como operaciones asíncronas. Las funciones de IA están saliendo de la fase beta, con mayor fiabilidad y más capacidades. Comprender ambas te permite aprovechar todo el potencial de la automatización en ONLYOFFICE.