Suponha que você tenha uma pasta de contratos e precise da primeira página de cada um, ou da página de assinatura, para uma revisão. Um agente de IA com o servidor GroupDocs.Merger.Mcp faz isso em um único prompt, localmente na sua máquina, a partir do Claude Desktop, Claude Code, Cursor ou VS Code com GitHub Copilot:

Extrair a página 1 de cada PDF na minha pasta de documentos e listar o que você produziu.

A versão passo a passo com configuração e solução de problemas está na documentação: Como extrair páginas de vários documentos de uma vez.

O que o agente faz com uma pasta de arquivos?

Para cada arquivo, o agente chama a ferramenta split uma vez. Cada chamada grava um documento de uma única página. Uma pasta com 40 faturas, portanto, gera 40 páginas de capa. A ferramenta não tem modo de pasta; o agente fornece o loop, e o mecanismo realiza a extração de páginas para cada arquivo. Os arquivos são resolvidos pelo nome dentro da pasta configurada em GROUPDOCS_MCP_STORAGE_PATH, portanto o agente passa invoice-014.pdf, não um caminho da sua máquina.

Como manter as páginas extraídas fora da pasta dos originais?

Quarenta páginas extraídas ao lado de quarenta originais formam uma pasta que ninguém consegue navegar. Defina GROUPDOCS_MCP_OUTPUT_PATH para um diretório separado, e os resultados ficam apartados das fontes. Sem isso, a saída vai para a pasta de armazenamento. Esta é uma configuração única, e todo prompt em lote após ela permanece organizado.

Como extrair a última página, ou uma página que se move?

“A última página” tem um número diferente em cada arquivo. Faça o agente chamar get_document_info para cada documento primeiro. Ele retorna pageCount, então o agente pode calcular o número da página por arquivo:

Para cada PDF na pasta, verifique a contagem de páginas e, em seguida, extraia a última página de cada um.

Um agente que adivinha falha nos arquivos onde o palpite está errado. O erro é por arquivo, não fatal.

Quais variações surgem com mais frequência?

Extrair a última página de cada documento. Verificar a contagem de páginas primeiro.

Extrair a página 2 de cada contrato, então mesclar todas elas em um único arquivo de revisão.

Para cada arquivo, extrair a página de assinatura e colocar os resultados na pasta de saída.

O segundo prompt encadeia em merge em rodadas de até quatro documentos, o que fornece um único documento combinado construído a partir de uma página de cada fonte. Mais de quatro fontes significa mais rodadas. O prompt de página de assinatura funciona quando você informa ao agente qual página contém a assinatura; a ferramenta extrai os números de página que você fornece e não procura por conteúdo.

Quando um prompt por pasta tem o tamanho adequado?

Use‑o quando a mesma regra se aplica a todos os arquivos: primeira página, última página, uma página de assinatura conhecida. O prompt declara a regra uma vez, e o agente a aplica arquivo por arquivo. Trabalhos de arquivamento e revisão jurídica se encaixam nesse formato: uma folha de rosto de cada arquivo para um índice, ou a página que contém assinaturas de cada contrato para uma verificação. Se a regra variar por arquivo, divida a pasta em grupos e execute um prompt por grupo, de modo que cada prompt ainda declare uma única regra. Mantenha a instrução “liste o que você produziu” em cada prompt em lote; a lista é seu registro de quais arquivos foram processados.

Sessão de exemplo (abreviada)

Uma ilustração baseada no comportamento documentado da ferramenta, não uma captura de tela.

You:   Extract page 1 from every PDF in my documents folder and
       list what you produced.

Agent: Found 3 PDFs in the folder.
       [calls split on each file with pages = "1"]
       Extracted page 1 from all 3 files: 3 single-page documents
       in your output folder. No failures.

O que dá errado em um lote de muitos arquivos?

  • Falhas são por arquivo. Um documento corrompido ou protegido por senha falha em sua própria chamada. Solicite as falhas como uma lista para que um lote de 40 não oculte dois erros. A ferramenta split aceita um argumento password para documentos protegidos.
  • Um documento curto. Pedir uma página que não existe falha para esse arquivo; os outros arquivos não são afetados.
  • Uso medido se acumula. Sob licenciamento medido, cada chamada é cobrada como processamento.

Limites honestos

  • O modo de avaliação reduz a saída mesclada para 3 páginas. O resultado é reduzido às primeiras 3 páginas, com um selo de avaliação em cada página. A extração de páginas individuais não é afetada, mas no momento em que você mescla os resultados o limite é aplicado silenciosamente. Um arquivo de revisão mesclado construído a partir de quarenta primeiras páginas volta como três. Verifique get_license_status antes da execução.
  • Sem busca de conteúdo. O agente escolhe páginas por número. Encontrar “a página com a assinatura” é sua instrução, não um recurso da ferramenta.
  • Sem modo de pasta na ferramenta. Uma chamada split lida com um arquivo, portanto uma pasta grande significa muitas chamadas.

FAQ

Como extraio a primeira página de todos os PDFs em uma pasta? Aponte o servidor para a pasta, então pergunte: “Extrair a página 1 de cada PDF na minha pasta de documentos e listar o que você produziu.” O agente chama split para cada arquivo.

A IA pode dividir documentos em lote e coletar as páginas em um único arquivo? Sim. Após a extração, peça ao agente para mesclar os arquivos de página única em rodadas de quatro. No modo de avaliação esse arquivo mesclado é reduzido a 3 páginas.

Os arquivos deixam a minha máquina? Não. O servidor lê e grava as pastas que você configura, via transporte local stdio, sem portas de entrada.

Aprofunde-se