AI 에이전트에게 스캔된 페이지를 가리도록 요청했을 때 텍스트 가리기(redaction)가 교체할 것이 없다고 판단하면, 해당 페이지는 깨끗하지 않으며 검색할 텍스트 레이어가 없습니다. 스캔을 로컬에서 가리려면 에이전트가 redact_image_area를 사용해 좌표로 영역을 덮습니다(단어 매칭이 아니라). Claude Desktop 또는 Cursor와 연결된 GroupDocs.Redaction.Mcp를 사용하면 요청은 다음과 같습니다:

scan.png의 아래쪽 3분의 1을 검은 상자로 가리세요.

구성 및 문제 해결을 포함한 단계별 버전은 문서에 있습니다: AI 에이전트로 스캔된 문서와 이미지를 가리는 방법.

스캔에서 텍스트 가리기가 아무것도 찾지 못하는 이유는?

스캔은 문서의 사진입니다. 그 위의 단어들은 픽셀로 이루어져 있어 정규식으로 매치할 대상이 없습니다. redact_text는 스캔된 페이지에서 교체할 것이 없다고 판단하지만, 아무것도 찾지 못했다고 해서 민감한 내용이 없다는 의미는 아닙니다. 이미지 전용 파일에서 결과가 비어 있으면 “텍스트 레이어 없음"으로 간주하고 도구를 전환하십시오. 동일한 원리는 사진, 도장, 그리고 디지털 계약서 뒤쪽에 있는 스캔된 서명 페이지에도 적용됩니다.

페이지의 특정 영역을 가리는 도구는?

redact_image_area는 페이지의 사각형 영역을 단색 상자로 덮어 얼굴, 서명, 도장 등 이미지 아래의 내용을 영구적으로 가립니다. 페이지의 왼쪽 위 모서리를 기준으로 픽셀 단위의 x, y, width, height를 입력하며, 선택적으로 color를 지정할 수 있습니다(기본값은 검정, 혹은 #FF0000 같은 16진수 값). 이 도구는 페이지 인자를 받지 않고 파일과 사각형만을 사용하므로, 출력 파일을 열어 상자가 어디에 위치했는지 확인해야 합니다. 숫자가 픽셀이므로 사각형을 선택하기 전에 이미지 또는 페이지 크기를 알아야 합니다.

좌표를 어떻게 얻나요?

먼저 페이지 크기를 확인합니다. get_document_info는 파일 유형, 페이지 수, 각 페이지의 너비와 높이를 반환하므로 “아래쪽 3분의 1"을 실제 숫자로 변환할 수 있습니다.

scan.png의 크기는 얼마나 됩니까?

그 다음 에이전트에게 영역을 알려줍니다:

scan.png의 아래쪽 3분의 1을 검은 상자로 가리세요.

서명이나 얼굴과 같은 특정 요소에 대해서는 해당 위치가 필요합니다. 두 가지 실용적인 방법이 있습니다. 페이지를 아무 뷰어에서 열어 직접 좌표를 확인하거나, 에이전트가 페이지 이미지를 반환하는 서버를 통해 페이지를 렌더링하도록 합니다: GroupDocs.Viewer.Mcp의 render_page 도구는 단일 페이지를 PNG로 렌더링하여 인라인으로 반환하고, GroupDocs.Annotation.Mcp 서버는 페이지 미리보기를 반환할 수 있습니다(현재 이 미리보기 도구는 Linux 및 Docker 환경의 PDF 파일에서는 작동하지 않으며, Word 및 기타 Office 문서는 렌더링되고 Windows에서 dnx를 사용할 경우 모든 형식이 렌더링됩니다). 시각 인식이 가능한 모델이 상자를 추정하면, 가리기 작업이 실행되기 전에 이를 확인합니다.

텍스트와 스캔이 반반인 문서는 어떻게 처리하나요?

스캔된 서명 페이지가 포함된 디지털 계약서는 두 도구가 모두 필요하며, redact_image_area는 인자를 통해 특정 페이지만 지정할 수 없습니다. 작업을 분리하세요: 먼저 텍스트를 가리고, 스캔된 페이지는 별도의 이미지 영역 가리기로 처리합니다.

contract.docx의 이메일 주소를 가린 후, 다음 단계에 사용할 저장 파일을 알려 주세요.

그 후 최종 출력의 모든 페이지를 눈으로 확인합니다.

일반적인 스캔 워크플로우는 어떻게 보이나요?

작동하는 순서는 다음과 같습니다: 페이지 크기를 읽고, 영역을 결정한 뒤, 해당 영역을 가리고, 결과를 확인합니다. 영역이 명확하지 않다면 먼저 페이지를 렌더링하고 시각 인식 모델이 상자를 제안하도록 합니다. 제안 내용과 최종 좌표를 대화 기록에 남겨서 사례 파일을 검토하는 사람이 무엇을 왜 가렸는지 알 수 있게 합니다. 영역 가리기는 의도적으로 단순합니다: 사각형만을 가리고 그 외는 남깁니다.

이 서버가 이미지 내 텍스트를 읽나요 (OCR)?

아니요. GroupDocs.Redaction.Mcp는 가리기만 할 뿐 이미지 내 텍스트를 인식하지 않습니다. 이는 동작을 예측 가능하게 하며, 흐릿한 이름을 이름이 아니라고 조용히 판단하는 신뢰 임계값이 작동하지 않기 때문입니다. 워크플로우에 스캔에서 텍스트가 필요하다면, 먼저 해당 용도로 만든 도구로 텍스트를 추출하고, 민감한 부분을 판단한 뒤 영역 가리기를 수행하십시오. 서버는 사진 속 이름이 어디에 있는지 알려줄 수 없습니다.

예시 세션 (요약)

사용자:    scan.png의 크기는 얼마나 됩니까?
에이전트:  -> get_document_info(file: scan.png)
        이미지은 1200 x 1600 픽셀입니다.
사용자:    scan.png의 아래쪽 3분의 1을 검은 상자로 가리세요.
에이전트:  -> redact_image_area(file: scan.png, x: 0, y: 1067, width: 1200, height: 533, color: Black)
        출력 파일을 저장했습니다. 파일을 열어 상자가 해당 영역을 가렸는지 확인하십시오.

영역 가리기를 어떻게 확인하나요?

출력의 모든 페이지를 확인하세요, 목표로 한 페이지만이 아니라. 20픽셀 정도 부족한 영역 가리기는 실패한 가리기로, 응답 텍스트로는 알 수 없습니다. 이는 패턴을 다시 실행해 자동화할 수 없는 유일한 경우이며, 검증은 눈으로 직접 확인하거나 에이전트가 볼 수 있는 렌더링된 미리보기를 통해 이루어집니다. 검증에 대한 내용은 별도의 게시물인 검증하지 않은 가리기는 신뢰하지 마세요에 다루어집니다.

평가 모드의 제한은 무엇인가요?

라이선스 없이 서버는 프로세스당 하나의 문서와 하나의 가리기만 허용하며, 교체 횟수는 최대 4회, 그리고 체험 배지를 제공합니다. 스캔의 경우 이는 하나의 상자만 허용한다는 의미이며, 세 개의 영역을 가려야 하는 페이지도 하나만 가려져 처리된 것처럼 보입니다. 먼저 get_license_status를 실행하십시오. 이 제한은 도구를 체험하기 위한 것이며 실제 작업을 위한 것이 아닙니다.

  • PDF on Linux. Linux(및 Docker 이미지)에서는 redact_image_area와 erase_metadata가 현재 PDF 파일에서 작동하지 않습니다(PDF 엔진의 이미지 처리는 System.Drawing에 의존하는데, 이는 .NET이 Windows에서만 지원합니다). 두 도구는 Word 문서에서는 정상 작동하며, redact_text는 PDF에서 작동합니다. PDF 영역 가리기와 메타데이터 삭제는 Windows에서 dnx를 사용해 실행하십시오.

자주 묻는 질문

AI 에이전트가 스캔된 문서를 가릴 수 있나요? 예, 영역 가리기로 가능합니다. redact_image_area를 사용해 정의한 사각형을 덮으며, 패턴 매칭을 위한 텍스트가 없기 때문입니다.

Claude가 스캔 이미지에서 서명을 제거할 수 있나요? 서명의 위치가 뷰어나 렌더링된 페이지 미리보기를 통해 알려지면 Claude가 가리기 작업을 수행할 수 있습니다. 서버는 해당 사각형을 단색 상자로 덮습니다.

스캔이나 이미지에서 영역을 자동으로 검게 가리려면 어떻게 하나요? 에이전트에게 파일과 사각형을 제공하면 redact_image_area를 호출합니다. 이 도구는 페이지 인자를 받지 않으므로 결과의 모든 페이지를 눈으로 확인하십시오.

왜 텍스트 가리기가 내 스캔에서 아무 변화도 없나요? 스캔이나 이미지는 텍스트가 아니라 픽셀로 이루어져 있어 교체할 것이 없습니다. 영역 가리기를 사용하고 결과를 눈으로 확인하십시오.

더 깊이 들어가기