Để chỉnh sửa hàng loạt thuộc tính tài liệu, cung cấp cho một tác nhân AI một tiêu chuẩn và một thư mục, và để nó đọc, ghi và xác minh thông qua GroupDocs.Metadata.Mcp chạy cục bộ. Một lời nhắc là đủ để bắt đầu:

Đối với mỗi tài liệu trong thư mục của tôi, đặt Company thành “Acme Ltd” và Author thành “Research Team”, sau đó cho tôi biết những tệp nào bạn đã thay đổi.

Phiên bản từng bước với cấu hình và khắc phục sự cố có trong tài liệu: Cách chỉnh sửa hàng loạt thuộc tính tài liệu bằng một tác nhân AI.

Tại sao tiêu chuẩn siêu dữ liệu lại bị lệch ngay từ đầu?

Mẫu để lại công ty trước đó trong mỗi tệp mới. Việc đổi tên nhóm để lại tên cũ trong trường tác giả. Một cuộc di chuyển để lại các dấu thời gian không có ý nghĩa. Không ai chỉnh sửa thuộc tính bằng tay trên 200 tệp, vì vậy sự lệch vẫn tồn tại. Một tác nhân có vòng lặp là công cụ phù hợp cho việc này, nhưng chỉ khi việc chỉnh sửa được thực hiện bởi một engine: một mô hình ngôn ngữ “viết lại” tài liệu để thay đổi tác giả sẽ tạo lại nội dung, trong khi write_metadata chỉ thay đổi một trường và để nguyên phần thân.

Quy trình làm việc

Quy trình có bốn bước, mỗi bước có một lời nhắc. Chạy nó trong Claude Desktop, Claude Code, Cursor, GitHub Copilot hoặc bất kỳ client nào khác đã đăng ký máy chủ.

  1. Kiểm tra giấy phép. Hỏi: “Trạng thái giấy phép của máy chủ metadata là gì?” Tác nhân gọi get_license_status. Thực hiện việc này trước khi chạy hàng loạt, không phải sau.
  2. Đọc các giá trị hiện tại. Hỏi: “Đầu tiên liệt kê Author và Company hiện tại cho mỗi tệp.” Tác nhân gọi search_metadata với nameContains, trả về chỉ các thuộc tính khớp.
  3. Ghi chỉ những gì sai. Hỏi: “Chỉ thay đổi những mục sai.” Tác nhân gọi write_metadata cho mỗi tệp và mỗi thuộc tính.
  4. Xác minh. Hỏi: “Đọc lại Author và Company trên các tệp mới và liệt kê bất kỳ tệp nào vẫn khác, kèm lý do.” Yêu cầu các thất bại dưới dạng danh sách thay vì số lượng.

Ai quyết định gì: tác nhân hay engine?

Quyết định Người thực hiện
Các tệp nào nằm trong phạm vi, và giá trị nào sai Tác nhân, dựa trên tiêu chuẩn của bạn
Tên thuộc tính nào ánh xạ tới trường nào trong PDF, DOCX hoặc JPEG Engine: write_metadata ánh xạ tên thân thiện theo định dạng
Liệu một thuộc tính có tồn tại trong một định dạng hay không Engine: một thao tác ghi không áp dụng sẽ báo 0 thay đổi hoặc thất bại kèm thông báo, không bao giờ thành công im lặng
Những gì đã được lưu và ở đâu Công cụ: nó trả về thông báo đường dẫn đã lưu và số trường đã thay đổi
Liệu trạng thái cuối cùng có khớp với tiêu chuẩn hay không Tác nhân, bằng cách đọc lại

write_metadata chấp nhận property là một trong các giá trị Author, Title, Subject, Keywords, Comments, Copyright, Company hoặc Manager. mode là set (thay thế, mặc định) hoặc add (thêm vào, cho các trường danh sách như Keywords).

Quy tắc giữ cho mỗi lần chỉnh sửa

write_metadata đặt một thuộc tính cho mỗi lần gọi và lưu một tệp mới. Hai thuộc tính trên một tài liệu là hai lần gọi, và lần thứ hai phải được áp dụng lên kết quả của lần đầu. Nếu lần gọi thứ hai bắt đầu từ tệp gốc, chỉnh sửa đầu tiên sẽ biến mất. Khi một tác nhân báo rằng cả hai thuộc tính đều được đặt nhưng chỉ một thuộc tính giữ lại, đây là lý do. Nêu quy tắc này trong lời nhắc:

Áp dụng thay đổi thứ hai lên tệp được tạo bởi thay đổi thứ nhất, không phải lên tệp gốc.

Phiên làm việc mẫu (rút gọn)

Bạn:    Đặt Company thành "Acme Ltd" trên mọi tệp .docx trong thư mục. Đầu tiên liệt kê các giá trị hiện tại.
Tác nhân:  [gọi search_metadata: nameContains = "Company", per file]
Tác nhân:  proposal-q1.docx   Company = "Contoso GmbH"   -> sẽ thay đổi
        handbook.docx      Company = "Acme Ltd"       -> đã đúng
        notes.docx         (không có thuộc tính Company)      -> sẽ thêm
Bạn:    Tiếp tục. Đặt tên cho mỗi tệp bạn đã tạo.
Tác nhân:  [gọi write_metadata: property = Company, value = "Acme Ltd", mode = set]
Tác nhân:  2 tệp đã thay đổi, 1 không thay đổi. Mỗi bản sao đã lưu được đặt tên trong phản hồi của công cụ.

Đây là minh họa cho quy trình, không phải một ảnh chụp màn hình thực tế.

Tại sao không sửa toàn bộ thư mục trong một lần?

Việc ghi hàng loạt mù quáng có thể thay thế các giá trị tốt bằng các giá trị kém hơn, vì vậy bước đọc là chạy thử. Nó tốn một lần gọi bổ sung cho mỗi tệp. Với giấy phép tính theo lượt, mỗi lần gọi đều bị tính phí, và việc quét hai thuộc tính trên 200 tệp là 400 lần gọi ghi cộng với các lần đọc, vì vậy hãy lọc trước và ghi sau.

Các định dạng khác nhau. Một thuộc tính mà một định dạng không hỗ trợ sẽ được báo là 0 thay đổi hoặc thất bại kèm thông báo thay vì giả vờ thành công, đây là hành vi đúng nhưng đồng nghĩa với việc một thư mục hỗn hợp có thể cho kết quả một phần. Yêu cầu các thất bại dưới dạng danh sách.

Giới hạn trong chế độ đánh giá là gì?

Trong chế độ đánh giá, chỉ 5 thuộc tính tài liệu đầu tiên có thể đọc được, và XMP và EXIF chỉ một phần khả dụng. Việc ghi cũng bị giới hạn tương tự. Quy trình “kiểm tra, rồi ghi” trong chế độ đánh giá chỉ kiểm tra danh sách rút gọn, vì vậy có thể bỏ lỡ thuộc tính bạn đang cố sửa. Xác nhận bằng get_license_status và áp dụng tệp giấy phép hoặc khóa tính theo lượt trước khi dựa vào kết quả. Một giấy phép tạm thời miễn phí 30 ngày có sẵn.

Câu hỏi thường gặp

Tôi có thể thay đổi tác giả trên 100 tài liệu Word cùng một lúc không?
Có, với một lời nhắc chỉ định thư mục và giá trị. Tác nhân thực hiện một lần gọi write_metadata cho mỗi tệp cho thuộc tính Author, vì vậy 100 tệp đồng nghĩa với 100 lần gọi ghi.

Tác nhân có ghi đè lên các tệp gốc của tôi không?
Công cụ lưu một tệp mới và trả về đường dẫn của nó, vì vậy tệp gốc không phải là kết quả. Yêu cầu tác nhân đặt tên cho mỗi tệp nó tạo ra, và giữ các tệp gốc cho đến khi bạn xác minh các bản sao.

Tác nhân có thể đặt một thuộc tính tùy chỉnh không có trong danh sách không?
Các giá trị property được tài liệu mô tả là Author, Title, Subject, Keywords, Comments, Copyright, Company và Manager. Bất kỳ giá trị nào khác nằm ngoài những gì công cụ mô tả.

Đi sâu hơn