Para convertir por lotes una carpeta con un agente de IA, apunta el servidor GroupDocs.Conversion.Mcp a la carpeta y describe el trabajo en una sola frase. El agente recorre los archivos, llama al motor de conversión una vez por documento y reporta lo que ha producido, todo localmente en Claude, Cursor o GitHub Copilot. Es procesamiento por lotes impulsado por una frase:

Convertir todos los DOCX en mi carpeta de documentos a PDF, conservar los originales

La versión paso a paso con configuración y solución de problemas está en la documentación: How to batch-convert a folder of documents with an AI agent. Esta publicación recorre el mismo trabajo como una sesión breve, desde el primer prompt hasta el manejo de fallos.

¿Por dónde empiezas: la carpeta de almacenamiento o el prompt?

Empieza con la carpeta de almacenamiento. Un trabajo por lotes tiene éxito o falla según el mapeo de la carpeta, y el mapeo se establece una sola vez en la entrada del servidor, no en cada prompt. Dos variables de entorno lo controlan:

{
  "mcpServers": {
    "groupdocs-conversion": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Conversion.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/invoices",
        "GROUPDOCS_MCP_OUTPUT_PATH": "/path/to/invoices/converted"
      }
    }
  }
}

GROUPDOCS_MCP_STORAGE_PATH es la carpeta que el agente puede leer. GROUPDOCS_MCP_OUTPUT_PATH es donde se depositan los archivos convertidos. Con ambas establecidas, la carpeta de origen permanece intacta y cada resultado se guarda en converted. Esta es la disposición más limpia para un lote. El comando dnx necesita el SDK .NET 10; la imagen Docker ghcr.io/groupdocs-conversion/conversion-net-mcp:latest monta la carpeta como /data. Reinicia Claude Desktop, Claude Code, VS Code o Cursor después de registrar el servidor.

¿Qué hace el primer prompt?

Proporciona al agente el caso simple primero:

Convertir todo en esta carpeta de DOCX a PDF.

El agente enumera la carpeta y llama a la herramienta convert para cada archivo con format: "pdf". Cada llamada toma un nombre de archivo del almacenamiento y devuelve el nombre del archivo guardado. Ejecuta la operación dos veces y la segunda ejecución crea archivos nuevos, con nombres distintos, junto a los primeros.

¿Cómo añades un filtro o una regla?

El prompt es la capa de orquestación. Filtrado, secuenciación y una política de errores se expresan en lenguaje natural:

Convertir todos los PDFs a Markdown; omitir los archivos que ya están convertidos.

Convertir las facturas a PDF/A para archivado y enumerar cualquier archivo que haya fallado.

Crear vistas previas PNG de cada presentación.

Para la secuenciación, el agente puede llamar primero a get_document_info, que devuelve el tipo de archivo, el número de páginas y propiedades básicas sin convertir:

Verificar el número de páginas de cada PDF primero y solo convertir los que tengan más de 10 páginas.

La decisión “más de 10 páginas” la toma el agente. La conversión sigue siendo responsabilidad del motor.

¿Qué ocurre cuando un archivo falla?

Cuando el motor no puede convertir un archivo, por ejemplo porque el formato de origen no está soportado o la contraseña es incorrecta, el texto de respuesta para ese archivo comienza con la operación y la razón. Un nombre de archivo que no exista devuelve la lista de archivos que el servidor puede ver, de modo que el agente pueda corregirse. Para archivos protegidos, convert acepta un parámetro opcional password.

Por eso la política de fallos debe incluirse en el prompt: “enumerar cualquier archivo que haya fallado” solicita al agente un informe al final de la ejecución, de modo que un error no pase desapercibido. Lee el informe y vuelve a ejecutar solo los archivos que fallaron.

Sesión de ejemplo

Esta es una sesión abreviada e ilustrativa. Los nombres de archivo son ficticios y la respuesta se construye a partir del comportamiento documentado, no de una captura de pantalla.

You:    Convert the invoices to PDF/A for archiving, and list any file that failed.
Agent:  [enumerates the invoice files]
Agent:  [calls convert for each file, one at a time]
Agent:  Converted 11 files to the output folder.
        Failed: invoice-0412.docx (password-protected, no password given).

¿Cómo sigues el progreso en una carpeta grande?

El agente normalmente procesa los archivos uno tras otro, por lo que el tiempo de ejecución crece con la cantidad de archivos y su tamaño. Para informar del progreso, solicítalo en el prompt: “avísame después de cada diez archivos” o “resume al final”. Unas cuantas cientos de documentos funcionan sin problemas, y el informe final te dice qué ocurrió. Comienza con una copia de un subconjunto pequeño, verifica dos o tres resultados manualmente y luego ejecuta la carpeta completa.

¿Qué pasa si el lote debe ejecutarse sin supervisión?

Una sesión de agente necesita una persona que la inicie. Para canalizaciones programadas, la guía de n8n muestra una herramienta de flujo de trabajo que controla el mismo servidor, y el motor también es scriptable mediante la biblioteca .NET de GroupDocs.Conversion. Usa el chat para lotes ad‑hoc donde quieras leer el informe.

¿Cuáles son los límites?

  • El modo de evaluación limita un lote a 15 documentos. Sin licencia, un proceso de servidor puede abrir como máximo 15 documentos y la salida lleva una marca de agua de evaluación. Después de eso, las llamadas posteriores fallan hasta que el servidor se reinicia. Verifica el modo con get_license_status antes de iniciar un lote real, o pregunta “¿cuál es el estado de la licencia del servidor de conversión?”.
  • Las licencias por consumo requieren acceso saliente. Con claves de consumo, el uso se reporta a los servidores de GroupDocs, por lo que una máquina detrás de firewall debería usar un archivo de licencia. El contenido del documento nunca se envía.
  • Los escaneos permanecen como imágenes. OCR no forma parte del servidor, así que un lote de PDFs solo con imágenes no obtendrá una capa de texto.

Preguntas frecuentes

¿Cómo convierto todos los archivos DOCX de una carpeta a PDF con IA?
Configura la carpeta de almacenamiento y luego pide a tu agente exactamente eso en una frase. Convierte los archivos uno por uno a través del servidor local y nada se sube.

¿Puede un agente de IA procesar una carpeta completa localmente?
Sí. Tanto el agente como el servidor de conversión se ejecutan en tu máquina, y los archivos se leen y escriben en tus propias carpetas.

¿Cuál es la mejor manera de automatizar una canalización de conversión de documentos?
Utiliza el chat para lotes ad‑hoc que quieras revisar. Para una canalización que se ejecute según un horario, controla el mismo servidor desde una herramienta de flujo de trabajo como n8n, o escribe scripts usando la biblioteca .NET.

Profundiza