Você pode aplicar marca d’água a uma pasta de documentos com um único prompt: um agente de IA lista os arquivos, chama a ferramenta de marca d’água uma vez por arquivo e relata o que produziu, tudo localmente sem uploads. No Claude Desktop, Claude Code, Cursor ou Windsurf a solicitação é:

Adicione uma marca d’água diagonal RASCUNHO a todos os PDFs da minha pasta de documentos, então liste os arquivos que você produziu.

A versão passo a passo com configuração e solução de problemas está na documentação: Como aplicar marca d’água em lote a uma pasta de documentos com um agente de IA.

Por que carimbar por estágio do ciclo de vida em vez de uma única vez?

Um pacote de proposta raramente é marcado apenas uma vez. Ele começa como RASCUNHO, torna‑se PARA REVISÃO quando vai para um colega e perde a marca quando é aprovado. Fazer isso manualmente em trinta arquivos é o tipo de trabalho que se deixa de lado sob pressão de prazo. Com o GroupDocs.Watermark.Mcp cada estágio é uma frase, e o agente fornece o loop que você escreveria como um script. O mecanismo cuida do formato, de modo que o mesmo prompt cobre PDF, Word, Excel, PowerPoint e arquivos de imagem em uma única pasta.

Etapa 1: Como adicionar uma marca d’água de rascunho a todos os arquivos?

Aponte GROUPDOCS_MCP_STORAGE_PATH para a pasta. Os arquivos são resolvidos pelo nome, portanto o agente passa proposal-01.pdf, não um caminho da sua máquina. Em seguida:

Adicione uma marca d’água diagonal RASCUNHO a todos os PDFs da minha pasta de documentos, então liste os arquivos que você produziu.

O agente chama add_watermark por arquivo. Cada chamada salva uma nova cópia com marca d’água e deixa o original no lugar, de modo que a pasta de origem continua sendo seu registro das versões sem marca.

Etapa 2: Como mudar para um carimbo de revisão?

Após a Etapa 1 cada arquivo contém RASCUNHO, então troque a marca: remova a antiga por texto e, em seguida, aplique a nova.

Remova a marca d’água RASCUNHO de todos os arquivos nesta pasta, então adicione uma marca d’água PARA REVISÃO a cada resultado.

O agente chama remove_watermarks com textFilter definido como RASCUNHO, depois add_watermark em cada cópia limpa. Para uma pasta em estado misto, onde alguns arquivos já estão marcados e outros não, peça ao agente para verificar primeiro:

Marque cada arquivo PARA REVISÃO, exceto aqueles que já têm uma marca d’água.

Ele executa search_watermarks em cada arquivo e ignora os que retornam uma marca. Para uma marca diferente por formato, indique assim:

Coloque o logotipo nos decks de slides e uma marca de texto nos PDFs.

Etapa 3: Como limpar as marcas quando o trabalho é aprovado?

A aprovação inverte a necessidade. Na mesma pasta, com seus próprios documentos:

Remova a marca d’água RASCUNHO de todos os arquivos nesta pasta e mantenha o restante das marcas.

Isso corresponde a remove_watermarks com um textFilter de “RASCUNHO”. O filtro é uma correspondência de substring sem distinção entre maiúsculas e minúsculas; sem ele, toda marca d’água que o mecanismo puder identificar será removida. Os resultados são salvos como <nome>_unwatermarked.<ext>. Os detalhes estão no post complementar sobre busca antes de remover, linkado abaixo.

Sessão de exemplo (abreviada)

Você:    Adicione uma marca d'água diagonal RASCUNHO a todos os PDFs da minha pasta de documentos,
        então liste os arquivos que você produziu.
Agente:  [add_watermark x 3: text "RASCUNHO", rotation -45]
        Marca d'água de texto "RASCUNHO" adicionada a "proposal-01.pdf"
        Marca d'água de texto "RASCUNHO" adicionada a "proposal-02.pdf"
        Marca d'água de texto "RASCUNHO" adicionada a "proposal-03.pdf"
        Produzidas 3 cópias com marca d'água. 0 falhas.
        Os originais permanecem inalterados.

E os originais e a pasta de saída?

Por padrão, entrada e saída compartilham a mesma pasta, de modo que as cópias com marca d’água ficam ao lado de suas fontes. Se preferir uma separação limpa, defina GROUPDOCS_MCP_OUTPUT_PATH para uma pasta distinta e envie a partir dela. De qualquer forma, os originais nunca são sobrescritos, permitindo que você reexecute uma etapa após uma alteração no arquivo fonte; basta nomear novamente os arquivos que deseja processar.

Como manter um lote honesto?

  • Peça a lista de arquivos produzidos. Uma execução que relata apenas “concluído” deixa você adivinhando quais cópias enviar.
  • Peça falhas explicitamente. Uma pasta mista pode conter um formato que o mecanismo não consegue marcar. A chamada falha com uma mensagem em vez de pular silenciosamente, portanto solicite a lista de falhas.
  • Fique atento ao uso medido. Sob licenciamento medido cada arquivo é cobrado como processamento.
  • Verifique a licença primeiro. Um lote em modo de avaliação é uma execução desperdiçada.

Quais são os limites?

O modo de avaliação é o principal limitador: a página de licenciamento do servidor indica que a saída não licenciada tem limitações de avaliação; os limites exatos estão na página de licenciamento da biblioteca. Uma pasta de cópias em modo de avaliação é uma pasta de rascunhos que você não pode distribuir. Peça ao agente para chamar get_license_status antes da execução; ele reporta mode como evaluation, licensed ou metered. Também não há agendador interno: o servidor age quando seu agente solicita, portanto um trabalho recorrente precisa de um cliente ou de um executor de tarefas que envie o prompt.

Perguntas Frequentes

A IA pode aplicar marca d’água a vários PDFs de uma vez?
Sim. O agente itera a pasta e chama add_watermark uma vez por arquivo, depois lista as cópias que produziu. Cada arquivo é processado separadamente.

Posso adicionar CONFIDENCIAL a todos os documentos de uma pasta?
Sim. Substitua RASCUNHO por CONFIDENCIAL no prompt. Especifique se os arquivos que já contêm uma marca devem ser ignorados.

É possível fazer marca d’água em lote localmente, sem upload?
Sim. O servidor é um processo local iniciado pelo seu cliente, e ele lê e grava na pasta que você configurou.

Aprofunde-se