Para editar en masa las propiedades de los documentos, proporcione a un agente de IA un estándar y una carpeta, y permítale leer, escribir y verificar a través de GroupDocs.Metadata.Mcp ejecutándose localmente. Un solo mensaje es suficiente para comenzar:

Para cada documento en mi carpeta, establezca Company a “Acme Ltd” y Author a “Research Team”, luego indíqueme qué archivos cambió.

La versión paso a paso con configuración y solución de problemas está en la documentación: Cómo corregir propiedades de documentos en masa con un agente de IA.

¿Por qué los estándares de metadatos se desvían en primer lugar?

Las plantillas dejan la empresa anterior en cada archivo nuevo. Un cambio de nombre de equipo deja el nombre antiguo en el campo de autor. Una migración deja marcas de tiempo que no tienen sentido. Nadie edita las propiedades a mano en 200 archivos, por lo que la desviación permanece. Un agente con un bucle es la herramienta adecuada, pero solo si la edición la realiza un motor: un modelo de lenguaje que “reescribe” un documento para cambiar su autor regenera contenido, mientras que write_metadata cambia un campo y deja el cuerpo intacto.

¿Cuál es el flujo de trabajo?

El flujo de trabajo tiene cuatro pasos, y cada uno tiene un mensaje. Ejecútelo en Claude Desktop, Claude Code, Cursor, GitHub Copilot o cualquier otro cliente que tenga el servidor registrado.

  1. Verificar la licencia. Pregunte: “¿Cuál es el estado de la licencia del servidor de metadatos?” El agente llama a get_license_status. Hágalo antes de una ejecución masiva, no después.
  2. Leer los valores actuales. Pregunte: “Primero enumere el Author y Company actuales para cada archivo.” El agente llama a search_metadata con nameContains, que devuelve solo las propiedades coincidentes.
  3. Escribir solo lo que está incorrecto. Pregunte: “Cambie solo los que están mal.” El agente llama a write_metadata para cada archivo y cada propiedad.
  4. Verificar. Pregunte: “Lea nuevamente el Author y Company en los archivos nuevos y enumere los que aún difieren, con la razón.” Pida los fallos como una lista en lugar de un recuento.

¿Quién decide qué: el agente o el motor?

Decisión Realizado por
Qué archivos están dentro del alcance y qué valores están incorrectos El agente, a partir de su estándar
Qué nombre de propiedad se asigna a qué campo en un PDF, un DOCX o un JPEG El motor: write_metadata asigna el nombre amigable por formato
Si una propiedad existe en un formato El motor: una escritura que no se aplica informa 0 cambiados o falla con un mensaje, nunca un éxito silencioso
Qué se guardó y dónde La herramienta: devuelve un mensaje con la ruta guardada y el número de campos cambiados
Si el estado final coincide con el estándar El agente, leyendo de nuevo

write_metadata acepta property como uno de Author, Title, Subject, Keywords, Comments, Copyright, Company o Manager. mode es set (reemplazar, por defecto) o add (añadir, para campos de lista como Keywords).

¿Cuál es la regla que mantiene cada edición?

write_metadata establece una propiedad por llamada y guarda un archivo nuevo. Dos propiedades en un documento son dos llamadas, y la segunda debe aplicarse al resultado de la primera. Si la segunda llamada parte del original, la primera edición desaparece. Cuando un agente informa que ambas propiedades están establecidas y solo una se mantuvo, esta es la razón. Declare la regla en el mensaje:

Aplique el segundo cambio al archivo producido por el primero, no al original.

Sesión de ejemplo (abreviada)

You:    Set Company to "Acme Ltd" on every .docx in the folder. List current values first.
Agent:  [calls search_metadata: nameContains = "Company", per file]
Agent:  proposal-q1.docx   Company = "Contoso GmbH"   -> will change
        handbook.docx      Company = "Acme Ltd"       -> already correct
        notes.docx         (no Company property)      -> will add
You:    Go ahead. Name each file you produced.
Agent:  [calls write_metadata: property = Company, value = "Acme Ltd", mode = set]
Agent:  2 files changed, 1 unchanged. Each saved copy is named in the tool reply.

Esta es una ilustración del flujo, no una captura de pantalla.

¿Por qué no corregir toda la carpeta en una sola pasada?

Una escritura masiva ciega puede reemplazar valores correctos por peores, por lo que el paso de lectura es la ejecución en seco. Cuesta una llamada extra por archivo. Bajo licenciamiento medido cada llamada se factura, y una revisión de dos propiedades sobre 200 archivos implica 400 llamadas de escritura más las lecturas, así que filtre primero y escriba después.

Los formatos difieren. Una propiedad que un formato no tiene lugar se informa como 0 cambiados o falla con un mensaje en lugar de fingir éxito, lo cual es el comportamiento correcto pero significa que una carpeta mixta puede dar un resultado parcial. Pida los fallos como una lista.

¿Cuáles son los límites en modo de evaluación?

En modo de evaluación solo se pueden leer las primeras 5 propiedades de documento, y XMP y EXIF están parcialmente indisponibles. La escritura está limitada de la misma manera. Un flujo de trabajo de “verificar, luego escribir” bajo evaluación verifica una lista truncada, por lo que puede pasar por alto la propiedad que está intentando corregir. Confirme con get_license_status y aplique un archivo de licencia o claves medidas antes de confiar en el resultado. Hay una licencia temporal gratuita de 30 días disponible.

Preguntas frecuentes

¿Puedo cambiar el autor en 100 documentos de Word a la vez?
Sí, con un mensaje que nombre la carpeta y el valor. El agente realiza una llamada write_metadata por archivo para la propiedad Author, por lo que 100 archivos significan 100 llamadas de escritura.

¿El agente sobrescribe mis archivos originales?
La herramienta guarda un archivo nuevo y devuelve su ruta, por lo que el original no es la salida. Pida al agente que nombre cada archivo que produce y conserve los originales hasta que haya verificado las copias.

¿Puede el agente establecer una propiedad personalizada que no esté en la lista?
Los valores de property documentados son Author, Title, Subject, Keywords, Comments, Copyright, Company y Manager. Cualquier otro está fuera de lo que la herramienta describe.

Profundizar