“Đổi tên ACME Corp thành Globex trong hợp đồng này” là một công việc ba giây đối với con người và là một cái bẫy đối với tác nhân AI. Cách thông thường, đọc tài liệu và viết một bản mới, sẽ bỏ qua các kiểu dáng, viền bảng, tiêu đề và sự tin tưởng của người xem xét rằng không có gì khác bị di chuyển. Với máy chủ GroupDocs.Editor MCP chạy cục bộ, Claude, Cursor hoặc Copilot chỉnh sửa tệp thay vì gõ lại: chúng tìm từ, thay thế ngay tại chỗ, giữ nguyên định dạng, và cho bạn biết đã thay đổi bao nhiêu:

Đổi tên ACME Corp thành Globex Ltd trong contract.docx và giữ nguyên định dạng.

Phiên bản từng bước với cài đặt, lời nhắc và khắc phục sự cố có trong tài liệu: How to edit documents with AI agents using MCP.

Điều gì xảy ra sai khi mô hình viết lại tệp?

Một mô hình ngôn ngữ không giữ một .docx. Nó chỉ giữ văn bản. Khi bạn yêu cầu nó “cập nhật hợp đồng”, con đường tự nhiên là đọc các từ, thay đổi chúng, và tạo một tài liệu mới từ bản sao của nó. Ba thứ bị mất trên đường đi.

Định dạng. Tên các bên in đậm, tiêu đề có số thứ tự, đường kẻ lưới bảng, độ rộng cột của bảng phí, chân trang với số trang: không có gì trong số này là phần của văn bản mà mô hình đọc, vì vậy chúng không tồn tại sau chuyến đi trừ khi có thứ gì đó tái tạo chúng.

Mọi thứ mà mô hình không được yêu cầu chạm tới. Việc tái sinh có nghĩa là mỗi câu lại được đưa qua mô hình một lần nữa. Một điều khoản có thể “được dọn dẹp”, một số được định dạng lại, một câu bị bỏ vì cửa sổ ngữ cảnh đã đầy. Người xem xét giờ phải so sánh toàn bộ tài liệu để tin tưởng vào một thay đổi ba từ.

Dấu vết kiểm toán. “Tôi đã cập nhật hợp đồng” là câu trả lời giống nhau dù mô hình thay đổi một tên hay bảy tên. Không có số đếm, và không có cách nào để phân biệt một chỉnh sửa cẩn thận với một chỉnh sửa tự tin.

Các máy chủ chỉnh sửa chỉ DOCX đã tồn tại đã giải quyết vấn đề đầu tiên cho Word. Hai vấn đề còn lại, và mọi định dạng không phải Word, vẫn còn mở.

Một chỉnh sửa có mục tiêu trông như thế nào?

Hai lời gọi. Được ghi lại từ GroupDocs.Editor.Mcp 26.10.0 đối với một hợp đồng dịch vụ tổng hợp trong đó “ACME Corp” xuất hiện bảy lần:

-> get_document_info {"file":{"filePath":"contract.docx"}}
<- { "family": "WordProcessing", "pageCount": 1, "canEdit": true,
     "canSaveTo": [ "docx", "doc", "rtf", "odt", "pdf", "md", ... ] }

-> replace_text {"file":{"filePath":"contract.docx"},
                 "find":"ACME Corp","replace":"Globex Ltd","wholeWord":true}
<- Replaced 6 occurrence(s) of 'ACME Corp' in 'contract.docx'
   Saved to: …/contract_edited.docx

-> replace_text {"file":{"filePath":"contract.docx"},
                 "find":"Initech","replace":"Globex Ltd"}
<- Text replacement found no matches for 'Initech' in 'contract.docx'.
   No file was written.

Bản sao đã chỉnh sửa giữ nguyên tên bên in đậm, kiểu tiêu đề và bảng phí. Bản gốc không bị chạm tới; kết quả là một tệp mới, contract_edited.docx, trong thư mục lưu trữ.

Tại sao lại là sáu mà không phải bảy?

Đây là chi tiết đáng đọc hai lần. Lần thứ bảy của “ACME Corp” nằm trong điều khoản thông báo, nơi “ACME” in nghiêng và " Corp" không. Trong tệp, chúng là hai đoạn định dạng, và replace_text chỉ khớp trong một đoạn. Nó không đoán, và không hợp nhất các kiểu để buộc khớp; nó báo cáo sáu, và lần thứ bảy vẫn còn “ACME Corp”.

Đó là hành vi bạn muốn từ một công cụ chỉnh sửa hợp đồng. Một số đếm thấp hơn mong đợi là lời nhắc để kiểm tra; một bản viết lại “hoàn thành” im lặng thì không. Tác nhân có thể tiếp tục với con đường khác mà máy chủ cung cấp: trích xuất phần đó dưới dạng HTML, chỉnh sửa và lưu lại. Bài viết round-trip post đề cập đến nó.

Các lời gọi, theo thứ tự

user              agent                        Editor MCP server
 |  "Đổi tên ACME Corp thành Globex Ltd trong contract.docx"          |
 |---------------->|                                           |
 |                 |-- get_document_info {"file":...} -------->|
 |                 |<- WordProcessing, 1 page, canEdit --------|
 |                 |-- replace_text {"find":"ACME Corp",       |
 |                 |     "replace":"Globex Ltd",               |
 |                 |     "wholeWord":true} ------------------->|
 |                 |<- "Replaced 6 occurrence(s) ...           |
 |                 |    Saved to: .../contract_edited.docx" ---|
 |<- "6 changed; one more is split across formatting - check  |
 |    the notices clause. The original is kept."               |
      (a find that matches nothing: 'No file was written.')

Tại sao điều này hơn cả một mẹo Word

Lời gọi tương tự hoạt động trên một worksheet, một slide, một PDF hoặc một tệp văn bản. Trong thử nghiệm của chúng tôi, "worksheet": 1 đã đổi tên nhà cung cấp trên bảng tóm tắt ngân sách và để nguyên hai sheet còn lại; "slide": 1 đã làm tương tự trên một bộ slide đánh giá. "format": "pdf" chỉnh sửa và chuyển đổi trong một lời gọi, vì vậy “sửa tên và gửi cho tôi một PDF” là một bước. "regex": true xử lý các mẫu như chuỗi phiên bản.

Trước khi chỉnh sửa, get_document_info cho tác nhân biết nó đang làm việc với gì: họ họ, số trang, worksheet hoặc slide, liệu tệp có được bảo vệ bằng mật khẩu hay không, và những định dạng nào nó có thể lưu. Một tác nhân thận trọng sẽ gọi nó trước, và bạn có thể yêu cầu nó làm như vậy.

Cài đặt

dnx GroupDocs.Editor.Mcp --yes

với GROUPDOCS_MCP_STORAGE_PATH chỉ đến thư mục mà tác nhân có thể chỉnh sửa, hoặc hình ảnh Docker ghcr.io/groupdocs-editor/editor-net-mcp. Cấu hình theo khách hàng nằm trong documentation hub. Những thay đổi trong engine được liệt kê trong GroupDocs.Editor for .NET 26.6 release notes.

Giới hạn trung thực

  • replace_text chỉ khớp trong một đoạn định dạng; một cụm từ bị chia thành nhiều kiểu không được tìm thấy, và số đếm sẽ phản ánh điều đó.
  • Không có thay đổi được theo dõi và không có bình luận: kết quả là một bản sao đã chỉnh sửa, không phải một bản so sánh.
  • Chế độ đánh giá: mọi đầu ra bắt đầu bằng một dòng banner đánh giá, các workbook đã lưu sẽ có thêm một worksheet, và chỉ hai worksheet hoặc slide đầu tiên có thể được chỉnh sửa. Máy chủ sẽ từ chối thứ ba và giải thích lý do.
  • Chỉnh sửa PDF là chuyển đổi sang HTML hoặc Word có thể chỉnh sửa và quay lại; không phải là chỉnh sửa PDF tại chỗ.

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

Tác nhân có ghi đè lên tệp gốc của tôi không?
Không. Mọi chỉnh sửa đều ghi vào một tệp mới, <name>_edited.<ext> theo mặc định hoặc outputName bạn chỉ định, vào thư mục lưu trữ.

Nếu văn bản không có trong tài liệu thì sao?
Không có gì được ghi. Máy chủ trả lời “found no matches … No file was written.”, vì vậy tác nhân có thể thông báo cho bạn thay vì trả lại một bản sao không thay đổi.

Có hoạt động mà không cần cài đặt Word không?
Có. Máy chủ chạy cục bộ với engine GroupDocs.Editor; không cần cài đặt Office và không cần tải lên.

Đi sâu hơn