כדי לערוך באופן גורף מאפייני מסמכים, ספקו לסוכן AI תקן ותיקייה, ותנו לו לקרוא, לכתוב ולאמת דרך GroupDocs.Metadata.Mcp הפועל מקומית. פקודה אחת מספיקה כדי להתחיל:

לכל מסמך בתיקייה שלי, הגדר Company ל‑“Acme Ltd” ו‑Author ל‑“Research Team”, ואז הודע לי אילו קבצים שינית.

הגרסה הצעד‑אחר‑צעד עם תצורה ופתרון בעיות נמצאת בתיעוד: איך לתקן מאפייני מסמך באופן גורף עם סוכן AI.

למה תקני המטא‑דטה מתרחקים מלכתחילה?

תבניות משאירות את החברה הקודמת בכל קובץ חדש. שינוי שם צוות משאיר את השם הישן בשדה המחבר. הגירה משאירה חותמות זמן שאין להן משמעות. אף אחד לא ערוך מאפיינים ידנית ב‑200 קבצים, ולכן הסטייה נשארת. סוכן עם לולאה הוא הכלי המתאים לכך, אך רק אם העריכה מתבצעת על‑ידי מנוע: מודל שפה שמ “כותב מחדש” מסמך כדי לשנות את המחבר מייצר תוכן מחדש, בעוד write_metadata משנה שדה אחד ומשאיר את הגוף ללא שינוי.

מהו זרימת העבודה?

לזרימת העבודה יש ארבעה שלבים, ולכל אחד יש פקודה אחת. הריצו זאת ב‑Claude Desktop, Claude Code, Cursor, GitHub Copilot או כל לקוח אחר שבו השרת רשום.

  1. בדיקת הרישיון. שאלו: “מהו מצב הרישיון של שרת המטא‑דטה?” הסוכן קורא get_license_status. עשו זאת לפני ריצה גורפת, ולא אחרי.
  2. קריאת הערכים הנוכחיים. שאלו: “ראשית רשמו את ה‑Author וה‑Company הנוכחיים עבור כל קובץ.” הסוכן קורא search_metadata עם nameContains, שמחזיר רק את המאפיינים המתאימים.
  3. כתיבה רק של מה שגוי. שאלו: “שנו רק את אלו שהן שגויות.” הסוכן קורא write_metadata עבור כל קובץ וכל מאפיין.
  4. אימות. שאלו: “קראו שוב את ה‑Author וה‑Company בקבצים החדשים ורשמו כל קובץ שעדיין שונה, עם הסיבה.” בקשו את הכשלונות כרשימה ולא כמספר.

מי מחליט מה: הסוכן או המנוע?

החלטה מי עושה
אילו קבצים נכללים בטווח, ואילו ערכים שגויים הסוכן, לפי הסטנדרט שלך
איזה שם מאפיין ממופה לאיזה שדה ב‑PDF, DOCX או JPEG המנוע: write_metadata ממפה את השם הידידותי לפי פורמט
האם מאפיין קיים בפורמט המנוע: כתיבה שלא מתבצעת מדווחת 0 שינויים או נכשלת עם הודעה, לעולם לא הצלחה שקטה
מה נשמר והיכן הכלי: מחזיר הודעת נתיב שמור ואת מספר השדות ששונו
האם המצב הסופי תואם לסטנדרט הסוכן, על‑ידי קריאה חוזרת

write_metadata מקבל property כאחד מהבאים: Author, Title, Subject, Keywords, Comments, Copyright, Company או Manager. mode הוא set (החלפה, ברירת המחדל) או add (הוספה, עבור שדות רשימה כגון Keywords).

מהו הכלל ששומר על כל עריכה?

write_metadata מגדיר מאפיין אחד לכל קריאה ושומר קובץ חדש. שני מאפיינים במסמך אחד הם שתי קריאות, והשנייה חייבת להיות מיושמת על תוצאת הראשונה. אם הקריאה השנייה מתחילה מהמקור, העריכה הראשונה נעלמת. כאשר סוכן מדווח ששני המאפיינים הוגדרו ורק אחד נשאר, זו הסיבה. הציגו את הכלל בפקודה:

החילו את השינוי השני על הקובץ שנוצר על‑ידי הראשון, ולא על המקור.

דוגמת שיחה (מקוצרת)

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.

זוהי המחשה של הזרימה, לא צילום מסך מתועד.

למה לא לתקן את כל התיקייה במעבר אחד?

כתיבה גורפת עיוורת יכולה להחליף ערכים נכונים בערכים גרועים יותר, ולכן שלב הקריאה הוא ריצה יבשית. זה עולה קריאה נוספת לכל קובץ. תחת רישיון מדוד כל קריאה מחויבת, וסריקה של שני מאפיינים על 200 קבצים היא 400 קריאות כתיבה בנוסף לקריאות, ולכן יש לסנן תחילה ולכתוב לאחר מכן.

הפורמטים שונים. מאפיין של פורמט שאין לו מקום עבורו מדווח כ‑0 שינויים או נכשל עם הודעה במקום להעמיד פנים של הצלחה, וזה ההתנהגות הנכונה אך משמעותה שתיקייה מעורבת יכולה לתת תוצאה חלקית. בקשו את הכשלונות כרשימה.

מהם המגבלות במצב הערכה?

במצב הערכה רק חמשת המאפיינים הראשונים של המסמך ניתנים לקריאה, ו‑XMP ו‑EXIF חלקית לא זמינים. הכתיבה מוגבלת באותו אופן. זרימת עבודה של “בדיקה, ואז כתיבה” במצב הערכה בודקת רשימה מקוצרת, ולכן היא יכולה לפספס את המאפיין שאתה מנסה לתקן. אשרו עם get_license_status והחילו קובץ רישיון או מפתחות מדודים לפני שאתם סומכים על התוצאה. רישיון זמני חינמי ל‑30 יום זמין.

שאלות נפוצות

האם אני יכול לשנות את המחבר ב‑100 מסמכי Word בבת אחת?
כן, עם פקודה שמציינת את התיקייה והערך. הסוכן מבצע קריאת write_metadata אחת לכל קובץ עבור מאפיין ה‑Author, ולכן 100 קבצים משמעותם 100 קריאות כתיבה.

האם הסוכן מחליף את הקבצים המקוריים שלי?
הכלי שומר קובץ חדש ומחזיר את הנתיב שלו, ולכן המקור אינו הפלט. בקשו מהסוכן לשנות את שם כל קובץ שהוא ייצר, ושמרו את המקוריים עד שתאמתו את העותקים.

האם הסוכן יכול להגדיר מאפיין מותאם אישית שלא נמצא ברשימה?
הערכים המתועדים של property הם Author, Title, Subject, Keywords, Comments, Copyright, Company ו‑Manager. כל דבר אחר נמצא מחוץ למה שהכלי מתאר.

להעמיק יותר