Word

NappAI tiene dos componentes para trabajar con documentos de Word guardados en Microsoft 365. En el editor los encuentras en el grupo de Microsoft con estos nombres:

• Document trabaja con el contenido de un documento: lo lee, inserta párrafos o texto, busca y reemplaza palabras, muestra su estructura y aplica formato.
• Management gestiona los archivos: busca documentos en una carpeta, consulta sus datos, los crea (también a partir de una plantilla), los copia y los elimina.

Los dos trabajan con documentos en formato .docx.

Cuándo usarlo

• Quieres generar un contrato o una propuesta a partir de una plantilla de Word, rellenando el nombre del cliente y las condiciones.
• Un agente de IA tiene que leer un documento de Word para responder preguntas sobre él.
• Necesitas actualizar en un documento una fecha, un precio o un nombre que aparece varias veces.
• Quieres localizar todos los documentos de Word de una carpeta para procesarlos.
• Antes de modificar un documento, quieres guardar una copia en otra carpeta.

Document

Configuración

Necesitas una credencial Microsoft Word, que se conecta iniciando sesión con tu cuenta de Microsoft. Al crearla eliges el acceso: con Read Only solo puedes leer; para modificar documentos elige Full Access. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial Microsoft Word con la que se accede a tus documentos.
Operation (obligatorio)	Lo que hace el componente. Ver la tabla de operaciones de Document. Por defecto, Get Document Content.
Selection Mode	Cómo indicas el documento: By Selector (lo eliges en tu OneDrive) o By Manual Entry (escribes su identificador). Por defecto, By Selector.
Select Documents (obligatorio)	El documento con el que trabajas, elegido en tu OneDrive. Con By Selector.
Document ID (obligatorio)	El identificador del documento. Lo obtienes con Management y la operación Search Documents. Con By Manual Entry.
Drive ID	El identificador de la unidad de OneDrive o de la biblioteca de SharePoint donde está el documento. Vacío, se usa tu OneDrive. Con By Manual Entry.
Content Format	Cómo se devuelve el contenido: plain_text (texto sin formato), html, markdown o structured (separado por párrafos). Por defecto, plain_text. Solo en Get Document Content.
Paragraph Text	El texto del párrafo nuevo. Solo en Insert Paragraph.
Text Content	El texto que se añade dentro de un párrafo existente. Solo en Insert Text.
Insert Position	Dónde se inserta. En Insert Paragraph: Start (al principio del documento), End (al final), Before Paragraph o After Paragraph (antes o después de un párrafo concreto); por defecto, End. En Insert Text: Before Paragraph (al principio del párrafo) o After Paragraph (al final del párrafo).
Paragraph Index	El número del párrafo de referencia, contando desde 0 para el primero. Aparece cuando Insert Position es Before Paragraph o After Paragraph.
Search Text	El texto que se busca. En Search Text y Replace Text. En Apply Formatting, el texto al que se aplica el formato; vacío, se aplica a todo el documento.
Replace Text	El texto que sustituye al encontrado. Solo en Replace Text.
Replace Mode	Cómo se reemplaza: first_occurrence (solo la primera aparición), all_occurrences (todas), case_sensitive (todas, respetando mayúsculas y minúsculas) o whole_words_only (solo palabras completas). Por defecto, all_occurrences. Solo en Replace Text.
Formatting Options	El formato que se aplica: bold (negrita, true o false), italic (cursiva, true o false), color (por ejemplo #FF0000) y font_size (tamaño en puntos). Solo en Apply Formatting.

Operaciones de Document

Operación	Qué hace
Get Document Content	Devuelve el texto del documento en el formato elegido, con el número de caracteres y de palabras.
Insert Paragraph	Añade un párrafo nuevo al principio, al final o junto a un párrafo concreto.
Insert Text	Añade texto al principio o al final de un párrafo existente.
Search Text	Busca un texto y devuelve dónde aparece y cuántas veces.
Replace Text	Sustituye un texto por otro y devuelve cuántos cambios ha hecho.
Get Document Structure	Devuelve los párrafos, las tablas y las imágenes del documento, con el número de cada párrafo. Es útil para saber qué Paragraph Index usar.
Apply Formatting	Aplica negrita, cursiva, color o tamaño de letra a un texto o a todo el documento.

Resultado de Document

La salida Data devuelve un único elemento con el resultado: el texto extraído, las coincidencias encontradas, la estructura del documento o la confirmación del cambio realizado. Si una operación falla, la salida trae un elemento con el mensaje de error en lugar de detener el flujo.

Management

Configuración

Usa la misma credencial Microsoft Word. Para crear, copiar o eliminar documentos necesitas el acceso Full Access.

Campo	Qué hace
Credential (obligatorio)	La credencial Microsoft Word con la que se accede a tus documentos.
Operation (obligatorio)	Lo que hace el componente. Ver la tabla de operaciones de Management. Por defecto, Search Documents.
Mode	Simple muestra solo los campos imprescindibles; Advanced añade Search Query, Template Data y New Document Name. Por defecto, Simple. En Search Documents, Copy Document y Create Document.
Selection Mode	Cómo indicas carpetas y documentos: By Selector (los eliges en tu OneDrive) o By Manual Entry (escribes sus rutas e identificadores en Folder Path, Target Folder Path, Document ID y Drive ID). Por defecto, By Selector.
Select Folder Path (obligatorio)	La carpeta donde se busca o donde se crea el documento. En Search Documents y Create Document.
Select Documents (obligatorio)	El documento con el que trabajas. En Delete Document, Get Document Info y Copy Document.
Select Target Folder Path (obligatorio)	La carpeta donde se guarda la copia. Solo en Copy Document.
Document Name (obligatorio)	El nombre del documento nuevo. Si no termina en .docx, se añade. Solo en Create Document.
Search Query	Texto que se busca en el nombre o en el contenido de los documentos. Vacío, se devuelven los documentos de Word de la carpeta. Solo con Mode en Advanced, en Search Documents.
Shallow Search	Si está activado, solo se busca en la carpeta indicada; si no, también en sus subcarpetas. Desactivado por defecto. Solo en Search Documents.
Documents Count	Cuántos documentos se devuelven como máximo. Por defecto, 50. Solo en Search Documents.
Template Data	Para crear el documento a partir de una plantilla. Indica template_path, la ruta de la plantilla en tu OneDrive, y replacements, las marcas de la plantilla y el texto que las sustituye, por ejemplo {{cliente}} por Construcciones Ribera. Vacío, se crea un documento en blanco. Solo con Mode en Advanced, en Create Document.
New Document Name	El nombre de la copia. Vacío, se usa el nombre original con (copy). Solo con Mode en Advanced, en Copy Document.

Operaciones de Management

Operación	Qué hace
Search Documents	Busca documentos de Word en una carpeta y devuelve su nombre, identificador, enlace, tamaño y fecha de modificación.
Delete Document	Elimina un documento.
Get Document Info	Devuelve los datos de un documento: tamaño, enlaces de acceso y de descarga, fechas, quién lo creó y quién lo modificó por última vez.
Copy Document	Copia un documento en otra carpeta.
Create Document	Crea un documento nuevo, en blanco o a partir de una plantilla.

Resultado de Management

La salida Data devuelve un elemento por cada documento encontrado, o un único elemento con el resultado: el documento creado o copiado con su identificador y enlace, sus datos o la confirmación de la eliminación. Si una operación falla, la salida trae un elemento con el mensaje de error en lugar de detener el flujo.

Los dos componentes se pueden conectar a un Agente como herramienta, para que el agente decida cuándo leer, editar o crear documentos. Ver Tool Mode.

Ejemplo

Una asesoría quiere preparar automáticamente la carta de encargo de cada cliente nuevo a partir de su plantilla.

1. En OneDrive, la plantilla /Plantillas/Carta de encargo.docx contiene marcas como {{cliente}} y {{fecha}}.
2. Añade Management con la operación Create Document, la credencial Microsoft Word de la asesoría y Mode en Advanced.
3. En Select Folder Path elige la carpeta Clientes, en Document Name el nombre del cliente seguido de Carta de encargo y en Template Data la ruta de la plantilla y los valores de {{cliente}} y {{fecha}}.
4. Si quieres resaltar el nombre del cliente, conecta el resultado a Document con la operación Apply Formatting, el nombre en Search Text y bold en Formatting Options.

Buenas prácticas

• Antes de usar Insert Paragraph o Insert Text junto a un párrafo concreto, consulta su número con Get Document Structure.
• Antes de reemplazar texto en un documento importante, haz una copia con Copy Document.
• Delete Document no pide confirmación.

Componentes relacionados

• Excel: leer y escribir datos en libros de Excel.
• Files: leer, subir y gestionar archivos de OneDrive.
• Search: buscar archivos en OneDrive y SharePoint.