예를 들어 계약서 폴더가 있고 검토를 위해 각 파일의 첫 페이지 또는 서명 페이지가 필요하다고 가정해 보세요. GroupDocs.Merger.Mcp 서버가 있는 AI 에이전트가 한 번의 프롬프트로, 로컬 머신에서 Claude Desktop, Claude Code, Cursor 또는 GitHub Copilot이 포함된 VS Code를 통해 수행합니다:

내 문서 폴더에 있는 모든 PDF에서 페이지 1을 추출하고 생성한 내용을 나열해 주세요.

구성 및 문제 해결이 포함된 단계별 버전은 문서에 있습니다: 많은 문서에서 페이지를 한 번에 추출하는 방법.

에이전트가 파일 폴더에서 수행하는 작업은 무엇인가요?

각 파일마다 에이전트는 split 도구를 한 번 호출합니다. 각 호출은 단일 페이지 문서를 작성합니다. 따라서 40개의 청구서가 들어 있는 폴더는 40개의 표지 페이지를 생성합니다. 이 도구에는 폴더 모드가 없으며, 에이전트가 루프를 제공하고 엔진이 각 파일에 대해 페이지를 추출합니다. 파일은 GROUPDOCS_MCP_STORAGE_PATH에 설정된 폴더 내부의 이름으로 해결되므로, 에이전트는 invoice-014.pdf를 전달하고, 사용자의 머신 경로는 전달하지 않습니다.

추출된 페이지를 원본 폴더와 분리하려면 어떻게 해야 하나요?

40개의 추출된 페이지와 40개의 원본이 같은 폴더에 있으면 아무도 탐색하기 어렵습니다. GROUPDOCS_MCP_OUTPUT_PATH를 별도의 디렉터리로 설정하면 결과가 원본과 분리되어 저장됩니다. 이 설정을 하지 않으면 출력이 저장 폴더에 들어갑니다. 이는 한 번만 설정하면 되며, 이후 모든 대량 프롬프트가 깔끔하게 유지됩니다.

마지막 페이지 또는 이동하는 페이지를 추출하려면 어떻게 해야 하나요?

“마지막 페이지”는 파일마다 번호가 다릅니다. 에이전트가 먼저 각 문서에 대해 get_document_info를 호출하도록 합니다. 이 호출은 pageCount를 반환하므로 에이전트가 파일별로 마지막 페이지 번호를 계산할 수 있습니다:

폴더에 있는 각 PDF의 페이지 수를 확인한 뒤, 각 파일의 마지막 페이지를 추출하세요.

페이지 번호를 추측하는 에이전트는 추측이 틀린 파일에서 실패합니다. 오류는 파일당 발생하며 전체 작업을 중단하지는 않습니다.

가장 많이 나타나는 변형은 무엇인가요?

각 문서의 마지막 페이지를 추출하세요. 먼저 페이지 수를 확인합니다.

모든 계약서에서 페이지 2를 추출한 뒤, 이를 하나의 검토 파일로 병합하세요.

각 파일에서 서명 페이지를 추출하고 결과를 출력 폴더에 넣으세요.

두 번째 프롬프트는 merge를 최대 네 개 문서씩 라운드로 연결하여, 각 소스의 한 페이지로 구성된 단일 결합 문서를 만듭니다. 네 개를 초과하면 라운드가 추가됩니다. 서명 페이지 프롬프트는 서명 페이지 번호를 에이전트에 알려줄 때 작동하며, 도구는 지정된 페이지 번호만 추출하고 내용 검색은 하지 않습니다.

폴더당 하나의 프롬프트가 적절한 경우는 언제인가요?

모든 파일에 동일한 규칙이 적용될 때 사용합니다: 첫 페이지, 마지막 페이지, 알려진 서명 페이지 등. 프롬프트에 규칙을 한 번만 명시하면 에이전트가 파일별로 적용합니다. 아카이브 및 법률 검토 작업이 이 형태에 맞습니다: 각 파일의 표지 시트를 인덱스로 만들거나, 각 계약서의 서명 페이지를 확인하기 위해 추출합니다. 파일마다 규칙이 다르면 폴더를 그룹으로 나누고 그룹당 하나의 프롬프트를 실행하면 각 프롬프트가 단일 규칙을 유지합니다. 모든 대량 프롬프트에 “생성한 내용을 나열해 주세요”라는 지시를 포함하면, 리스트가 처리된 파일의 기록이 됩니다.

예시 세션 (축약)

문서화된 도구 동작을 기반으로 한 예시이며, 실제 스크린샷은 아닙니다.

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.

많은 파일을 배치 처리할 때 발생할 수 있는 문제는 무엇인가요?

  • 실패는 파일당 발생합니다. 손상되었거나 비밀번호가 설정된 문서는 해당 호출에서만 실패합니다. 실패 목록을 요청하면 40개의 배치에서 두 개의 오류가 숨겨지는 것을 방지할 수 있습니다. split 도구는 보호된 문서를 위해 password 인자를 받습니다.
  • 짧은 문서. 존재하지 않는 페이지를 요청하면 해당 파일에서만 실패하고, 다른 파일은 영향을 받지 않습니다.
  • 사용량 기반 요금이 누적됩니다. 사용량 기반 라이선스에서는 모든 호출이 처리 비용으로 청구됩니다.

솔직한 제한 사항

  • 평가 모드에서는 병합된 출력이 3페이지로 잘립니다. 결과는 첫 3페이지만 남으며 각 페이지에 평가 배지가 표시됩니다. 단일 페이지 추출에는 영향을 주지 않지만, 결과를 병합하면 제한이 조용히 적용됩니다. 실행 전에 get_license_status를 확인하세요.
  • 콘텐츠 검색이 없습니다. 에이전트는 번호로 페이지를 선택합니다. “서명이 있는 페이지”를 찾는 것은 도구 기능이 아니라 사용자의 지시입니다.
  • 도구에 폴더 모드가 없습니다. 하나의 split 호출이 하나의 파일을 처리하므로, 큰 폴더는 많은 호출을 의미합니다.

FAQ

폴더에 있는 모든 PDF의 첫 페이지를 어떻게 추출하나요? 서버를 해당 폴더로 지정한 뒤 다음과 같이 요청합니다: “내 문서 폴더에 있는 모든 PDF에서 페이지 1을 추출하고 생성한 내용을 나열해 주세요.” 에이전트가 각 파일에 대해 split을 호출합니다.

AI가 문서를 일괄 분할하고 페이지를 하나의 파일에 모을 수 있나요? 예, 추출 후 에이전트에게 단일 페이지 파일을 네 개씩 라운드로 병합하도록 요청하면 됩니다. 평가 모드에서는 병합된 파일이 3페이지로 잘립니다.

파일이 내 컴퓨터를 떠나나요? 아니요. 서버는 구성한 폴더를 로컬 stdio 전송을 통해 읽고 쓰며, 외부 포트를 열지 않습니다.

더 깊이 알아보기