Vous pouvez transformer « joindre la page qui montre le problème » en une seule invite. Le serveur GroupDocs.Viewer.Mcp rend les pages que vous indiquez à partir d’un fichier PDF, Word, Excel ou PowerPoint et enregistre chacune sous forme de PNG avec un nom de fichier prévisible, localement sur votre machine, afin que Claude, Cursor ou GitHub Copilot puissent produire les images pour un rapport de bug, une note de révision ou une diapositive :
Rendre les pages 1, 4 et 9 de la spécification et me dire où se trouvent les fichiers.
La version étape par étape avec configuration et dépannage se trouve dans la documentation : How to create page images of documents for reports and tickets.
Pourquoi automatiser les images de pages du tout ?
Une image de page est la preuve la moins coûteuse qui existe. Un ingénieur support joint la page de facture qui montre le total incorrect ; un relecteur insère une vignette de chaque page modifiée dans les notes de révision ; un présentateur a besoin d’un diagramme, non reformatté. Faites‑le à la main, chacun de ces cas implique d’ouvrir le fichier, de trouver la page, de prendre une capture d’écran et de nommer le résultat. Le nombre de pages varie selon le fichier, de sorte que le travail ne se regroupe jamais bien.
Un agent peut effectuer la partie répétitive si le rendu est effectué par un vrai moteur plutôt que par l’agent qui en imite un. Le moteur pagine le document de la même façon que le document le fait et génère le même type de PNG à chaque fois.
Quel est le flux de travail ?
- Placez les fichiers où le serveur peut les voir. Montez le dossier qui contient les documents, qu’il s’agisse de fichiers PDF ou Word, afin que le rendu d’une image de page DOCX fonctionne de la même manière. Le serveur lit depuis le chemin de stockage et écrit les images vers le chemin de sortie, que vous pouvez garder séparé avec
GROUPDOCS_MCP_OUTPUT_PATH. - Vérifiez le nombre de pages. Invite : « Combien de pages la spécification comporte‑t‑elle ? » L’agent appelle
get_view_infoet litpageCount. Cela importe parce querender_pagene rejette pas un numéro de page au‑delà de la fin du document. - Nommez les pages. Invite : « Rendre les pages 1, 4 et 9 de la spécification et me dire où se trouvent les fichiers. » L’agent appelle
render_pagetrois fois, une fois par page. - Collectez les noms de fichiers. Les fichiers sont
specification_page1.png,specification_page4.pngetspecification_page9.png, dans le dossier de sortie. L’agent rapporte les chemins. - Attachez‑les. Si votre client possède également un serveur de suivi d’incidents ou de chat MCP connecté, demandez à l’agent d’attacher les fichiers au ticket ou au message. Cette étape utilise les outils de l’autre serveur, pas ceux‑ci.
Si vous ne voulez que les fichiers, indiquez‑le, afin que l’agent ne décrive pas chaque image :
Enregistrez simplement les images ; vous n’avez pas besoin de les décrire.
Que décide l’agent, et que fait le moteur ?
| Decision or action | Agent | Engine |
|---|---|---|
| Quelles pages sont pertinentes | Mappe « les pages avec le tableau des prix » aux numéros de page, après rendu ou inspection | Rien |
| Si la page existe | Appelle get_view_info et compare |
Renvoie pageCount et les tailles de page |
| Rendu | Appelle render_page une fois par page |
Produit le PNG |
| Nomination du fichier | Rapporte le chemin enregistré | Enregistre sous <source-stem>_page<N>.png |
| Attachement à un ticket | Utilise l’outil d’un autre serveur | Rien |
Session d’exemple
Une illustration basée sur les noms de sortie documentés, et non une capture d’écran.
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
Comment garder l’ensemble petit ?
Le rendu se fait une page par appel, et chaque image revient également à l’agent en ligne. Demander dix pages signifie dix appels et dix images dans la conversation. Demandez les pages dont vous avez besoin. Une règle sensée consiste à choisir les pages avant le rendu, en utilisant le nombre de pages et, pour les documents longs, une table des matières.
Utilisations typiques
- Rapports de bugs. La page du manuel ou de la facture qui montre le problème.
- Relectures de documents. Une image par page modifiée dans les notes de révision.
- Diapositives. Une image du diagramme que vous voulez, sans le reformater.
Limites honnêtes
- Mode d’évaluation. Les pages rendues portent un filigrane d’évaluation, et un processus serveur ouvre au maximum 15 documents. Si les images quittent votre équipe, demandez d’abord « Le serveur Viewer est‑il licencié ? », afin que l’agent appelle
get_license_status. - Une page par appel. Il n’existe aucun outil multi‑pages. Un lot est une série d’appels.
- PNG uniquement. Le format est fixe ; la résolution n’est pas un paramètre que vous pouvez définir via l’outil.
- Un numéro de page incorrect donne toujours une image. Un fichier nommé
_page12.pngcorrespond à la page 12 uniquement si le document comporte 12 pages. Vérifiez d’abord le nombre.
FAQ
Comment convertir une page PDF en image avec un agent IA ? Connectez le serveur GroupDocs.Viewer.Mcp à votre client et demandez la page par son numéro. L’agent appelle render_page et le PNG est enregistré dans le dossier de sortie sous <name>_page<N>.png.
Comment attacher un aperçu de document à un ticket avec un agent IA ? Le serveur Viewer génère le fichier image. L’attacher nécessite un serveur MCP de suivi d’incidents connecté au même client, qui est un serveur séparé avec ses propres outils.
Puis‑je générer des miniatures de documents localement ? Oui. Le moteur s’exécute dans le processus serveur sur votre machine, et les images sont écrites dans le dossier de sortie que vous configurez.
Approfondir
- Documentation, guide canonique : Comment créer des images de pages de documents pour les rapports et tickets
- Hub de documentation : GroupDocs.Viewer MCP Server
- Commencez ici : Les agents multimodaux ont besoin de pixels, pas seulement de texte
- Connexe : 3 questions qu’un agent IA devrait poser à un document avant de le rendre
- Connexe : Lorsque la réponse est dans le graphique : les agents IA lisent les diagrammes et les scans via MCP
- Modèle sur site et sécurité : 3 architectures pour le traitement de documents IA, et celle qui garde les fichiers à l’intérieur de votre réseau
- Questions : Forum GroupDocs Viewer
- Source : GroupDocs.Viewer.Mcp sur GitHub