Un formulario de Word con cuadros de texto, un menú desplegable de departamentos y una casilla de verificación de código de conducta, y una hoja de cálculo con treinta nuevas contrataciones: eso es una mañana de copiar y pegar, o un solo prompt. Con el servidor GroupDocs.Editor MCP ejecutándose localmente, Claude, Cursor o Copilot primero preguntan al formulario qué campos tiene, luego rellenan una copia por fila y guardan cada una con el nombre de la persona. El diseño del formulario permanece intacto, y cualquier valor que no tenga un campo coincidente se informa en lugar de descartarse silenciosamente:

Lee new-employee-form.docx, luego rellena una copia por fila de new-hires.csv y nombra cada archivo con el nombre del empleado.

La versión paso a paso está en la documentación: Cómo rellenar campos de formularios de Word a partir de datos con un agente de IA.

¿Quién lee la hoja de cálculo?

El agente lo hace, y vale la pena ser claros al respecto. El servidor Editor trabaja sobre el formulario de Word; no lee tu CSV ni tu libro de trabajo. El agente lee las filas con sus propias herramientas de archivo, o tú las pegas, y luego realiza una llamada fill_form_fields por fila con un outputName por persona. Esa división es una característica: los datos nunca necesitan estar en un formato que el servidor entienda, y el agente puede limpiarlos en el camino (dividir un nombre completo, normalizar una fecha) antes de que entren en el formulario.

Pregunta al formulario primero

Los nombres de campo en los formularios de Word rara vez coinciden con la etiqueta que aparece en la página. La etiqueta dice “Full name:”, mientras que el campo podría llamarse FullName, Text1 o Name_Employee. Adivinar es cómo los formularios vuelven medio vacíos. get_form_fields devuelve los nombres reales, los tipos y los valores actuales. Capturado de GroupDocs.Editor.Mcp 26.10.0 contra un formulario sintético de incorporación (salida abreviada):

-> get_form_fields {"file":{"filePath":"new-employee-form.docx"}}
<- { "count": 6, "fields": [
     { "name": "FullName",   "type": "Text",     "value": "" },
     { "name": "Email",      "type": "Text",     "value": "" },
     { "name": "StartDate",  "type": "Text",     "value": "" },
     { "name": "Department", "type": "DropDown",
       "value": { "options": [ "Engineering", "Finance", "Sales",
                               "Operations" ], "selected": "Engineering" } },
     { "name": "Agree",      "type": "CheckBox", "value": false },
     { "name": "Newsletter", "type": "CheckBox", "value": false } ] }

El menú desplegable viene con sus opciones, por lo que el agente puede mapear “finance” en la hoja de cálculo a la entrada exacta “Finance” en lugar de inventar un sexto departamento.

Luego rellena una fila

-> fill_form_fields {"file":{"filePath":"new-employee-form.docx"},
     "values":{"FullName":"Amara Okafor",
               "Email":"amara.okafor@northwind.example",
               "StartDate":"2026-12-01","Department":"Finance",
               "Agree":"true","Phone":"+31 10 555 0100"}}
<- Updated 5 field(s) in 'new-employee-form.docx': FullName, Email,
   StartDate, Department, Agree.
   Not found: Phone. Call get_form_fields for the exact names.
   Saved to: …/new-employee-form_edited.docx

La hoja de cálculo tenía una columna de teléfono para la cual el formulario no tiene campo. El servidor rellenó los cinco campos que existen y nombró el que no existe. Leer la copia rellenada con get_form_fields muestra los valores en su lugar, "selected": "Finance" y "Agree": true incluidos, y Newsletter sigue sin marcar porque la fila no indicaba lo contrario.

Todo el lote

new-hires.csv (agent reads it)          new-employee-form.docx
  Amara Okafor, Finance, ...  ---+
  Tomas Varga, Sales, ...     ---+      get_form_fields (once)
  ...                            |        -> FullName, Email, StartDate,
                                 |           Department, Agree, ...
                                 v
  fill_form_fields {"values":{...row...},
                    "outputName":"form-amara-okafor.docx"}   x one per row
     -> "Updated 5 field(s) ... Not found: Phone"
     -> form-amara-okafor.docx, form-tomas-varga.docx, ...

Tres instrucciones hacen que el lote sea fiable: llama a get_form_fields una vez y asigna las columnas a los nombres de campo antes del primer relleno; da a cada fila su propio outputName, porque de lo contrario las copias se acumulan como new-employee-form_edited.docx, new-employee-form_edited (1).docx y así sucesivamente, sin el nombre de nadie; y recopila las líneas “Not found” en un solo informe al final en lugar de detenerse en la primera.

Un prompt que funciona en la primera fila

La mayoría de los fallos en lote ocurren en la primera fila y luego se repiten treinta veces. Pide una ejecución de prueba primero:

Lee los campos de new-employee-form.docx y la cabecera de new-hires.csv. Muéstrame qué columna va a qué campo, y qué columnas no tienen campo. Luego rellena solo la primera fila y detente.

El agente responde con una pequeña tabla de mapeo, Name -> FullName, Dept -> Department, Phone -> (no field), y un formulario rellenado que puedes abrir. Si la ortografía del departamento o el formato de la fecha son incorrectos, lo ves una vez, corriges la instrucción y luego pides el resto. Ese paso de revisión cuesta un minuto y es la diferencia entre treinta formularios correctos y treinta formularios que necesitan ser revisados manualmente.

También resuelve las preguntas que la hoja de cálculo no puede responder por sí sola. ¿Debe una celda vacía de “Agree” significar sin marcar, o debe omitirse la fila? ¿El “2026-12-01” debe ir al campo de fecha tal cual, o como “1 de diciembre de 2026”? El agente seguirá lo que digas, pero debe ser informado.

Qué más manejan las herramientas de formulario

Los campos de texto, número y fecha se rellenan con cadenas; las casillas de verificación aceptan "true" o "false"; los menús desplegables aceptan una de sus opciones. format guarda la copia rellenada como DOC, RTF u ODT en lugar de DOCX; un formulario rellenado es siempre un documento de Word, por lo que un PDF para el nuevo empleado es una conversión separada posterior. Un formulario protegido con contraseña se abre con password y permanece protegido. La copia rellenada se escribe mediante el motor de campos de formulario en lugar de a través de HTML, por lo que los encabezados, pies de página y números de página se conservan tal como estaban. Las herramientas leen formularios DOCX, DOC, DOCM, DOT, DOTX, RTF y ODT.

Límites honestos

  • Solo formularios de Word, y solo campos de formulario heredados: los campos de texto, casilla de verificación y menú desplegable que Word inserta desde Developer → Legacy Tools. Los controles de contenido no se enumeran ni se rellenan. Los formularios PDF (AcroForms) no están dentro del alcance de este servidor.
  • El servidor no lee la hoja de cálculo; el agente suministra los valores, así que verifica su mapeo de columnas en la primera fila antes de permitir que se ejecute en todas ellas.
  • Una llamada rellena un formulario. Un lote de treinta equivale a treinta llamadas.
  • El modo de evaluación agrega una línea de banner en la parte superior de cada copia rellenada, por lo que la salida sin licencia es un borrador, no algo para enviar a los nuevos empleados.

Preguntas frecuentes

¿Cómo sabe el agente los nombres de los campos?
Pregunta: get_form_fields devuelve el nombre, tipo y valor actual de cada campo, y las opciones de cada menú desplegable.

¿Qué ocurre con un valor para el que el formulario no tiene campo?
Se omite y se menciona en la respuesta (“Not found: Phone”), para que el agente pueda informarlo.

¿Se modifica mi formulario original?
No. Cada relleno escribe un nuevo archivo; la plantilla permanece en blanco para la siguiente fila.

Profundiza