סוכן AI צריך לשאול מסמך שלושה דברים לפני שהוא מציג דף יחיד: כמה דפים יש לו, מה גודל כל דף, והאם הוא דורש סיסמה. שרת GroupDocs.Viewer.Mcp משיב על שני הראשונים בקריאה זולה אחת (get_view_info), שמופעלת מקומית במחשב שלך, ושאלת הסיסמה נפתרת בתיאור ההנחיה. לאחר מכן הסוכן מציג רק את הדפים החשובים:

מהו הקובץ contract.docx — כמה דפים, ומה גודל הדף?

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

למה לבדוק קודם?

כל דף שהכלי render_page מייצר חוזר לסוכן כתמונה PNG משולבת, לרוב כמה מאות קילובייטים. סוכן שמציג קובץ של 60 דפים כדי למצוא טבלה אחת משלם עבור 59 תמונות שלא נזקקו, בזמן ובחלון ההקשר. כלי הבדיקה, get_view_info, אינו מציג דבר. הוא מחזיר אובייקט JSON קטן, ולכן ההחלטה מה להציג מתבססת על עובדות ולא על ניחושים.

הדפוס ניתן לשימוש חוזר בכל לקוח: Claude Desktop, Claude Code, Cursor, VS Code עם GitHub Copilot או Windsurf. זהו הרגל שאתה משלב בתיאור ההנחיה, ולא תכונה שאתה מגדיר.

שאלה 1: כמה דפים יש?

get_view_info מחזיר pageCount. זהו ההגנה היחידה נגד קצה חד מתועד: render_page אינו בודק את מספר הדף מול המסמך. אם תבקש דף 40 בקובץ של 12 דפים, עדיין תקבל תמונה, שנשמרת כ‑<name>_page40.png, של דף שאינו דף 40.

תיאור הנחיה שמבנה את ההגנה:

כמה דפים יש לדוח? ואז הצג לי את האחרון.

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

שאלה 2: מה הגודל של כל דף?

מהו הגודל של הדפים ב‑PDF הזה — Letter או A4?

התגובה מציינת number, width ו‑height עבור כל דף, בנקודות. 612 על 792 הוא US Letter; כ‑595 על 842 הוא A4. מסמך עם דף אחד במצב אופקי בין דפים אנכיים מציג זאת בגודלים, ולעיתים הדף הזה הוא הטבלה או הציור שמישהו שואל עליו.

שני שדות נוספים, name ו‑visible, מתמלאים כאשר הפורמט כולל אותם, לדוגמה שמות גיליונות ושקופיות או גיליונות מוסתרים. אחרת הם null ו‑true.

שאלה 3: האם הקובץ דורש סיסמה?

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

הסיסמה לקובץ contract.pdf נמצאת בהודעה שלי. בדוק כמה דפים יש לו, ואז הצג לי את דף 2.

ללא הסיסמה הקריאה נכשלת, והסוכן יכול לבקש ממך אותה במקום לנחש. אם הקריאה נכשלת, get_view_info מחזיר טקסט שמתחיל ב‑View-info lookup failed for ולאחריו סוג החריגה וההודעה, כך שהסוכן יכול לקרוא את הסיבה ולבקש את הסיסמה או את שם הקובץ הנכון.

תיאור הנחיה חוזר לשימוש של בדיקה-ואחר-הצגה

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

הסוכן קורא get_view_info, מדווח על סוג הקובץ וספירת הדפים, בוחר דפים, וקורא render_page עבור כל אחד. הכלי get_license_status הוא הכלי השלישי בשרת; השתמש בו כשצריך לדעת האם הדפים המוצגים יסומנו במים.

דוגמת שיחה

אילוסטרציה המבוססת על צורת התגובה המתועדת, ולא על צילום מסך מתועד.

אתה:   בדוק את report.pdf לפני הצגת כל דבר.

סוכן: [קורא get_view_info על report.pdf]
       report.pdf: קובץ פורמט מסמך נייד (.pdf), 2 דפים.
       דף 1: 612 על 792 נקודות (US Letter). דף 2: 612 על 792 נקודות.
       איזה דף תרצה שאציג?

מה הסוכן מחליט, ומה המנוע עושה?

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

מגבלות כנות

  • מצב הערכה. דפים מוצגים נושאים סימן מים של הערכה ותהליך השרת פותח לכל היותר 15 מסמכים. שאל “האם שרת הצופה מורשה?” כך שהסוכן יקרא get_license_status לפני שאתה סומך על הפלט.
  • ספירת הדפים אינה בוחרת דפים עבורך. get_view_info מציין אילו דפים קיימים, לא איזה דף מכיל את התשובה. לשם כך, הצג דף תוכן או כמה מועמדים.
  • PNG בלבד. אין אפשרות בחירת פורמט ב‑render_page.

שאלות נפוצות

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

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

האם בדיקת מסמך מעלה אותו לשום מקום? לא. השרת קורא את הקובץ מהתיקייה שאתה מגדיר ומחזיר אובייקט JSON קטן ללקוח שלך.

צלילה עמוקה