Để tự động gắn thương hiệu vào tài liệu, hãy cung cấp cho một tác nhân AI một chỉ dẫn cố định và để nó gọi công cụ đánh dấu hình ảnh cục bộ cho mỗi tệp trong thư mục đầu ra. Với máy chủ GroupDocs.Watermark.Mcp, chỉ dẫn đó có thể là một dòng duy nhất trong tệp quy tắc, một chỉ dẫn dự án trong Claude Code, hoặc một lời nhắc bạn dán vào Cursor:

Đặt logo.png trên mỗi trang của mỗi tệp trong thư mục đầu ra với độ trong suốt 25%, sau đó liệt kê các tệp bạn đã tạo.

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 gắn thương hiệu vào tài liệu bằng dấu nước logo sử dụng AI.

Tại sao việc gắn thương hiệu thủ công lại lệch lạc?

Việc gắn thương hiệu bằng tay khác nhau tùy người: một nhóm dán logo vào tệp nguồn, nhóm khác dán dấu PDF với độ mạnh tối đa, nhóm thứ ba lại quên. Một LLM “thêm logo” bằng cách chỉnh sửa nội dung tài liệu cũng không có vị trí ổn định. Công cụ add_image_watermark áp dụng logo dưới dạng đối tượng watermark, với các giá trị opacity và rotation rõ ràng, vì vậy cùng đầu vào sẽ cho cùng độ mạnh và góc. Vì nó là một đối tượng chứ không phải nội dung dán, logo có thể được tìm và loại bỏ sau này khi thương hiệu thay đổi.

Tác nhân quyết định gì, và động cơ thực hiện gì?

Bước Tác nhân quyết định Động cơ thực hiện
Các tệp nào nằm trong phạm vi Đọc thư mục và chỉ dẫn của bạn Không có gì
Công cụ nào sẽ gọi add_image_watermark cho một logo, add_watermark cho một trạng thái Không có gì
Độ mạnh và góc Truyền opacity và rotation từ tiêu chuẩn của bạn Vẽ dấu với chính xác các giá trị đó
Đầu ra Báo cáo các tệp đã tạo Ghi một tệp mới; tệp gốc không bị thay đổi

Tiêu chuẩn nằm trong lời nhắc của bạn. Máy chủ không tự lên lịch và không có chính sách thương hiệu tích hợp; phần có thể lặp lại là chỉ dẫn bạn lưu và tái sử dụng.

Làm thế nào để thực thi tiêu chuẩn trong năm bước?

  1. Giữ logo bên cạnh các tài liệu. Cả tài liệu và hình ảnh đều được giải quyết theo tên từ thư mục lưu trữ (GROUPDOCS_MCP_STORAGE_PATH). Sử dụng PNG trong suốt; logo trên một hình chữ nhật trắng sẽ hiển thị hình chữ nhật đó trên trang.
  2. Tách các tệp đầu ra. Đặt GROUPDOCS_MCP_OUTPUT_PATH thành một thư mục khác nếu bạn muốn các bản sao có thương hiệu được giữ riêng biệt khỏi nguồn. Nếu không đặt, đầu ra sẽ vào thư mục lưu trữ.
  3. Kiểm tra giấy phép. Hỏi: “Trạng thái giấy phép của máy chủ watermark là gì?” Tác nhân sẽ gọi get_license_status.
  4. Chạy lời nhắc tiêu chuẩn. Độ trong suốt từ 0.2 đến 0.4 là khoảng mà tài liệu khuyến nghị cho việc gắn thương hiệu; trên 0.6 logo sẽ chiếm ưu thế trên trang.
  5. Xác minh. Yêu cầu một lần search_watermarks trên mỗi tệp đã tạo và so sánh số lượng với những gì bạn mong đợi.

Dấu cũng có thể ghi trạng thái không?

Có, bằng một lời gọi chuỗi thứ hai. Gắn thương hiệu và ghi trạng thái trong một yêu cầu:

Thêm logo với độ trong suốt 25%, sau đó thêm dấu nước văn bản CONFIDENTIAL vào kết quả đó.

Mỗi lời gọi ghi một tệp mới, vì vậy “to that result” là gì giữ lại cả hai dấu.

Phiên làm việc ví dụ (rút gọn)

You:    Put logo.png on report.pdf at 30% opacity.
Agent:  [add_image_watermark: watermarkImage logo.png, opacity 0.3]
        Added image watermark from "logo.png" to "report.pdf"
You:    That is too strong - redo it at 0.2.
Agent:  [add_image_watermark: opacity 0.2, from the original report.pdf]
        Added image watermark from "logo.png" to "report.pdf"
        Two branded copies exist. Delete the 0.3 copy if you do not need it.

Lặp lại theo cách này là an toàn vì mỗi lần thử là một tệp mới. Xóa các tệp bị từ chối sau đó.

Kênh triển khai nào phù hợp cho việc triển khai nhóm?

Đối với cấu hình chia sẻ, hình ảnh Docker tránh việc cài đặt bất kỳ thứ gì khác trên mỗi máy, vì môi trường chạy và các phụ thuộc gốc nằm bên trong nó:

docker run --rm -i -v $(pwd)/documents:/data \
  ghcr.io/groupdocs-watermark/watermark-net-mcp:latest

Kênh NuGet (dnx GroupDocs.Watermark.Mcp --yes) cần .NET 10 SDK. Cả hai đều chạy trên Windows, Linux và macOS (dnx trên Linux/macOS cũng cần libgdiplus), và cả hai đều sử dụng cùng sáu công cụ, vì vậy lời nhắc thương hiệu không thay đổi giữa chúng.

Những giới hạn là gì?

Lên kế hoạch quanh hai giới hạn. Thứ nhất, công cụ chỉ cho phép opacity và rotation: không có cài đặt vị trí, kích thước hay lề. Thứ hai, chế độ đánh giá: trang giấy phép của máy chủ cho biết đầu ra không có giấy phép có các hạn chế đánh giá (các giới hạn chính xác có trên trang giấy phép), vì vậy các bản sao có thương hiệu được tạo mà không có giấy phép không được phân phối. Chạy get_license_status trước khi triển khai thương hiệu. Dưới giấy phép tính theo lượt, mỗi tệp được xử lý sẽ bị tính phí, và dưới giấy phép cố định máy chủ hoạt động offline. Cũng hãy nhớ rằng một watermark chỉ dán nhãn cho tài liệu; nó không bảo vệ nội dung bên dưới.

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

AI có thể thêm logo công ty chúng tôi vào tất cả các PDF không?
Có. Yêu cầu logo bằng tên tệp và cung cấp độ trong suốt; tác nhân sẽ gọi add_image_watermark một lần cho mỗi tệp. Lời gọi tương tự cũng hoạt động trên Word, PowerPoint, Excel và các tệp hình ảnh.

Tôi có thể sử dụng cùng một logo cho hình ảnh và tài liệu không?
Có. Hình ảnh là mục tiêu hợp lệ, vì vậy việc gắn thương hiệu cho ảnh sản phẩm hoạt động giống như gắn thương hiệu cho PDF.

Điều gì xảy ra khi thương hiệu thay đổi?
remove_watermarks có thể gỡ logo cũ ra, vì nó đã được áp dụng dưới dạng đối tượng watermark. textFilter của nó chỉ khớp với văn bản watermark, vì vậy việc xóa logo hình ảnh đồng nghĩa với việc xóa tất cả các watermark, bao gồm cả dấu văn bản. Đầu tiên hãy tìm kiếm để biết có gì, sau đó thêm logo mới.

Đi sâu hơn