Puedes convertir “adjuntar la página que muestra el problema” en un solo mensaje. El servidor GroupDocs.Viewer.Mcp renderiza las páginas que indiques de un archivo PDF, Word, Excel o PowerPoint y guarda cada una como PNG con un nombre de archivo predecible, localmente en tu máquina, de modo que Claude, Cursor o GitHub Copilot puedan generar las imágenes para un informe de error, una nota de revisión o una diapositiva:

Renderiza las páginas 1, 4 y 9 de la especificación y dime dónde están los archivos.

La versión paso a paso con configuración y solución de problemas está en la documentación: Cómo crear imágenes de página de documentos para informes y tickets.

¿Por qué automatizar las imágenes de página?

Una imagen de página es la evidencia más económica que existe. Un ingeniero de soporte adjunta la página de la factura que muestra el total incorrecto; un revisor inserta una miniatura de cada página modificada en las notas de revisión; un presentador necesita un diagrama, sin reformatear. Hecho a mano, cada uno de esos casos implica abrir el archivo, encontrar la página, tomar una captura de pantalla y nombrar el resultado. El número de páginas varía según el archivo, por lo que el trabajo nunca se agrupa bien.

Un agente puede hacer la parte repetitiva si el renderizado lo realiza un motor real en lugar de que el agente lo imite. El motor pagina el documento de la misma forma que lo hace el documento y genera el mismo tipo de PNG cada vez.

¿Cuál es el flujo de trabajo?

  1. Coloca los archivos donde el servidor pueda verlos. Monta la carpeta que contiene los documentos, ya sea que incluya archivos PDF o Word, de modo que renderizar una imagen de página DOCX funcione de la misma manera. El servidor lee desde la ruta de almacenamiento y escribe las imágenes en la ruta de salida, que puedes mantener separada con GROUPDOCS_MCP_OUTPUT_PATH.
  2. Verifica el número de páginas. Mensaje: “¿Cuántas páginas tiene la especificación?” El agente llama a get_view_info y lee pageCount. Esto es importante porque render_page no rechaza un número de página que supere el final del documento.
  3. Nombra las páginas. Mensaje: “Renderiza las páginas 1, 4 y 9 de la especificación y dime dónde están los archivos.” El agente llama a render_page tres veces, una por página.
  4. Recopila los nombres de archivo. Los archivos son specification_page1.png, specification_page4.png y specification_page9.png, en la carpeta de salida. El agente informa las rutas.
  5. Adjúntalos. Si tu cliente también tiene un rastreador de incidencias o un servidor MCP de chat conectado, pide al agente que adjunte los archivos al ticket o mensaje. Ese paso usa las herramientas del otro servidor, no de este.

Si solo deseas los archivos, dilo, para que el agente no describa cada imagen:

Simplemente guarda las imágenes; no necesitas describirlas.

¿Qué decide el agente y qué hace el motor?

Decisión o acción Agente Motor
Qué páginas son relevantes Mapea “las páginas con la tabla de precios” a números de página, después de renderizar o inspeccionar Nada
Si la página existe Llama a get_view_info y compara Devuelve pageCount y tamaños de página
Renderizado Llama a render_page una vez por página Produce el PNG
Nomenclatura de archivo Informa la ruta guardada Guarda como <source-stem>_page<N>.png
Adjuntar a un ticket Usa la herramienta de otro servidor Nada

Sesión de ejemplo

Una ilustración basada en los nombres de salida documentados, no una captura de pantalla.

You:   Render pages 1, 4, and 9 of the specification and tell me where
       the files are. Just save the images; no need to describe them.

Agent: [calls render_page for page 1, page 4 and page 9]
       Saved:
         <output folder>/specification_page1.png
         <output folder>/specification_page4.png
         <output folder>/specification_page9.png

¿Cómo mantengo el conjunto pequeño?

El renderizado es una página por llamada, y cada imagen también viaja de vuelta al agente en línea. Pedir diez páginas implica diez llamadas y diez imágenes en la conversación. Solicita solo las páginas que necesites. Una regla sensata es seleccionar las páginas antes de renderizar, usando el recuento de páginas y, para documentos extensos, una página de contenido.

Usos típicos

  • Informes de errores. La página del manual o la factura que muestra el problema.
  • Revisiones de documentos. Una imagen por página modificada en las notas de revisión.
  • Diapositivas. Una foto del diagrama que deseas, sin reformatearlo.

Límites honestos

  • Modo de evaluación. Las páginas renderizadas llevan una marca de agua de evaluación, y un proceso del servidor abre como máximo 15 documentos. Si las imágenes salen de tu equipo, pregunta primero “¿El servidor Viewer está licenciado?” para que el agente llame a get_license_status.
  • Una página por llamada. No existe una herramienta multipágina. Un lote es una serie de llamadas.
  • Solo PNG. El formato es fijo; la resolución no es un parámetro que puedas establecer mediante la herramienta.
  • Un número de página incorrecto sigue generando una imagen. Un archivo llamado _page12.png es la página 12 solo si el documento tiene 12 páginas. Verifica el recuento primero.

Preguntas frecuentes

¿Cómo convierto una página PDF a una imagen con un agente de IA? Conecta el servidor GroupDocs.Viewer.Mcp a tu cliente y solicita la página por número. El agente llama a render_page y el PNG se guarda en la carpeta de salida como <name>_page<N>.png.

¿Cómo adjunto una vista previa de documento a un ticket con un agente de IA? El servidor Viewer genera el archivo de imagen. Adjuntarlo requiere un servidor MCP de rastreador de incidencias conectado al mismo cliente, que es un servidor separado con sus propias herramientas.

¿Puedo generar miniaturas de documentos localmente? Sí. El motor se ejecuta en el proceso del servidor en tu máquina, y las imágenes se escriben en la carpeta de salida que configures.

Profundiza