Agent Harness (מעטפת סוכן)

מה זה מעטפת סוכן: ההגדרה הרשמית של Claude Code

התיעוד הרשמי של Claude Code מגדיר Agentic Harness (באתר זה: מעטפת סוכן) כ"הכלים, ניהול ההקשר וסביבת הביצוע שהופכים מודל שפה לסוכן קידוד מוכשר" — ומבהיר את חלוקת התפקידים במפורש: Claude Code היא המעטפת, ו-Claude הוא המודל שבתוכה. לפי אותה הגדרה, המעטפת היא שמספקת גישה לקבצים, הרצת פקודות טרמינל (shell), בקרת הרשאות, טעינת זיכרון, ואת הלולאה שמחברת פעולה לפעולה. ניסוח פשוט יותר מביאה חברת Nimbus בבלוג שלה, בשם התיעוד של LangChain: "סוכן = מודל + מעטפת" — המודל מספק את ההסקה וההיגיון, והמעטפת היא התוכנה שהופכת את ניבוי המילה הבאה לעבודה של ממש.

לולאת הסוכן, ומה מתחבר אליה

הגלוסרי הרשמי של Claude Code מגדיר בנפרד גם Agentic Loop (לולאת סוכן): "המעגל ש-Claude עובר בו בכל משימה: איסוף הקשר, ביצוע פעולה, אימות תוצאות, וחזרה על כך עד שהמשימה נגמרת". כל קריאה לכלי מחזירה מידע שמעצב את הצעד הבא, ואפשר להפריע ללולאה בכל שלב כדי לכוון אותה מחדש. לפי אותו גלוסרי, רוב נקודות ההרחבה של Claude Code — ובהן Hooks, מיומנויות (Skills) ו-MCP — מתחברות לשלבים ספציפיים בתוך הלולאה הזו, ולא מחליפות אותה. המעטפת היא מה שמגדיר ומריץ את הלולאה; הרחבות כמו אלה הן תוספות שמתערבות בשלב מסוים שלה, בלי לשנות את המבנה הבסיסי. מושג סמוך בגלוסרי, "תור" (Turn), מתאר את אותה לולאה מזווית משלימה. תור הוא תגובה שלמה אחת של Claude בתוך שיחה (Session): הוא מתחיל כשהמשתמש שולח הודעה ומסתיים כש-Claude מסיים לענות, וביניהם יכולות להיות קריאות לכלים, כמה שיידרש. שיחה שלמה מורכבת מתורות רבים, ולולאת הסוכן היא בדיוק התיאור של מה שקורה בתוך תור בודד.

ממה היא מורכבת בפועל: כלים, בקרה, הקשר והרשאות

חברת הניטור Arize מגדירה "הנדסת מעטפת" כתחום העוסק בבנייה ובתחזוקה של המעטפת, ומפרקת אותה לרכיבים חוזרים. כלים: שם, תיאור, סכמת פרמטרים, אימות (Validation), תקציב זמן, ומה מוחזר כשכלי נכשל — כולל ההבנה שתיאור כלי הוא בעצם סוג של פרומפט בפני עצמו. לולאה ובקרה: תקרת צעדים, תקציב טוקנים, מגבלת זמן, זיהוי לולאות, וכלל שמחליט שהמשימה נגמרה — בלעדיהם סוכן מבולבל יכול להמשיך לצרוך תקציב בלי סוף. ניהול הקשר: מה בדיוק המודל רואה בכל צעד — הוראות מערכת, החלק הרלוונטי בשיחה — ולפי Arize, כאן מתחילות רוב בעיות האיכות של סוכן. הרשאות: מה נשמר בין צעד לצעד, ומה הסוכן מורשה לעשות — גבולות שהמעטפת אוכפת בפועל, כי לפי Arize המודל אינו יכול לאכוף אותם בעצמו. אותו מקור גם מבחין בין מעטפת למסגרת סוכנים (Agent Framework) במשפט אחד: מסגרת היא ספרייה שמאמצים כמו שהיא, ואילו מעטפת היא "הפיגום הספציפי שבבעלותך, שאפשר לשנות עוד היום אחר הצהריים" — קוד שהצוות עצמו כותב ומחזיק, לא תלות חיצונית. Arize מוסיפה שחלק מתפקיד המעטפת הוא גם לטפל בניסיונות חוזרים (Retries) כשקריאה לכלי נכשלת בגלל תקלה רגעית, ולשמור מצב (State) בין צעד לצעד — כדי שהסוכן לא יתחיל כל צעד מאפס, בלי זיכרון של מה שכבר קרה בצעדים הקודמים באותה משימה.

דוגמאות מהשטח, והגבול מול מעטפת הערכה

מאמר מחקר מיוני 2026 שמנסה להציע הגדרה פורמלית ובדוקה למונח (arXiv:2606.10106) בוחן אותה על שישה מימושים קיימים: Claude Code, Codex CLI (סוכן התכנות של OpenAI), Aider, Cline, OpenHands ו-SWE-agent. לפי המאמר, מעטפת היא שכבת ההרצה שעוטפת מודל שפה אחד או יותר והופכת אותם לסוכן שפועל בסביבה חיצונית, וכל השישה עומדים בארבעת התנאים שהוא מציב: לולאת סוכן שמשלבת חשיבה, פעולה ותצפית; ממשק כלים; ניהול הקשר; ומנגנוני בקרה — מגבלות, אימות ופעולות קבועות מראש. המאמר גם מבדיל במפורש בין מעטפת לבין חמש קטגוריות קרובות שמתבלבלים ביניהן לעיתים: מסגרת סוכנים, SDK, תוסף IDE, orchestrator, ואפילו "מעטפת הערכה" (Eval Harness), מושג ותיק יותר בעולם למידת המכונה שחולק איתה את השם אבל משמש למדידת מודלים ולהשוואה ביניהם, ולא להרצה של סוכן בפועל. לפי המאמר, מעטפת הערכה מריצה סוכן על סדרת משימות ומודדת את התוצאה, אבל לא מנהלת בעצמה את הלולאה הפנימית שלו. שני המושגים חולקים מילה אחת ותו לא: מעטפת הערכה בודקת ומשווה מודלים מהצד, ואילו מעטפת סוכן מריצה אותם בפועל על עבודה אמיתית. מיון נוסף, שמציעה חברת Nimbus בבלוג שלה, מחלק את עולם המעטפות לפי זירת הפעולה: "מעטפות קידוד" שעובדות בתוך מאגר קוד — Claude Code, Cursor, Codex ותוכנות קוד פתוח כמו OpenHands; "מעטפות ספרייה" שמרכיבים ישירות בקוד, כמו create_agent של LangChain, Deep Agents וגרפים ב-LangGraph; ו"מעטפות ארגוניות" (או "חיצוניות") שבהן זירת העבודה היא תפקיד שלם בתוך חברה, עם מחברים למערכות ולאנשים — לדוגמה Palantir AIP, Salesforce Agentforce ו-Nimbus עצמה.

דוגמה: "תזכורת מערכת" כפעולה של המעטפת

דוגמה מוחשית לאופן שבו מעטפת מזריקה הקשר בלי התערבות של המשתמש היא מה שהגלוסרי של Claude Code מכנה "תזכורת מערכת" (System Reminder): הודעה שהמעטפת עצמה, ולא המשתמש, מוסיפה לשיחה כדי לתת ל-Claude מידע נוסף. התיעוד מגדיר את הדבר במפורש: "הודעה ש-Claude Code, בתפקידו כמעטפת, מוסיף לשיחה כדי לתת ל-Claude הקשר". קבצי CLAUDE.md, רשימת המיומנויות הזמינות, הודעה על כך שקובץ ש-Claude קרא קודם השתנה בדיסק, ואפילו שורות הייחוס שמתלוות ל-commit — כולן מגיעות ל-Claude בדרך הזו, לא כהודעת משתמש רגילה. זו המחשה מדויקת של המשמעות המעשית של "ניהול הקשר": המעטפת מחליטה מה נכנס לשיחה ומתי, לא רק המשתמש והמודל.

מעטפת מול מסגרת מול סביבת ריצה: ההבחנה של הריסון צ'ייס

בפוסט מ-25 באוקטובר 2025 הציע הריסון צ'ייס מ-LangChain חלוקה משולשת לתחום הזה. מסגרת סוכנים (כמו LangChain עצמה, Vercel AI SDK, CrewAI, OpenAI Agents SDK) "מספקת בעיקר הפשטות" — אבני בניין שהמפתח מרכיב מהן את הסוכן. סביבת ריצה (כמו LangGraph, שצ'ייס משווה ל-Temporal ול-Inngest) מטפלת דווקא בצורכי תשתית: ביצוע עמיד (durable execution), הזרמה (streaming), השהיה לאישור אנושי וזיכרון בין שיחות. מעטפת נמצאת מעל שתיהן, ומגיעה "עם סוללות בפנים" — פרומפטים מוכנים כברירת מחדל, טיפול בקריאות לכלים, כלי תכנון וגישה למערכת הקבצים, הכול מוכן לשימוש. כדוגמאות הוא ציין את DeepAgents של LangChain, שתיאר כ"גרסה כללית של Claude Code", ואת Claude Agent SDK של Anthropic, והעריך שמעבר לשני אלה כמעט שאין היום מעטפות כלליות נוספות. צ'ייס עצמו הודה שהגבולות בין שלושת המושגים עדיין מטושטשים, ושאין להם הגדרה חדה ומוסכמת.

מעטפת קידוד ממוקדת מול מעטפת כללית

יש להבחין גם בין שתי משפחות של מעטפות. כל שש המעטפות שהמאמר האקדמי בוחן — Claude Code, Codex CLI, Aider, Cline, OpenHands ו-SWE-agent — הן כלי קידוד, שעובדים על קבצים ופקודות במאגר קוד. צ'ייס, לעומת זאת, מצביע על Claude Agent SDK ועל DeepAgents כמעטפות כלליות יותר, שאינן בנויות רק לקידוד, אלא לכל משימה שדורשת תכנון, כלים וגישה למערכת קבצים — ולכן הוא מתאר את DeepAgents כ"גרסה כללית של Claude Code". ההבחנה הזו — בין מעטפת שנבנתה למשימה ספציפית אחת, לבין מעטפת גנרית שמפתחים יכולים להרכיב עליה מוצר אחר — היא ציר נוסף שבו המונח עדיין מתגבש, מלבד הגבול בינה לבין מסגרת וסביבת ריצה.

למה לא "סוכן" ולא "אגנטי": ההבדל מהמונחים השכנים

חשוב להבחין בין מעטפת סוכן לבין שני מונחים קרובים שכבר נכתבו באתר הזה. סוכן בינה מלאכותית הוא התוצר המורכב — המודל שרץ בתוך מעטפת, מתכנן ומבצע משימה; מעטפת היא התשתית שמאפשרת לו את זה, ולא הסוכן עצמו. בינה מלאכותית אגנטית מתארת מגמת התפתחות רחבה בתעשייה — המעבר הכללי למערכות עצמאיות יותר — ולא רכיב תוכנה ספציפי. ההבדל הזה אינו סמנטי בלבד: שתי מעטפות שונות (למשל Claude Code ו-Cline) יכולות להפעיל בדיוק אותו מודל ולהגיע לתוצאות שונות מהותית, כי ההבדל נמצא במעטפת — אילו כלים זמינים, איך נבנה ההקשר, מה מורשה לרוץ בלי אישור — ולא במודל. לקורא שבוחר כלי AI בעצמו, המשמעות המעשית היא שההבדל האמיתי בין שני מוצרים שמבוססים על אותו מודל שפה בדיוק נמצא כאן, במעטפת שסביבו — לא בשם המותג או במספר הגרסה של המודל.

מעטפת למשימות ארוכות, ולמה דחיסה לבדה לא מספיקה

רשומה בבלוג ההנדסי של Anthropic מ-26 בנובמבר 2025 מדגימה מה קורה כשבונים מעטפת מותאמת למשימה ארוכה. בניסוי, המודל Claude Opus 4.5 התבקש לבנות שכפול (clone) של claude.ai, בעבודה שנמשכה על פני מושבים רבים. הכותבים מציינים במפורש ש"דחיסה בלבד לא הספיקה" לעבודה רציפה ואמינה על פני כמה שיחות, ולכן המעטפת שבנו כללה רכיבים נוספים: סוכן אתחול שרץ פעם אחת ויוצר סקריפט הפעלה, קובץ יומן התקדמות ורשימת פיצ'רים (יותר מ-200 סעיפים, שכולם מסומנים מראש כנכשלים); וסוכן קידוד שרץ בכל מושב נוסף, עובד על פיצ'ר אחד, בודק אותו ומעדכן את היומן. לקח מרכזי שהם מצאו: בלי הנחיה מפורשת לבדוק מקצה לקצה — למשל דרך שרת MCP של Puppeteer שמדמה משתמש אמיתי בדפדפן — Claude הסתפק בבדיקות יחידה או ב-curl, וסימן פיצ'רים כגמורים בלי לאשר בפועל שהם עובדים. הכותבים מוסיפים עוד שני לקחים מעשיים. ראשית, הם הנחו במפורש ובחדות לא לערוך ולא למחוק את רשימת הבדיקות עצמה, כדי שסוכן תקוע לא "יפתור" כישלון במחיקת הבדיקה שחושפת אותו. שנית, מגבלות ראייה ואילוצי אוטומציה בדפדפן — למשל חוסר היכולת להתמודד עם חלונות alert מובנים של הדפדפן — המשיכו לגרום לתקלות שהמעטפת, כפי שנבנתה אז, לא פתרה.