ドキュメントのプロパティを一括編集するには、AI エージェントに標準とフォルダーを渡し、ローカルで実行されている GroupDocs.Metadata.Mcp を介して読み取り、書き込み、検証させます。開始には 1 つのプロンプトで十分です:

フォルダー内のすべてのドキュメントについて、Company を「Acme Ltd」に、Author を「Research Team」に設定し、変更したファイルを教えてください。

設定とトラブルシューティングを含むステップバイステップ版はドキュメントにあります: AI エージェントでドキュメントプロパティを一括修正する方法.

メタデータ標準が最初にドリフトする理由は？

テンプレートは新しいファイルごとに前の会社名を残します。チーム名の変更は author フィールドに古い名前を残します。移行は意味のないタイムスタンプを残します。200 ファイルにわたって手作業でプロパティを編集する人はいないので、ドリフトが残ります。ループを持つエージェントはそれに適したツールですが、編集がエンジンによって行われる場合に限ります。author を変更するためにドキュメントを「書き換える」言語モデルはコンテンツを再生成しますが、write_metadata はフィールドだけを変更し、本文はそのままにします。

ワークフローは何ですか？

ワークフローは 4 つのステップで構成され、各ステップに 1 つのプロンプトがあります。Claude Desktop、Claude Code、Cursor、GitHub Copilot、またはサーバーが登録されている任意のクライアントで実行してください。

  1. ライセンスを確認する。 「metadata サーバーのライセンスステータスは何ですか？」と尋ねます。エージェントは get_license_status を呼び出します。バルク実行の前に行い、後ではありません。
  2. 現在の値を読み取る。 「まず各ファイルの現在の Author と Company を一覧表示してください。」と尋ねます。エージェントは nameContains を指定して search_metadata を呼び出し、一致するプロパティだけを返します。
  3. 間違っているものだけを書き込む。 「間違っているものだけを変更してください。」と尋ねます。エージェントは各ファイルと各プロパティに対して write_metadata を呼び出します。
  4. 検証する。 「新しいファイルで Author と Company を再度読み取り、まだ違うものがあれば理由とともに一覧してください。」と尋ねます。失敗はカウントではなくリストで求めます。

誰が何を決定するか: エージェントかエンジンか？

Decision Made by
対象となるファイルはどれか、どの値が間違っているか エージェント（標準に基づく）
PDF、DOCX、JPEG のどのフィールドにどのプロパティ名がマップされるか エンジン：write_metadata がフォーマットごとにフレンドリーネームをマップします
フォーマットにプロパティが存在するか エンジン：適用できない書き込みは 0 変更と報告するか、メッセージで失敗し、サイレント成功はありません
何がどこに保存されたか ツール：保存されたパスのメッセージと変更されたフィールド数を返します
最終状態が標準に合致しているか エージェントが再読して判断

write_metadata は property として Author、Title、Subject、Keywords、Comments、Copyright、Company、または Manager のいずれかを受け取ります。mode は set（置換、デフォルト）または add（追加、Keywords のようなリストフィールド用）です。

すべての編集を保つルールは何ですか？

write_metadata は 1 回の呼び出しで 1 つのプロパティを設定し、新しいファイルを保存します。1 つのドキュメントに対して 2 つのプロパティを変更する場合は 2 回の呼び出しが必要で、2 回目は 1 回目の結果に対して適用しなければなりません。2 回目が元のファイルから始まると、最初の編集が消えてしまいます。エージェントが両方のプロパティが設定されたと報告し、1 つだけが残った場合はこの理由です。プロンプトでルールを明示してください:

2 回目の変更は元のファイルではなく、1 回目で生成されたファイルに適用してください。

例示セッション（抜粋）

You:    フォルダー内のすべての .docx の Company を「Acme Ltd」に設定してください。まず現在の値を一覧表示してください。
Agent:  [calls search_metadata: nameContains = "Company", per file]
Agent:  proposal-q1.docx   Company = "Contoso GmbH"   -> 変更予定
        handbook.docx      Company = "Acme Ltd"       -> すでに正しい
        notes.docx         (Company プロパティなし)      -> 追加予定
You:    続行してください。生成した各ファイルの名前を教えてください。
Agent:  [calls write_metadata: property = Company, value = "Acme Ltd", mode = set]
Agent:  2 ファイルが変更され、1 ファイルは変更されませんでした。各保存されたコピーはツールの応答で名前が付けられます。

これはフローの例示であり、取得したスクリーンショットではありません。

なぜフォルダー全体を一度に修正しないのか？

盲目的な一括書き込みは良好な値を劣ったものに置き換える可能性があるため、読み取りステップはドライランとして機能します。ファイルごとに 1 回の余分な呼び出しがかかります。従量課金ライセンスではすべての呼び出しが使用量として課金され、200 ファイルに対する 2 つのプロパティのスイープは 400 回の書き込み呼び出しに加えて読み取りが必要になるため、最初にフィルタリングし、次に書き込みます。

フォーマットは異なります。フォーマットに場所がないプロパティは、成功したふりをせずに 0 変更と報告されるか、メッセージで失敗します。これは正しい動作ですが、混在したフォルダーでは部分的な結果になる可能性があります。失敗はリストで求めてください。

評価モードの制限は何ですか？

評価モードでは最初の 5 つのドキュメントプロパティのみが読み取れ、XMP と EXIF は一部利用できません。書き込みも同様に制限されます。評価モードでの「チェックしてから書き込み」ワークフローは短縮されたリストをチェックするため、修正しようとしているプロパティを見逃す可能性があります。get_license_status で確認し、結果に依存する前にライセンスファイルまたは従量課金キーを適用してください。30 日間の無料一時ライセンスが利用可能です。

よくある質問

100 個の Word ドキュメントの author を一度に変更できますか？
はい、フォルダーと値を指定したプロンプトで可能です。エージェントは Author プロパティについてファイルごとに 1 回の write_metadata 呼び出しを行うので、100 ファイルで 100 回の書き込み呼び出しになります。

エージェントは元のファイルを上書きしますか？
ツールは新しいファイルを保存し、そのパスを返すため、元のファイルは出力されません。エージェントに生成した各ファイルの名前を尋ね、コピーを検証するまで元のファイルを保持してください。

リストにないカスタムプロパティをエージェントが設定できますか？
ドキュメントで定義されている property の値は Author、Title、Subject、Keywords、Comments、Copyright、Company、Manager です。それ以外はツールの説明範囲外です。

さらに深掘り