Para editar em massa as propriedades de documentos, forneça a um agente de IA um padrão e uma pasta, e deixe-o ler, escrever e verificar através do GroupDocs.Metadata.Mcp executando localmente. Um único prompt é suficiente para começar:

Para cada documento na minha pasta, defina Company como “Acme Ltd” e Author como “Research Team”, então me informe quais arquivos você alterou.

A versão passo a passo com configuração e solução de problemas está na documentação: Como corrigir propriedades de documentos em massa com um agente de IA.

Por que os padrões de metadados se desviam em primeiro lugar?

Modelos deixam a empresa anterior em cada novo arquivo. Uma renomeação de equipe deixa o nome antigo no campo de autor. Uma migração deixa carimbos de data/hora que não fazem sentido. Ninguém edita propriedades manualmente em 200 arquivos, então o desvio permanece. Um agente com um loop é a ferramenta certa para isso, mas apenas se a edição for feita por um mecanismo: um modelo de linguagem que “reescreve” um documento para mudar seu autor regenera o conteúdo, enquanto write_metadata altera um campo e deixa o corpo intacto.

Qual é o fluxo de trabalho?

O fluxo de trabalho tem quatro etapas, e cada uma tem um prompt. Execute‑o no Claude Desktop, Claude Code, Cursor, GitHub Copilot ou qualquer outro cliente que tenha o servidor registrado.

  1. Verificar a licença. Pergunte: “Qual é o status da licença do servidor de metadados?” O agente chama get_license_status. Faça isso antes de uma execução em massa, não depois.
  2. Ler os valores atuais. Pergunte: “Primeiro liste o Author e o Company atuais para cada arquivo.” O agente chama search_metadata com nameContains, que retorna apenas as propriedades correspondentes.
  3. Escrever apenas o que está errado. Pergunte: “Altere apenas os que estão errados.” O agente chama write_metadata para cada arquivo e cada propriedade.
  4. Verificar. Pergunte: “Leia novamente o Author e o Company nos novos arquivos e liste quaisquer que ainda diferirem, com a razão.” Solicite as falhas como uma lista em vez de uma contagem.

Quem decide o quê: o agente ou o mecanismo?

Decisão Feito por
Quais arquivos estão no escopo e quais valores estão errados O agente, a partir do seu padrão
Qual nome de propriedade mapeia para qual campo em um PDF, um DOCX ou um JPEG O mecanismo: write_metadata mapeia o nome amigável por formato
Se uma propriedade existe em um formato O mecanismo: uma escrita que não se aplica relata 0 alterado ou falha com uma mensagem, nunca um sucesso silencioso
O que foi salvo e onde A ferramenta: retorna uma mensagem de caminho salvo e o número de campos alterados
Se o estado final corresponde ao padrão O agente, lendo de volta

write_metadata aceita property como um dos seguintes: Author, Title, Subject, Keywords, Comments, Copyright, Company ou Manager. mode é set (substituir, padrão) ou add (acrescentar, para campos de lista como Keywords).

Qual é a regra que mantém cada edição?

write_metadata define uma propriedade por chamada e salva um novo arquivo. Duas propriedades em um documento são duas chamadas, e a segunda deve ser aplicada ao resultado da primeira. Se a segunda chamada começar a partir do original, a primeira edição desaparece. Quando um agente relata que ambas as propriedades foram definidas e apenas uma permaneceu, esta é a razão. Declare a regra no prompt:

Aplique a segunda alteração ao arquivo produzido pela primeira, não ao original.

Sessão de exemplo (abreviada)

Você:    Defina Company como "Acme Ltd" em todos os .docx da pasta. Liste os valores atuais primeiro.
Agente:  [calls search_metadata: nameContains = "Company", per file]
Agente:  proposal-q1.docx   Company = "Contoso GmbH"   -> será alterado
        handbook.docx      Company = "Acme Ltd"       -> já está correto
        notes.docx         (no Company property)      -> será adicionado
Você:    Continue. Nomeie cada arquivo que você produziu.
Agente:  [calls write_metadata: property = Company, value = "Acme Ltd", mode = set]
Agente:  2 arquivos alterados, 1 inalterado. Cada cópia salva é nomeada na resposta da ferramenta.

Esta é uma ilustração do fluxo, não uma captura de tela.

Por que não corrigir toda a pasta em uma única passagem?

Uma gravação em massa cega pode substituir valores corretos por valores errados, portanto a etapa de leitura é a execução a seco. Ela custa uma chamada extra por arquivo. Sob licenciamento medido, cada chamada é cobrada por uso, e uma varredura de duas propriedades em 200 arquivos gera 400 chamadas de escrita além das leituras, então filtre primeiro e escreva depois.

Os formatos diferem. Uma propriedade que um formato não tem lugar é relatada como 0 alterado ou falha com uma mensagem em vez de fingir sucesso, o que é o comportamento correto, mas significa que uma pasta mista pode gerar um resultado parcial. Solicite as falhas como uma lista.

Quais são os limites no modo de avaliação?

No modo de avaliação, apenas as primeiras 5 propriedades de documento são legíveis, e XMP e EXIF estão parcialmente indisponíveis. A escrita é limitada da mesma forma. Um fluxo de trabalho “verificar, então escrever” em avaliação verifica uma lista truncada, portanto pode perder a própria propriedade que você está tentando corrigir. Confirme com get_license_status e aplique um arquivo de licença ou chaves medidas antes de confiar no resultado. Uma licença temporária gratuita de 30 dias está disponível.

Perguntas frequentes

Posso mudar o autor em 100 documentos Word de uma vez?
Sim, com um prompt que nomeia a pasta e o valor. O agente faz uma chamada write_metadata por arquivo para a propriedade Author, então 100 arquivos significam 100 chamadas de escrita.

O agente sobrescreve meus arquivos originais?
A ferramenta salva um novo arquivo e retorna seu caminho, portanto o original não é a saída. Peça ao agente para nomear cada arquivo que ele produziu e mantenha os originais até que você tenha verificado as cópias.

O agente pode definir uma propriedade personalizada que não está na lista?
Os valores de property documentados são Author, Title, Subject, Keywords, Comments, Copyright, Company e Manager. Qualquer outra coisa está fora do que a ferramenta descreve.

Aprofunde‑se