Puoi trasformare “allega la pagina che mostra il problema” in un unico prompt. Il server GroupDocs.Viewer.Mcp rende le pagine che specifichi da un file PDF, Word, Excel o PowerPoint e salva ciascuna come PNG con un nome file prevedibile, localmente sul tuo computer, così Claude, Cursor o GitHub Copilot possono generare le immagini per un report di bug, una nota di revisione o una diapositiva:

Rendi le pagine 1, 4 e 9 della specifica e indicami dove sono i file.

La versione passo‑passo con configurazione e risoluzione dei problemi è nella documentazione: Come creare immagini di pagina dei documenti per report e ticket.

Perché automatizzare le immagini di pagina?

Un’immagine di pagina è la prova più economica che esista. Un ingegnere di supporto allega la pagina della fattura che mostra il totale errato; un revisore inserisce una miniatura di ogni pagina modificata nelle note di revisione; un presentatore ha bisogno di un diagramma, non riformattato. Fatto a mano, ognuna di queste operazioni richiede aprire il file, trovare la pagina, fare uno screenshot e nominare il risultato. Il conteggio delle pagine varia per file, quindi il lavoro non si raggruppa mai bene.

Un agente può eseguire la parte ripetitiva se il rendering è effettuato da un vero motore anziché dall’agente che ne imita uno. Il motore impagina il documento nello stesso modo in cui lo fa il documento e genera lo stesso tipo di PNG ogni volta.

Qual è il flusso di lavoro?

  1. Posiziona i file dove il server può vederli. Monta la cartella che contiene i documenti, sia che contenga file PDF o Word, in modo che il rendering di un’immagine di pagina DOCX funzioni allo stesso modo. Il server legge dal percorso di archiviazione e scrive le immagini nel percorso di output, che puoi tenere separato con GROUPDOCS_MCP_OUTPUT_PATH.
  2. Verifica il conteggio delle pagine. Prompt: “Quante pagine ha la specifica?” L’agente chiama get_view_info e legge pageCount. Questo è importante perché render_page non rifiuta un numero di pagina oltre la fine del documento.
  3. Nomina le pagine. Prompt: “Rendi le pagine 1, 4 e 9 della specifica e indicami dove sono i file.” L’agente chiama render_page tre volte, una per pagina.
  4. Raccogli i nomi dei file. I file sono specification_page1.png, specification_page4.png e specification_page9.png, nella cartella di output. L’agente riporta i percorsi.
  5. Allegali. Se il tuo client ha anche un issue‑tracker o un server chat MCP collegato, chiedi all’agente di allegare i file al ticket o al messaggio. Questa fase utilizza gli strumenti dell’altro server, non di questo.

Se vuoi solo i file, specifica così, in modo che l’agente non descriva ogni immagine:

Salva semplicemente le immagini; non è necessario descriverle.

Cosa decide l’agente e cosa fa il motore?

Decisione o azione Agente Motore
Quali pagine sono rilevanti Mappa “le pagine con la tabella dei prezzi” ai numeri di pagina, dopo il rendering o l’ispezione Niente
Se la pagina esiste Chiama get_view_info e confronta Restituisce pageCount e le dimensioni delle pagine
Rendering Chiama render_page una volta per pagina Produce il PNG
Denominazione dei file Riporta il percorso salvato Salva come <source-stem>_page<N>.png
Allegare a un ticket Utilizza lo strumento di un altro server Niente

Sessione di esempio

Un’illustrazione basata sui nomi di output documentati, non uno screenshot catturato.

Tu:   Rendi le pagine 1, 4 e 9 della specifica e indicami dove sono i file. Salva semplicemente le immagini; non è necessario descriverle.

Agente: [chiama render_page per la pagina 1, la pagina 4 e la pagina 9]
        Salvati:
          <output folder>/specification_page1.png
          <output folder>/specification_page4.png
          <output folder>/specification_page9.png

Come mantenere il set piccolo?

Il rendering è una pagina per chiamata, e ogni immagine ritorna all’agente in linea. Richiedere dieci pagine significa dieci chiamate e dieci immagini nella conversazione. Chiedi le pagine di cui hai bisogno. Una regola sensata è scegliere le pagine prima del rendering, usando il conteggio delle pagine e, per documenti lunghi, una pagina di indice.

Usaggi tipici

  • Segnalazioni di bug. La pagina del manuale o della fattura che mostra il problema.
  • Revisioni di documenti. Un’immagine per pagina modificata nelle note di revisione.
  • Diapositive. Un’immagine del diagramma che desideri, senza riformattarlo.

Limiti onesti

  • Modalità di valutazione. Le pagine renderizzate hanno una filigrana di valutazione, e un processo server apre al massimo 15 documenti. Se le immagini lasciano il tuo team, chiedi prima “Il server Viewer è licenziato?”, così l’agente chiama get_license_status.
  • Una pagina per chiamata. Non esiste uno strumento multi‑pagina. Un batch è una serie di chiamate.
  • Solo PNG. Il formato è fisso; la risoluzione non è un parametro che puoi impostare tramite lo strumento.
  • Un numero di pagina errato restituisce comunque un’immagine. Un file chiamato _page12.png è la pagina 12 solo se il documento ha 12 pagine. Controlla prima il conteggio.

FAQ

Come converto una pagina PDF in un’immagine con un agente AI?
Collega il server GroupDocs.Viewer.Mcp al tuo client e richiedi la pagina per numero. L’agente chiama render_page e il PNG viene salvato nella cartella di output come <name>_page<N>.png.

Come allego un’anteprima del documento a un ticket con un agente AI?
Il server Viewer genera il file immagine. Allegarlo richiede un server MCP issue‑tracker collegato allo stesso client, che è un server separato con i propri strumenti.

Posso generare miniature di documenti localmente?
Sì. Il motore gira nel processo server sul tuo computer, e le immagini vengono scritte nella cartella di output che configuri.

Approfondisci