“Rename ACME Corp to Globex in this contract” เป็นงานที่ใช้เวลาเพียงสามวินาทีสำหรับคนและเป็นกับดักสำหรับเอเจนต์ AI. วิธีที่ชัดเจนที่สุดคืออ่านเอกสารแล้วเขียนใหม่ ซึ่งจะทำให้สไตล์, เส้นขอบตาราง, ส่วนหัวและความมั่นใจของผู้ตรวจสอบว่ามีอะไรเปลี่ยนแปลงไม่ได้หายไป. ด้วย GroupDocs.Editor MCP server ที่ทำงานในเครื่อง, Claude, Cursor หรือ Copilot จะทำการแก้ไขไฟล์แทนการพิมพ์ใหม่: มันค้นหาคำ, แทนที่, รักษาการจัดรูปแบบ, เขียนสำเนาที่แก้ไขแล้ว, และบอกคุณว่ามีการเปลี่ยนแปลงกี่รายการ:
เปลี่ยนชื่อ ACME Corp เป็น Globex Ltd ในไฟล์ contract.docx และคงรูปแบบไว้
เวอร์ชันขั้นตอนต่อขั้นตอนพร้อมการตั้งค่า, คำสั่งและการแก้ปัญหาอยู่ในเอกสาร: วิธีแก้ไขเอกสารด้วยเอเจนต์ AI โดยใช้ MCP.
สิ่งที่ผิดพลาดเมื่อโมเดลเขียนทับไฟล์?
โมเดลภาษาไม่ได้ถือไฟล์ .docx. มันถือข้อความเท่านั้น. เมื่อคุณขอให้มัน “อัปเดตสัญญา”, เส้นทางธรรมชาติคืออ่านคำออก, เปลี่ยนคำ, แล้วสร้างเอกสารใหม่จากสำเนาของมันเอง. มีสามสิ่งที่หายไประหว่างทาง
Formatting. ชื่อพรรคที่เป็นตัวหนา, หัวข้อที่เป็นลำดับเลข, เส้นกริดของตาราง, ความกว้างคอลัมน์ของตารางค่าธรรมเนียม, ส่วนหัวที่วิ่งต่อเนื่อง: สิ่งเหล่านี้ไม่ได้เป็นส่วนของข้อความที่โมเดลอ่าน, ดังนั้นจะไม่คงอยู่ในการเดินทางเว้นแต่มีบางอย่างสร้างขึ้นใหม่
Everything the model was not asked to touch. การสร้างใหม่หมายความว่าประโยคทุกประโยคต้องผ่านโมเดลอีกครั้ง. ข้อความหนึ่งอาจถูก “ทำความสะอาด”, ตัวเลขอาจถูกจัดรูปแบบใหม่, ประโยคอาจถูกตัดออกเพราะหน้าต่างบริบทเต็ม. ผู้ตรวจสอบต้องเปรียบเทียบ (diff) เอกสารทั้งหมดเพื่อเชื่อถือการเปลี่ยนแปลงเพียงสามคำ
The audit trail. “ฉันอัปเดตสัญญา” เป็นคำตอบเดียวกันไม่ว่าจะโมเดลเปลี่ยนชื่อหนึ่งรายการหรือเจ็ดรายการ. ไม่มีการนับและไม่มีวิธีบอกว่าการแก้ไขนั้นระมัดระวังหรือมั่นใจ
การแก้ไขที่เจาะจงเป็นอย่างไร?
สองคำสั่ง. ดึงมาจาก GroupDocs.Editor.Mcp 26.10.0 กับสัญญาบริการสังเคราะห์ที่มี “ACME Corp” ปรากฏเจ็ดครั้ง:
-> 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.
สำเนาที่แก้ไขแล้วยังคงชื่อพรรคที่เป็นตัวหนา, สไตล์หัวข้อและตารางค่าธรรมเนียม. ไฟล์ต้นฉบับไม่ได้ถูกแก้ไข; ผลลัพธ์คือไฟล์ใหม่ contract_edited.docx ในโฟลเดอร์จัดเก็บ
สำเนานั้นถูกเขียนโดยเอนจิน, ไม่ได้แพตช์ไบต์ต่อไบต์: เซิร์ฟเวอร์เปิดเอกสารในโมเดลการแก้ไข HTML ของมัน, แทนที่ข้อความที่นั่นและบันทึกไฟล์ใหม่. เราได้ทดสอบว่าตัวเอกสาร Word เก็บอะไรไว้บ้าง. สไตล์, ตาราง, รูปภาพ, ไฮเปอร์ลิงก์, บุ๊กมาร์ก, ส่วนหัว,เชิงอรรถและคอมเมนต์ทั้งหมดผ่านไป. บนเซิร์ฟเวอร์ 26.10.0 footer does not, คอนเทนต์คอนโทรลจะถูกแปลงเป็นข้อความธรรมดา, และการเปลี่ยนแปลงที่ติดตามจะสูญเสียผู้เขียน. รายการเต็มและวิธีแก้ปัญหาสำหรับส่วนท้ายอยู่ใน FAQ.
ทำไมถึงได้หกแทนที่จะเจ็ด?
นี่คือรายละเอียดที่ควรอ่านสองครั้ง. การปรากฏครั้งที่เจ็ดของ “ACME Corp” อยู่ในข้อกำหนดแจ้งเตือน, โดยที่ “ACME” เป็นอิตาลิกและ " Corp" ไม่เป็น. ในไฟล์นั้นเป็นสองรันของการจัดรูปแบบ, และ replace_text จะจับคู่ภายในรันเดียว. มันไม่ได้เดาและไม่ได้รวมสไตล์เพื่อบังคับให้จับคู่; มันรายงานว่าพบหกรายการ, ส่วนรายการที่เจ็ดยังคงเป็น “ACME Corp”.
นั่นคือพฤติกรรมที่คุณต้องการจากเครื่องมือที่แก้ไขสัญญา. การนับที่น้อยกว่าที่คาดหมายเป็นสัญญาณให้ตรวจสอบ; การเขียนทับแบบเงียบ ๆ ที่ “สมบูรณ์” ไม่ใช่. เอเจนต์สามารถดำเนินการต่อด้วยเส้นทางอื่นที่เซิร์ฟเวอร์เสนอ: ดึงส่วนนั้นออกเป็น HTML, แก้ไข, แล้วบันทึกกลับ. โพสต์รอบการเดินทาง ครอบคลุมเรื่องนี้
คำสั่ง, ตามลำดับ
user agent Editor MCP server
| "Rename ACME Corp to Globex Ltd in 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.')
ทำไมสิ่งนี้จึงมากกว่าทริคของ Word
คำสั่งเดียวกันทำงานบน worksheet, slide, PDF หรือไฟล์ข้อความ. ในการทดสอบของเรา, "worksheet": 1 เปลี่ยนชื่อผู้จัดหาในแผ่นสรุปของงบประมาณและปล่อยให้แผ่นอื่นสองแผ่นอยู่; "slide": 1 ทำเช่นเดียวกันบนชุดสไลด์รีวิว. "format": "pdf" แก้ไขและแปลงในคำสั่งเดียว, ดังนั้น “แก้ชื่อและส่ง PDF ให้ฉัน” เป็นขั้นตอนเดียว. "regex": true จัดการรูปแบบเช่นสตริงเวอร์ชัน
ก่อนแก้ไข, get_document_info บอกเอเจนต์ว่ากำลังจัดการกับอะไร: ครอบครัว, จำนวนหน้า, worksheet หรือ slide, ว่าไฟล์ถูกป้องกันด้วยรหัสผ่านหรือไม่, และฟอร์แมตใดบ้างที่สามารถบันทึกได้. เอเจนต์ระมัดระวังจะเรียกมันก่อน, และคุณสามารถสั่งให้ทำได้
การตั้งค่า
dnx GroupDocs.Editor.Mcp --yes
โดยที่ GROUPDOCS_MCP_STORAGE_PATH ชี้ไปที่โฟลเดอร์ที่เอเจนต์อาจแก้ไข, หรืออิมเมจ Docker ghcr.io/groupdocs-editor/editor-net-mcp (บน Linux, รันด้วย --user "$(id -u):$(id -g)" เพื่อให้สามารถเขียนลงในโฟลเดอร์ของคุณ). การกำหนดค่าตามลูกค้าต่าง ๆ อยู่ใน ศูนย์เอกสาร. สิ่งที่เปลี่ยนแปลงในเอนจินเองอยู่ใน บันทึกเวอร์ชัน GroupDocs.Editor for .NET 26.6.
ข้อจำกัดที่ตรงไปตรงมา
replace_textจับคู่ภายในรันการจัดรูปแบบเดียว; วลีที่ถูกแยกออกเป็นหลายสไตล์จะไม่พบ, และจำนวนที่แสดงจะบ่งบอกเช่นนั้น- บนเซิร์ฟเวอร์ 26.10.0,
replace_textลบส่วนท้ายของเอกสาร Word จากสำเนาที่แก้ไข, และทำให้คอนเทนต์คอนโทรลแบนเป็นข้อความธรรมดา. ใช้การเดินทาง HTML แบบแบ่งหน้าเพื่อเอกสารที่ส่วนท้ายสำคัญ (details) - ไม่มี redline: การแก้ไขใหม่ไม่ถูกติดตาม. คอมเมนต์และการเปลี่ยนแปลงที่ติดตามอยู่เดิมในสำเนา
- โหมดประเมินผล: ผลลัพธ์ทุกอย่างเริ่มต้นด้วยบรรทัดแบนเนอร์การประเมิน, เวิร์กบุ๊กที่บันทึกจะเพิ่ม worksheet เพิ่มเติมหนึ่งแผ่น, และสามารถแก้ไขได้เพียงสอง worksheet หรือ slide แรก; เซิร์ฟเวอร์จะปฏิเสธการแก้ไขที่สามและบอกเหตุผล. PDF จะถูกแก้ไขสองหน้าต่อคำสั่ง
- การแก้ไข PDF เป็นการแปลงเป็น HTML หรือ Word ที่แก้ไขได้แล้วแปลงกลับ; ไม่ใช่การแก้ไข PDF ภายในที่ตำแหน่งเดียว
FAQ
Will the agent overwrite my original file?
ไม่. การแก้ไขทุกครั้งจะบันทึกเป็นไฟล์ใหม่, <name>_edited.<ext> ตามค่าเริ่มต้นหรือ outputName ที่คุณระบุ, ไปยังโฟลเดอร์ผลลัพธ์. ชื่อที่มีอยู่แล้วจะได้รับหมายเลขต่อท้าย, contract_edited (1).docx; ไม่มีไฟล์ใดถูกเขียนทับ
ถ้าข้อความไม่อยู่ในเอกสารจะเกิดอะไรขึ้น? ไม่มีอะไรถูกเขียน. เซิร์ฟเวอร์ตอบกลับ “found no matches … No file was written.”, ดังนั้นเอเจนต์สามารถแจ้งคุณแทนการส่งสำเนาที่ไม่ได้เปลี่ยนแปลงกลับมา
Does it work without Word installed?
ใช่. เซิร์ฟเวอร์ทำงานในเครื่องด้วยเอนจิน GroupDocs.Editor; ไม่ต้องติดตั้ง Office และไม่ต้องอัปโหลดไฟล์
ไปให้ลึกขึ้น
- เอกสาร, วิธีทำแบบมาตรฐาน: วิธีแก้ไขเอกสารด้วยเอเจนต์ AI โดยใช้ MCP
- ศูนย์เอกสาร: GroupDocs.Editor MCP Server
- หน้าผลิตภัณฑ์ GroupDocs.Editor MCP — การติดตั้งคลิกเดียวสำหรับ VS Code และ Cursor, การกำหนดค่าสำหรับไคลเอนต์อื่น ๆ ทุกประเภท
- เกี่ยวข้อง: เปลี่ยนชื่อฝ่ายใน 40 สัญญาโดยไม่กระทบการจัดรูปแบบ
- เกี่ยวข้อง: เติมฟอร์ม Word จากสเปรดชีตด้วยเอเจนต์ AI, ทำในเครื่อง
- เกี่ยวข้อง: แก้ไข worksheet หนึ่งแผ่น, รักษาเวิร์กบุ๊ก: การแก้ไขแบบศัลยกรรมด้วยการเดินทาง HTML
- เกี่ยวข้อง: แก้ไข PDF ด้วยเอเจนต์ AI? แปลงเป็น Word ก่อน, ทำในเครื่อง
- โมเดลการติดตั้งในองค์กรและความปลอดภัย: 3 สถาปัตยกรรมสำหรับการประมวลผลเอกสาร AI, และแบบที่เก็บไฟล์ไว้ภายในเครือข่ายของคุณ
- คำถาม: GroupDocs Editor forum
- แหล่งที่มา: GroupDocs.Editor.Mcp on GitHub · NuGet package