Aby automatycznie znakować dokumenty, podaj agentowi AI jedną stałą instrukcję i pozwól mu wywoływać lokalnie narzędzie do znakowania obrazem dla każdego pliku w folderze wyjściowym. W serwerze GroupDocs.Watermark.Mcp ta instrukcja może być jedną linią w pliku reguł, instrukcją projektu w Claude Code lub poleceniem, które wkleisz do Cursor:

Umieść logo.png na każdej stronie każdego pliku w folderze wyjściowym przy 25 % krycia, a następnie wypisz wygenerowane pliki.

Szczegółowa wersja krok po kroku z konfiguracją i rozwiązywaniem problemów znajduje się w dokumentacji: Jak znakować dokumenty logo‑watermarkiem przy użyciu AI.

Dlaczego ręczne znakowanie się rozjeżdża?

Znakowanie wykonywane ręcznie różni się w zależności od osoby: jeden zespół wkleja logo do pliku źródłowego, inny nakłada znak na PDF z pełną intensywnością, trzeci zapomina. LLM, który „dodaje logo” poprzez edycję treści dokumentu, nie ma stabilnego położenia. Narzędzie add_image_watermark nakłada logo jako obiekt znakowania, z wyraźnie określonymi wartościami opacity i rotation, więc te same dane wejściowe dają tę samą intensywność i kąt. Ponieważ jest to obiekt, a nie wklejona treść, logo można później odnaleźć i usunąć, gdy marka się zmieni.

Co decyduje agent, a co robi silnik?

Krok Decyduje agent Robi silnik
Które pliki są w zakresie Czyta folder i Twoją instrukcję Brak
Które narzędzie wywołać add_image_watermark dla logo, add_watermark dla statusu Brak
Intensywność i kąt Przekazuje opacity i rotation z Twojego standardu Rysuje znak dokładnie z podanymi wartościami
Wynik Raportuje wygenerowane pliki Zapisuje nowy plik; oryginał nie jest modyfikowany

Standard znajduje się w Twoim poleceniu. Serwer nie planuje sam siebie i nie ma wbudowanej polityki marki; powtarzalna część to instrukcja, którą zapisujesz i ponownie używasz.

Jak egzekwować standard w pięciu krokach?

  1. Trzymaj logo obok dokumentów. Zarówno dokument, jak i obraz są rozpoznawane po nazwie z folderu przechowywania (GROUPDOCS_MCP_STORAGE_PATH). Użyj przeźroczystego PNG; logo na białym prostokącie pokaże ten prostokąt na stronie.
  2. Oddziel pliki wyjściowe. Ustaw GROUPDOCS_MCP_OUTPUT_PATH na inny folder, jeśli chcesz, aby znakowane kopie były przechowywane osobno od źródeł. Jeśli nie zostanie ustawione, wyjście trafia do folderu przechowywania.
  3. Sprawdź licencję. Zapytaj: „Jaki jest status licencji serwera watermark?” Agent wywołuje get_license_status.
  4. Uruchom standardowe polecenie. Krycie w przedziale od 0,2 do 0,4 to zakres zalecany w dokumentacji dla znakowania; powyżej 0,6 logo dominuje stronę.
  5. Zweryfikuj. Poproś o przejście search_watermarks dla każdego wygenerowanego pliku i porównaj liczbę z oczekiwaną.

Czy znak może także określać status?

Tak, przy użyciu drugiego, łańcuchowego wywołania. Znakuj i określ status w jednym żądaniu:

Dodaj logo przy 25 % krycia, a następnie dodaj znak wodny z tekstem CONFIDENTIAL do tego wyniku.

Każde wywołanie zapisuje nowy plik, więc „do tego wyniku” utrzymuje oba znaki.

Przykładowa sesja (skrócona)

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.

Iterowanie w ten sposób jest bezpieczne, ponieważ każde podejście tworzy nowy plik. Usuń odrzucone pliki później.

Który kanał dystrybucji pasuje do wdrożenia zespołowego?

W przypadku wspólnej konfiguracji obraz Docker eliminuje konieczność instalowania czegokolwiek na każdym komputerze, ponieważ środowisko uruchomieniowe i natywne zależności znajdują się w środku:

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

Kanał NuGet (dnx GroupDocs.Watermark.Mcp --yes) wymaga SDK .NET 10. Oba działają na Windows, Linux i macOS (dnx na Linux/macOS wymaga także libgdiplus), a oba używają tych samych sześciu narzędzi, więc polecenie marki nie zmienia się między nimi.

Jakie są ograniczenia?

Planuj wokół dwóch ograniczeń. Po pierwsze, narzędzie udostępnia tylko opacity i rotation: nie ma ustawień pozycji, rozmiaru ani marginesu. Po drugie, tryb ewaluacji: strona licencyjna serwera informuje, że nielicencjonowane wyjście podlega ograniczeniom ewaluacyjnym (dokładne limity znajdują się na stronie licencyjnej biblioteki), więc znakowane kopie wyprodukowane bez licencji nie mogą być rozpowszechniane. Uruchom get_license_status przed wdrożeniem marki. W modelu rozliczanym za zużycie każda przetworzona strona jest fakturowana, a przy licencji plikowej serwer działa offline. Pamiętaj także, że znak wodny etykietuje dokument; nie chroni on zawartości pod nim.

FAQ

Czy AI może dodać nasze logo firmowe do wszystkich PDF‑ów?
Tak. Poproś o logo podając nazwę pliku i podaj krycie; agent wywołuje add_image_watermark raz dla każdego pliku. To samo wywołanie działa także na plikach Word, PowerPoint, Excel i obrazach.

Czy mogę używać tego samego logo na obrazach i dokumentach?
Tak. Obrazy są prawidłowymi celami, więc znakowanie zdjęć produktów działa tak samo jak znakowanie PDF‑ów.

Co się stanie, gdy marka się zmieni?
remove_watermarks może usunąć stare logo, ponieważ zostało zastosowane jako obiekt znakowania. Jego textFilter dopasowuje tylko tekst znaków, więc usunięcie logo‑obrazu oznacza usunięcie wszystkich znaków, w tym tekstowych. Najpierw wyszukaj, aby wiedzieć, co jest obecne, a potem dodaj nowe logo.

Zagłęb się