מה אתה מקבל כשאתה מחלץ הערות מקובץ PDF?

מסמך מסומן הוא גם נתונים וגם דיו. כלי get_annotations מחזיר אובייקט JSON עם found, המספר, ו‑annotations, מערך. כל ערך מכיל את id של ההערה, type, message, page (מתחיל ב‑1), תיבת הגבול, user וכל replies. אין כאן ניתוח מסמך ולא OCR, ולכן הסוכן פועל ישירות מרשומות ההערות.

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

דרך 1: בקש סיכום

קריאה אחת, ואז ניתוח. ציין את הקובץ והסבר עבור מה הסיכום.

סכם את הסקירה של contract_annotated.pdf: כמה הערות, מאת מי, ומהן הנושאים המרכזיים.

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

דרך 2: בקש טבלה או רשימה מסוננת

מאחר שהנתונים מובנים, צורת הדוח תלויה בפרומפט:

תן לי טבלה: עמוד, מחבר, הערה, נענה כן/לא.

קבץ את ההערות לפי מבקר ותגיד לי למי יש הכי הרבה פריטים פתוחים.

רשום רק את הקוויים. אני רוצה לראות מה אנשים רוצים להסיר.

אילו עמודים אין עליהם שום הערה בכלל?

השאלה האחרונה היא כזו שמקריאת PDF רגילה מתמודדת איתה בחוסר דיוק, אך מערך יכול לענות ישירות: “answered” הוא רשימת replies שאינה ריקה, ו‑“pages without comments” הם מספרי העמודים החסרים בערכי page. ניתן לשלב זאת עם get_document_info לקבלת מספר העמודים הכולל.

דרך 3: ארכיב את ההערות כ‑XML

ייצא את ההערות כדי שנוכל לשמור אותן עם תיק התיק.

export_annotations כותב קובץ XML שמכיל רק את ההערות. הודעת ההצלחה שלו נראית כך: Exported N annotation(s) from <file> to <name>.annotations.xml. הקובץ קטן וניתן לבצע עליו diff, ו‑import_annotations יכול לטעון אותו לעותק אחר של המסמך. זה מועיל כאשר המסמך נמצא תחת כלל שמירת נתונים שההערות אינן חלק ממנו, או כאשר רוצים להשוות שני שלבי סקירה: שני ייצוא של אותו מסמך הם שני קבצי טקסט, והסוכן יכול לתאר מה השתנה ביניהם.

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

זוהי המחשה שנבנתה מהתנהגות מתועדת של הכלים, ולא צילום מסך.

You:   Summarize the review of contract_annotated.pdf and group it by reviewer.

Agent: [calls get_annotations on contract_annotated.pdf]
       Found 5 annotations: 4 from Maria, 1 from Dana.
       Maria: payment terms (page 2), delivery date (page 5),
         liability cap (page 6), a missing signature block (page 6).
       Replies: Alex answered the page 2 payment terms comment.
       Dana: a strikeout on page 4 marking an outdated clause.
       Maria comments without a reply: page 5 and the two on page 6.

האם הסוכן יכול לפעול על ההערות?

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

איך מריצים את השרת עבור Claude, Cursor או Copilot?

השרת פועל מתמונת Docker ghcr.io/groupdocs-annotation/annotation-net-mcp או מ‑NuGet עם dnx GroupDocs.Annotation.Mcp --yes (.NET 10 SDK), ומציב את התיקייה שמכילה את המסמכים שלך. דף המרכז מציג את הרישום עבור Claude Desktop, Claude Code, VS Code עם GitHub Copilot, Cursor, Windsurf ולקוחות נוספים.

מגבלות כנות

  • Evaluation mode. חותמת ניסיון מודבקת בראש כל עמוד. היא אינה משנה את נתוני ההערות, ולכן דוחות שנבנים כך מדויקים גם ללא רישיון. היא משפיעה על מה שניתן לשלוח הלאה. אם התוכנית מסתיימת ב‑“email the marked‑up copy”, בדוק תחילה get_license_status.
  • One document per call. סריקה של קבצים רבים דורשת קריאות רבות, וכל אחת מהן היא קריאת כלי שהסוכן צריך לבצע ולדווח עליה.
  • Export is XML. get_annotations מחזיר JSON עבור הסוכן לקריאה; export_annotations כותב XML לאחסון.
  • No preview needed. אף אחת משלוש השיטות אינה מציגה עמוד, ולכן מגבלת תצוגת PDF של generate_pages_preview בלינוקס אינה חלה עליהן.

שאלות נפוצות

איך אני מייצא את כל ההערות מקובץ PDF? בקש מהסוכן לייצא את ההערות. הוא קורא export_annotations, שכותב קובץ XML לצד המסמכים שלך, או קורא get_annotations אם אתה רוצה שההערות יופיעו בצ’אט.

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

האם הדוח משתנה אם אין לי רישיון? נתוני ההערות אינם משתנים. רק העמודים המוצגים או הנשמרים נושאים חותמת ניסיון.

העמק יותר