להמיר תיקייה במצב אצווה בעזרת סוכן AI, הפנה את שרת GroupDocs.Conversion.Mcp אל התיקייה ותאר את המשימה במשפט אחד. הסוכן עובד על הקבצים, קורא למנוע ההמרה פעם אחת לכל מסמך, ומדווח מה הוא יצר, כל זאת מקומית ב‑Claude, Cursor או GitHub Copilot. מדובר בעיבוד אצווה המונע על‑ידי משפט:

המר כל קובץ DOCX בתיקיית המסמכים שלי ל‑PDF, שמור את המקוריים

הגרסה המפורטת שלב‑אחר‑שלב עם תצורה ופתרון בעיות נמצאת בתיעוד: How to batch‑convert a folder of documents with an AI agent. פוסט זה מציג את אותה משימה כסשן קצר, מהפקודה הראשונה ועד טיפול בכשלים.

מאיפה מתחילים: תיקיית האחסון או הפקודה?

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

{
  "mcpServers": {
    "groupdocs-conversion": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Conversion.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/invoices",
        "GROUPDOCS_MCP_OUTPUT_PATH": "/path/to/invoices/converted"
      }
    }
  }
}

GROUPDOCS_MCP_STORAGE_PATH הוא התיקייה שהסוכן יכול לקרוא ממנה. GROUPDOCS_MCP_OUTPUT_PATH הוא המקום שבו נשמרים הקבצים המומרים. כאשר שני המשתנים מוגדרים, תיקיית המקור נשארת ללא שינוי וכל תוצאה נכתבת ל‑converted. זהו הסידור הנקי ביותר לאצווה. הפקודה dnx דורשת את .NET 10 SDK; תמונת Docker ghcr.io/groupdocs-conversion/conversion-net-mcp:latest מחברת את התיקייה כ‑/data. הפעל מחדש את Claude Desktop, Claude Code, VS Code או Cursor לאחר רישום השרת.

מה עושה הפקודה הראשונה?

התחל עם המקרה הפשוט:

המר את כל הקבצים בתיקייה זו מ‑DOCX ל‑PDF.

הסוכן מונה את הקבצים בתיקייה וקורא לכל קובץ את כלי convert עם format: "pdf". כל קריאה מקבלת שם קובץ מהאחסון ומחזירה את שם הקובץ השמור. הרץ זאת פעמיים, והריצה השנייה תיצור קבצים חדשים עם שמות שונים לצד הקבצים הראשונים.

איך מוסיפים מסנן או כלל?

הפקודה היא שכבת האורקסטרציה. סינון, סדר מדיניות שגיאות והכל ניתן בתיאור בשפה טבעית:

המר את כל קבצי ה‑PDF ל‑Markdown; דלג על קבצים שכבר הומרו.

המר את החשבוניות ל‑PDF/A לצורך ארכיב, ורשום כל קובץ שנכשל.

צור תצוגות PNG לכל מצגת.

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

בדוק את מספר העמודים של כל PDF תחילה, והמר רק את אלו עם יותר מ‑10 עמודים.

ההחלטה “יותר מ‑10 עמודים” היא של הסוכן. ההמרה נשארת באחריות המנוע.

מה קורה כשקובץ אחד נכשל?

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

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

דוגמת סשן

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

You:    Convert the invoices to PDF/A for archiving, and list any file that failed.
Agent:  [enumerates the invoice files]
Agent:  [calls convert for each file, one at a time]
Agent:  Converted 11 files to the output folder.
        Failed: invoice-0412.docx (password-protected, no password given).

איך לעקוב אחרי התקדמות בתיקייה גדולה?

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

מה אם האצווה חייבת לרוץ ללא השגחה?

סשן סוכן דורש אדם שמפעיל אותו. לצינורות מתוזמנים, המדריך של n8n walkthrough מציג כלי workflow שמניע את אותו השרת, והמנוע ניתן גם לתכנות דרך ספריית GroupDocs.Conversion ב‑.NET. השתמש בצ’אט לבאצ’ים אד‑הוק שבהם אתה רוצה לקרוא את הדוח.

מה המגבלות?

  • מצב הערכה מגביל אצווה ל‑15 מסמכים. ללא רישיון, תהליך שרת אחד יכול לפתוח לכל היותר 15 מסמכים והפלט יכיל סימן מים של הערכה. לאחר מכן, קריאות נוספות נכשלות עד שהשרת יאותחל מחדש. בדוק את המצב עם get_license_status לפני תחילת אצווה אמיתית, או שאל “what is the license status of the conversion server?”.
  • רישיון מבוסס מדידה דורש גישה חיצונית. עם מפתחות מדודים, השימוש מדווח לשרתים של GroupDocs, ולכן מכונה מאובטחת צריכה להשתמש בקובץ רישיון. תוכן המסמך לעולם אינו נשלח.
  • סריקות נשארות תמונות. OCR אינו חלק מהשרת, ולכן אצווה של PDF‑ים שמכילים רק תמונות לא תקבל שכבת טקסט.

שאלות נפוצות

איך ממירים את כל קבצי ה‑DOCX בתיקייה ל‑PDF בעזרת AI?
הגדר את תיקיית האחסון, ואז בקש מהסוכן לבצע זאת במשפט אחד. הוא ממיר קובץ אחרי קובץ דרך השרת המקומי ולא נשלח דבר לאינטרנט.

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

מה הדרך הטובה ביותר לאוטומציה של צינור המרת מסמכים?
השתמש בצ’אט לבאצ’ים אד‑הוק שברצונך לבדוק. לצינור שמופעל בתזמון, הניע את אותו השרת מכלי workflow כגון n8n, או כתוב סקריפט באמצעות ספריית .NET.

מידע נוסף