מנגנוני אג'נט

מנגנון הוא כל סביבה שבה אג’נט שלך למעשה רץ. Failproof AI תומך בשנים עשר מהם, בשתי קטגוריות:

CLI-ים לקידוד (10) — Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Factory Droid, Devin CLI, Antigravity CLI, Goose
שערי צ’אט והפניות (2) — Hermes (Slack, Telegram, cron), OpenClaw (עוזר עצמי-מארח)

אותה מדיניות ואותו היסטוריון הפעלות חלים בכל מנגנון שבו אג’נט רץ. שכבת מתאם אחת ממפה את שמות האירועים המקוריים של כל מנגנון, שמות הכלים, ושדות קלט כלים ל-29 אירועים קנוניים לפני שמדיניות כלשהי בוצעת. אג’נט שרץ באף אחד מחמשת עשר המנגנונים מכויל ישירות עם Python SDK. זה חוזה שונה, וכדאי להציג זאת בבירור: ה-SDK מעניק תיקיעת מעקב, הפעלות, הערכות וביקורות — הוא לא אוכף מדיניות בעצמו. חסימת פעולה לא בטוחה לפני שהיא בוצעת דורשת hook אכיפה בגבול הכלי של הרנטיים שלך; צור קשר איתנו ואנחנו נממפה זאת.

מנגנון	טווחי hook נתמכים
Claude Code	משתמש, פרויקט, מקומי
Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi	משתמש, פרויקט
Factory Droid, Devin CLI, Antigravity CLI, Goose	משתמש, פרויקט
Hermes, OpenClaw	משתמש

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

יכולת אכיפה

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

מנגנון	אירועי חסימה מאומתים	הערות ملاحظة בלבד או לא ממזערות
Claude Code	`PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PreCompact`, ואירועי משימה/תצורה נוספים	`PostToolUse`, מחזור חיים הפעלות, התראות, ואירועי לאחר כשל הם תצפיתיים.
Codex	`PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse`	חסימה אחרי כלי מחליפה את התוצאה אחרי ביצוע; אירועי התחלת הפעלה וקומפקט הם תצפיתיים במתאם הנוכחי.
GitHub Copilot CLI	`PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse`	חסימה אחרי כלי מחליפה את התוצאה אחרי ביצוע; אירועי הפעלות והתראות הם תצפיתיים.
Cursor	`PreToolUse`, `UserPromptSubmit`, `Stop`	`PostToolUse` ואירועי הפעלות הם תצפיתיים.
OpenCode	`PreToolUse`	אירועי אחרי כלי ומחזור חיים הם תצפיתיים; טיפול עצירה נוכחי הוא הנחיה לתור מאוחר יותר ולא שער מאומת.
Pi	`PreToolUse`, `UserPromptSubmit`	אירועי אחרי כלי ומחזור חיים הם תצפיתיים; הנחיית עצירה חלה על תור מאוחר יותר.
Hermes	`PreToolUse`	פלג-אין מקומי מעניק `instruct()` כהפסקה אחת מוגבלת וגלויה-מודל לפני שמאפשרים איטרציית API מאוחרת יותר. קביעות אחרי כלי, הפעלות וחסימת תת-אג’נט אינן שערים.
OpenClaw	`PreToolUse`, `UserPromptSubmit`, `Stop`	אירועים אחרי כלי, הפעלות, עצירה תת-אג’נט, וקומפקט הם תצפיתיים.
Factory Droid	`PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact`	קביעות אחרי כלי וחסימת תת-אג’נט הן תצפיתיות.
Devin CLI	`PreToolUse`, `UserPromptSubmit`, `Stop`, `PermissionRequest` מותנה	hook-ות הרשאה לא רצות בכל מצב הרשאה; אירועים אחרי כלי והפעלות הם תצפיתיים.
Antigravity CLI	`PreToolUse`, `Stop`	קביעות הנחיה-משתמש ואחרי כלי הן תצפיתיות; הנחיות הנחיה יכולות עדיין להיות הוזנו.
Goose	`PreToolUse`	אירועי הנחיה-משתמש, אחרי כלי והפעלות הם תצפיתיים. hook עצירה חסימה מקומי קיים במפעל אך אינו מותקן על ידי המתאם הנוכחי.

יכולות רגישות לגרסה. בדקו מחדש לאחר שדרוג CLI של אג’נט, במיוחד כאשר מדיניות מסתמכת על התנהגות הנחיה, עצירה, הרשאה או אחרי כלי במקום שער הנחיה-טרום משותף.

Hermes native plugin

Hermes משולב דרך פלג-אין מקומי מקומי-פרופיל במקום פקודת shell. ההתקנה מעתיקה את הפלג-אין לכל פרופיל Hermes ברירת מחדל ובשם, מאפשרת אותו בקובץ config.yaml של אותו פרופיל, ומהגרת רק ערכי hook shell FailproofAI מסוגיים. זה מונע ייצור תהליך בכל hook ומאפשר instruct() להגיע למודל דרך תוצאת כלי חסום מקומית של Hermes. ההנחיה ההתאמה הראשונה חוסמת את הקריאה הממתינה. אותו בקשת API נשארת חסומה; איטרציית מודל מאוחרת יותר עשויה לנסות שוב. קומץ קבע בטווח פרופיל וכובע לכל תור מונעים הנחיה יעוצה מלהיות לולאה בלתי מוגבלת. deny() נשאר חסימה קשה. הפעילו failproofai config --status כדי לגלות פרופיל מנוטרל, לא שלם, משוכפל או שנוצר מחדש.

התקן capture וhook-ות מדיניות

Dashboard
CLI

פתחו Administration → Keys וּיצרו מפתח עם events:add ו-policies:pull, בשם עבור המכונה או הסביבה.
במכונת היעד, חברו את ה-CLI המקומי עם המפתח המוצג והתקינו את hook-ות המנגנון.
התחילו הפעלה חדשה של אג’נט, ואז אשרו את ה-hook שלו ואירועי הפעלות תחת Observe → Events.
פתחו Observe → policy לאותו חלון זמן ואשרו שקביעת מדיניות מיוחסת למכונה.

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

מגירת מפתח API חדשה המשמשת להענקת הרשאות ספיגה אירוע והעברת מדיניות.

לאחר התקנת ה-hook-ות, זרימת האירועים צריכה להראות אירועים חדשים מהמכונה והסביבה שחברתם.

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

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

דף מדיניות המשמש לאימות קביעות מדיניות מחיבור חדש.

קרא את מפתח המכונה לתוך ה-shell. read -s משיגה אותו בהנחיה שלא משקפת, כך שהוא לא מופיע בפקודה או בהיסטוריון shell:

read -rs FAILPROOFAI_CLOUD_TOKEN && export FAILPROOFAI_CLOUD_TOKEN

ואז הגדרו את המכונה — זה חוטים hook-ות לכל מנגנון שנוגד, מתקין את ה-daemon, וקורא קשר לעננן:

failproofai config
failproofai policies add FailproofAI/policies

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

failproofai policies --install \
  --cli claude codex cursor \
  --scope user

טווח פרויקט שומר תצורת hook עם מאגר. טווח משתמש מכסה עבודה על פני מאגרים. Claude Code תומך גם בטווח מקומי; התמיכה משתנה לפי מנגנון וה-CLI דוחה שילובים לא נתמכים.אימתו את המכונה ואת האירועים שלה:

failproofai config --status
failproofai flush --wait
fp events --since 1h --event-type hook_triggered,hook_completed

הוסף נתיב הפעלות לא-ברירת מחדל

Dashboard
CLI

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

רשימת הפעלות סוננת לסביבה המקבלת נתונים מנתיב הלכידה הנוסף.

הוסף נתיב עם תווית אופציונלית, ואז בדוק את הנתיבים המוגדרים:

failproofai harness add-path claude checkout=/srv/checkout/.claude
failproofai harness list claude
failproofai backfill --since 7d --dry-run
failproofai backfill --since 7d

הסר נתיב עם failproofai harness remove-path claude checkout.

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

​יכולת אכיפה

​Hermes native plugin

​התקן capture וhook-ות מדיניות

​הוסף נתיב הפעלות לא-ברירת מחדל

יכולת אכיפה

Hermes native plugin

התקן capture וhook-ות מדיניות

הוסף נתיב הפעלות לא-ברירת מחדל