문서 속성을 대량으로 편집하려면 AI 에이전트에게 표준과 폴더를 제공하고, 로컬에서 실행되는 GroupDocs.Metadata.Mcp를 통해 읽고, 쓰고, 검증하도록 하세요. 한 번의 프롬프트만으로 시작할 수 있습니다:

내 폴더의 모든 문서에 대해 Company를 “Acme Ltd"로, Author를 “Research Team"으로 설정하고, 변경된 파일을 알려 주세요.

구성 및 문제 해결이 포함된 단계별 버전은 문서에 있습니다: AI 에이전트를 사용하여 문서 속성을 대량으로 수정하는 방법.

메타데이터 표준이 처음에 왜 변동되는가?

템플릿은 모든 새 파일에 이전 회사명을 남깁니다. 팀 이름을 변경하면 저자 필드에 옛 이름이 남습니다. 마이그레이션은 의미 없는 타임스탬프를 남깁니다. 200개 파일에 대해 속성을 수동으로 편집하는 사람은 없으므로 변동이 지속됩니다. 루프가 있는 에이전트가 적합한 도구이지만, 편집이 엔진에 의해 수행될 때만 효과적입니다: 저자를 변경하기 위해 문서를 “다시 쓰는” 언어 모델은 내용을 재생성하지만, write_metadata는 하나의 필드만 변경하고 본문은 그대로 둡니다.

워크플로우는 무엇인가요?

워크플로우는 네 단계로 구성되며, 각 단계마다 하나의 프롬프트가 있습니다. Claude Desktop, Claude Code, Cursor, GitHub Copilot 또는 서버가 등록된 다른 클라이언트에서 실행하세요.

  1. 라이선스 확인. 질문: “metadata 서버의 라이선스 상태가 어떻게 되나요?” 에이전트는 get_license_status를 호출합니다. 대량 실행 전에 수행하고, 이후에 하지 마세요.
  2. 현재 값을 읽기. 질문: “먼저 각 파일의 현재 Author와 Company를 나열해 주세요.” 에이전트는 nameContains와 함께 search_metadata를 호출하여 일치하는 속성만 반환합니다.
  3. 잘못된 부분만 쓰기. 질문: “잘못된 것만 변경해 주세요.” 에이전트는 각 파일 및 각 속성에 대해 write_metadata를 호출합니다.
  4. 검증. 질문: “새 파일에서 Author와 Company를 다시 읽고, 여전히 차이가 있는 파일을 이유와 함께 나열해 주세요.” 실패 항목을 개수가 아니라 리스트 형태로 요청하세요.

누가 무엇을 결정하나요: 에이전트인가 엔진인가?

Decision Made by
범위에 포함되는 파일과 잘못된 값은 무엇인가 에이전트, 귀하의 표준에 따라
PDF, DOCX 또는 JPEG에서 속성 이름이 어떤 필드에 매핑되는가 엔진: write_metadata가 형식별 친숙한 이름을 매핑합니다
속성이 해당 형식에 존재하는지 여부 엔진: 적용되지 않는 쓰기는 0 변경으로 보고하거나 메시지와 함께 실패하며, 절대 조용히 성공하지 않습니다
무엇이 어디에 저장되었는가 도구: 저장된 경로 메시지와 변경된 필드 수를 반환합니다
최종 상태가 표준과 일치하는지 여부 에이전트, 다시 읽어 확인합니다

write_metadata는 property로 Author, Title, Subject, Keywords, Comments, Copyright, Company 또는 Manager 중 하나를 허용합니다. mode는 set(대체, 기본값) 또는 add(추가, Keywords와 같은 목록 필드용)입니다.

모든 편집을 유지하는 규칙은 무엇인가요?

write_metadata는 호출당 하나의 속성을 설정하고 새 파일을 저장합니다. 하나의 문서에 두 개의 속성이 있다면 두 번 호출해야 하며, 두 번째 호출은 첫 번째 결과에 적용되어야 합니다. 두 번째 호출이 원본에서 시작하면 첫 번째 편집이 사라집니다. 에이전트가 두 속성이 모두 설정되었지만 하나만 적용되었다고 보고할 때가 바로 이 이유입니다. 프롬프트에 규칙을 명시하세요:

두 번째 변경은 원본이 아니라 첫 번째에 의해 생성된 파일에 적용하세요.

예시 세션 (요약)

You:    Set Company to "Acme Ltd" on every .docx in the folder. List current values first.
Agent:  [calls search_metadata: nameContains = "Company", per file]
Agent:  proposal-q1.docx   Company = "Contoso GmbH"   -> will change
        handbook.docx      Company = "Acme Ltd"       -> already correct
        notes.docx         (no Company property)      -> will add
You:    Go ahead. Name each file you produced.
Agent:  [calls write_metadata: property = Company, value = "Acme Ltd", mode = set]
Agent:  2 files changed, 1 unchanged. Each saved copy is named in the tool reply.

이는 흐름을 보여주는 예시이며, 캡처된 스크린샷이 아닙니다.

왜 전체 폴더를 한 번에 수정하지 않나요?

무차별 대량 쓰기는 좋은 값을 더 나쁜 값으로 교체할 수 있으므로, 읽기 단계는 드라이런 역할을 합니다. 파일당 한 번의 추가 호출이 필요합니다. 사용량 기반 라이선스에서는 모든 호출이 사용량으로 청구되며, 200개 파일에 대해 두 속성을 한 번에 처리하면 400개의 쓰기 호출과 읽기가 추가됩니다. 따라서 먼저 필터링하고 두 번째에 쓰기를 수행하세요.

형식마다 차이가 있습니다. 형식에 해당 속성이 없을 경우 0 변경으로 보고하거나 메시지와 함께 실패하며, 성공한 척하지 않습니다. 이는 올바른 동작이지만 혼합된 폴더에서는 부분적인 결과가 나올 수 있습니다. 실패 항목을 리스트 형태로 요청하세요.

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

평가 모드에서는 처음 5개의 문서 속성만 읽을 수 있으며, XMP와 EXIF는 일부 사용할 수 없습니다. 쓰기도 동일하게 제한됩니다. 평가 중 “검사 후 쓰기” 워크플로우는 축소된 목록을 확인하므로, 수정하려는 속성을 놓칠 수 있습니다. get_license_status로 확인하고 결과에 의존하기 전에 라이선스 파일이나 사용량 기반 키를 적용하세요. 무료 30일 임시 라이선스를 제공하고 있습니다.

자주 묻는 질문

한 번에 100개의 Word 문서에서 저자를 변경할 수 있나요?
예, 폴더와 값을 지정하는 프롬프트를 사용하면 가능합니다. 에이전트는 Author 속성에 대해 파일당 하나의 write_metadata 호출을 수행하므로 100개의 파일은 100번의 쓰기 호출을 의미합니다.

에이전트가 원본 파일을 덮어쓰나요?
도구는 새 파일을 저장하고 경로를 반환하므로 원본은 출력되지 않습니다. 에이전트에게 생성한 각 파일의 이름을 알려 달라고 요청하고, 복사본을 검증할 때까지 원본을 보관하세요.

목록에 없는 사용자 정의 속성을 에이전트가 설정할 수 있나요?
문서에 명시된 property 값은 Author, Title, Subject, Keywords, Comments, Copyright, Company 및 Manager입니다. 그 외의 값은 도구가 지원하는 범위를 벗어납니다.

더 깊이 파고들기