הנדסת הקשר: העבודה לפני ההנחיה

spinny:~/writing $ vim context-engineering-agents.md

1~
2המילה של הרגע, בעולם הקטן של סוכני AI, היא הנדסת הקשר.
3~
4נראה כאילו עוד תווית המציאה כדי למכור משהו שכבר עשינו. בחלקו כן. עם זאת, כפי שקורה לעתים קרובות, התווית תופסת כי היא נותנת שם לכאב אמיתי.
5~
6הכאב הוא כזה: דוגמניות לא נכשלות רק בגלל שהן "לא חושבות". לעתים קרובות הם נכשלים כי אנחנו שולחים אותם לעבוד עם החדר הלא נכון.
7~
8אנחנו נותנים להם הוראות ישנות. אנחנו מסתירים ממנו קבצים חשובים. אנחנו מעבירים להם מסמכים ארוכים מדי ולא אומרים מה חשוב. אנו מראים להם יומנים ללא עדיפות. אנו נותנים להם עשרה כלים מבלי להסביר מתי להשתמש בהם. אז אנחנו מופתעים אם הסוכן זז כמו אדם שהתעורר בדירה לא מוכרת.
9~
10ההנחיה היא הביטוי שאתה אומר לו. ההקשר הוא העולם שאתה מכין סביבו.
11~
12## מהנדסה מהירה להנדסת הקשר
13~
14הנדסה מהירה נחשבה לעתים קרובות ככתיבה. בחר את המילים הנכונות, שאל בצורה הנכונה, הוסף דוגמאות, ציין את הפורמט.
15~
16הנדסת הקשר קרובה יותר לארכיטקטורה.
17~
18לא סתם שואלים "איך אני מנסח את הבקשה?". זה שואל:
19~
20- איזה מידע באמת נחוץ?
21- מה זה רעש?
22- מה צריך לשחזר תוך כדי תנועה?
23- מה צריך לזכור?
24- אילו כלים צריכים להיחשף?
25- אילו הוראות יציבות ואילו תלויות במשימה?
26- איך אני גורם לסוכן להבין מה סמכותי?
27~
28זה שינוי עדין אבל עצום. כי כשאתה עובד עם סוכנים, ההקשר אינו חסם סטטי. זה משתנה בכל שלב.
29~
30הסוכן פותח קובץ, לומד משהו, מריץ בדיקה, מקבל שגיאה, מעדכן את התוכנית, קורא לכלי, מגלה תלות. בכל סיבוב הוא צריך להחליט מה לקחת איתו ומה להשאיר בחוץ.
31~
32זו הנדסה.
33~
34## ההקשר אינו מזבלה
35~
36תבניות עם חלונות הקשר גדולים נתנו לנו פיתוי: בואו נזרוק הכל פנימה.
37~
38זה מובן. אם יש לי מיליון אסימונים, למה לי לבחור?
39~
40כי גם כשאפשר להכניס הכל, זה לא אומר שהכל עוזר. אכן, לרעש יש מחיר. זה עולה אסימונים, זה עולה תשומת לב, זה עולה חביון, זה עולה איכות. דוגמנית יכולה ללכת לאיבוד בפרטים לא רלוונטיים בדיוק כמונו כשאנחנו פותחים עשרים טאבים וכבר לא זוכרים למה.
41~
42להקשר טוב יש היררכיה:
43~
441. הוראות מערכת ומדיניות;
452. מטרה ספציפית;
463. מצב נוכחי;
474. נתונים רלוונטיים;
485. אילוצים;
496. כלים זמינים;
507. לעקוב אחר ההחלטות שכבר התקבלו.
51~
52אין צורך להתייחס לכל דבר באותה רמה. פקודת משתמש שווה יותר מפתק ישן. מבחן שנכשל שווה כעת יותר מהעדפה אסתטית מלפני שלושה חודשים. מדיניות אבטחה שווה יותר מקיצור דרך ייצור.
53~
54הנדסת הקשר פירושה גם לתת משקלים, לא רק נתונים.
55~
56## זיכרון: זכור פחות, זכור טוב יותר
57~
58זיכרון אצל סוכנים הוא אחד הנושאים החלקלקים ביותר.
59~
60כמשתמש, אתה רוצה שהסוכן יכיר אותך. אתה רוצה שהוא יזכור את הטון, התוכנית, המוסכמות, הדברים שכבר הוחלט. כמהנדס, אתה יודע שכל זיכרון מתמשך הוא גם סיכון: הוא יכול להיות שגוי, ישן, אישי מדי, גנרי מדי, בלתי ניתן לאימות.
61~
62לזיכרון שימושי צריך להיות לפחות שלוש תכונות:
63~
64- מקור: מאיפה המידע הזה מגיע?
65- תאריך: מתי זה היה נכון?
66- מטרה: לאיזה סוג משימה יש להשתמש בה?
67~
68בלי שלושת הדברים האלה, הזיכרון הופך לאמונה תפלה.
69~
70אני אוהב לחשוב על זיכרון סוכן כעל חוברת עבודה, לא על מוח קסום. יש הערות זמניות, החלטות מאושרות, העדפות סגנון, אילוצים טכניים, קישורים למקורות. יש דברים שפג תוקף. חלקם צריכים להיכתב מחדש. יש לחסל חלקם כי הסוכן הסיק אותם לא נכון.
71~
72מערכת טובה חייבת להפוך את התחזוקה הזו לנורמלית. לא הרואי.
73~
74## שליפה וכלים אינם אותו דבר
75~
76כשאנחנו מדברים על הקשר, לעתים קרובות אנחנו מגיעים מיד ל- RAG. הטבעה, מסד נתונים וקטוריים, chunking, דירוג מחדש.
77~
78הכל שימושי. אבל שליפה היא רק דרך אחת להביא מידע למודל. הוא לא היחיד.
79~
80סוכן יכול לקבל הקשר על ידי קריאת קבצים, שאילתות API, קריאה לשרת MCP, פתיחת דפדפן, הפעלת בדיקות, חיפוש ב-Slack, הסתכלות על לוח מחוונים, שאילת האדם.
81~
82החלק המעניין הוא להחליט באיזה מסלול להשתמש ומתי.
83~
84אם הסוכן צריך לענות על שאלה היסטורית, אולי מספיק רק השליפה. אם הוא צריך לתקן באג, הוא צריך לקרוא קוד אמיתי. אם הוא צריך להבין מדוע פריסה נכשלת, הוא צריך להסתכל על יומנים חדשים. אם אתה צריך לכתוב ללקוח, אתה צריך לאחזר את הטון, ההיסטוריה והסטטוס של הכרטיס. אם עליו לפעול בהפקה, עליו לבקש רשות.
85~
86ההקשר אינו מסד נתונים. זה זרימת עבודה.
87~
88## הסוכן הטוב יודע גם להתעלם
89~
90סימן לבגרות אצל סוכנים יהיה היכולת לומר: אני לא צריך את המידע הזה.
91~
92זה נראה טריוויאלי, אבל זה מאוד קשה. מערכות סוכן רבות מצטברות. כל קריאת כלי מוסיפה טקסט. כל שגיאה נשארת במאגר. כל קובץ שנקרא מוסיף לערימה. בסופו של דבר לדגם יש היסטוריה ארוכה מאוד וללא מפה.
93~
94יש צורך בדחיסה. יש צורך בסינתזה ביניים. זה צריך להיות מובנה.
95~
96לא "זה כל מה שקרה", אלא:
97~
98- המטרה עדיין תקפה;
99- השערה נוכחית;
100- קבצים שכבר נבדקו;
101- החלטות שהתקבלו;
102- סיכונים פתוחים;
103- הפעולה הבאה.
104~
105זה הופך את הסוכן לפחות תיאטרלי ויותר מועיל. לא בגלל שהוא נראה חכם יותר, אלא בגלל שהוא עובד עם שולחן מסודר.
106~
107## הנדסת הקשר לצוותים, לא לאמנים מהירים
108~
109הסיבה שהנושא הזה מעניין אותי היא שהוא מעביר אחריות מהפרט למערכת.
110~
111בהנדסה מהירה, מי שיכול לדבר עם הדגם בצורה הטובה ביותר לרוב מנצח. בהנדסת הקשר, הצוות שמארגן את עבודתו בצורה הטובה ביותר מנצח: תיעוד, מוסכמות, בעיות, יומנים, בדיקות, בעלות, שמות, מקורות.
112~
113מאגר נקי הופך להקשר טוב יותר. גיליון כתוב היטב הופך לדלק טוב יותר. ספר הפעלה מעודכן חוסך אסימונים וחרדות. יומן שינויים ברור מפחית הזיות.
114~
115אלו חדשות טובות וקצת לא נוחות. יפה כי זה מתגמל שיטות עבודה טובות. לא נוח כי אי אפשר לפתור הכל עם הנחיה חכמה.
116~
117הסוכנים מגבירים את ההיגיינה של המערכת שהם מוצאים.
118~
119## איך הייתי מיישם את זה מחר
120~
121אם הייתי מכניס הנדסת הקשר לפרויקט אמיתי, הייתי מתחיל מדברים קטנים:
122~
123- קובץ הוראות פרויקט קצר ומתוחזק;
124- דוגמאות טובות לתפוקה צפויה;
125- רשימה של כלים זמינים ומקרים שבהם ניתן להשתמש בהם;
126- החלטות אדריכליות שנכתבו בצורה ניתנת לציטוט;
127- בעיה עם מינימום הקשר חובה;
128- קל לאחזר יומנים ובדיקות;
129- זיכרון מתמשך שניתן לשינוי על ידי בני אדם.
130~
131ואז הייתי מודד דבר פשוט: כמה פעמים הסוכן צריך לבקש הבהרות או שהוא יוצא לכיוון הלא נכון?
132~
133אם זה קורה לעתים קרובות, לא הייתי מוסיף דגם גדול יותר מיד. הייתי מסתכל על ההקשר.
134~
135## הקריאה שלי
136~
137הנדסת הקשר היא מילה קצת נפוחה, כן. אבל הקונספט נכון.
138~
139זה מזכיר לנו שהאינטליגנציה של סוכן היא לא רק במודל. זה טמון בסביבה שאנחנו מכינים לו: מה הוא רואה, מה הוא זוכר, מה הוא יכול לעשות, מה אסור לו לעשות, אילו מקורות הוא מזהה כנכונים.
140~
141החלק האנושי הוא זה: הכנת ההקשר היטב היא סוג של טיפול. זה אומר לסוכן, אבל גם לצוות, "אני לא רוצה שתנחש, אני רוצה שיהיה לך את מה שאתה צריך".
142~
143פחות קסם. חדר נקי יותר. הסוכנים צריכים את זה כמונו.
144~
145## מקורות
146~
147- [בלוג LangChain: עלייתה של הנדסת הקשר](https://blog.langchain.com/the-rise-of-context-engineering/)
148- [סיימון וויליסון: הנדסת הקשר](https://simonwillison.net/2025/Jun/27/context-engineering/)
149- [פרוטוקול הקשר דגם: מבוא](https://modelcontextprotocol.io/introduction)
150- [Anthropic: בניית סוכנים יעילים](https://www.anthropic.com/engineering/building-effective-agents)
151- [OpenAI: כלים חדשים לסוכני בנייה](https://openai.com/index/new-tools-for-building-agents/)
152~

NORMAL · context-engineering-agents.md [readonly]152 lines · :q to close

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

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

6הכאב הוא כזה: דוגמניות לא נכשלות רק בגלל שהן "לא חושבות". לעתים קרובות הם נכשלים כי אנחנו שולחים אותם לעבוד עם החדר הלא נכון.

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

10ההנחיה היא הביטוי שאתה אומר לו. ההקשר הוא העולם שאתה מכין סביבו.

11~

12## מהנדסה מהירה להנדסת הקשר

13~

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

15~

16הנדסת הקשר קרובה יותר לארכיטקטורה.

17~

18לא סתם שואלים "איך אני מנסח את הבקשה?". זה שואל:

19~

20- איזה מידע באמת נחוץ?

21- מה זה רעש?

22- מה צריך לשחזר תוך כדי תנועה?

23- מה צריך לזכור?

24- אילו כלים צריכים להיחשף?

25- אילו הוראות יציבות ואילו תלויות במשימה?

26- איך אני גורם לסוכן להבין מה סמכותי?

27~

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

29~

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

31~

32זו הנדסה.

33~

34## ההקשר אינו מזבלה

35~

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

37~

38זה מובן. אם יש לי מיליון אסימונים, למה לי לבחור?

39~

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

41~

42להקשר טוב יש היררכיה:

43~

441. הוראות מערכת ומדיניות;

452. מטרה ספציפית;

463. מצב נוכחי;

474. נתונים רלוונטיים;

485. אילוצים;

496. כלים זמינים;

507. לעקוב אחר ההחלטות שכבר התקבלו.

51~

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

53~

54הנדסת הקשר פירושה גם לתת משקלים, לא רק נתונים.

55~

56## זיכרון: זכור פחות, זכור טוב יותר

57~

58זיכרון אצל סוכנים הוא אחד הנושאים החלקלקים ביותר.

59~

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

61~

62לזיכרון שימושי צריך להיות לפחות שלוש תכונות:

63~

64- מקור: מאיפה המידע הזה מגיע?

65- תאריך: מתי זה היה נכון?

66- מטרה: לאיזה סוג משימה יש להשתמש בה?

67~

68בלי שלושת הדברים האלה, הזיכרון הופך לאמונה תפלה.

69~

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

71~

72מערכת טובה חייבת להפוך את התחזוקה הזו לנורמלית. לא הרואי.

73~

74## שליפה וכלים אינם אותו דבר

75~

76כשאנחנו מדברים על הקשר, לעתים קרובות אנחנו מגיעים מיד ל- RAG. הטבעה, מסד נתונים וקטוריים, chunking, דירוג מחדש.

77~

78הכל שימושי. אבל שליפה היא רק דרך אחת להביא מידע למודל. הוא לא היחיד.

79~

80סוכן יכול לקבל הקשר על ידי קריאת קבצים, שאילתות API, קריאה לשרת MCP, פתיחת דפדפן, הפעלת בדיקות, חיפוש ב-Slack, הסתכלות על לוח מחוונים, שאילת האדם.

81~

82החלק המעניין הוא להחליט באיזה מסלול להשתמש ומתי.

83~

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

85~

86ההקשר אינו מסד נתונים. זה זרימת עבודה.

87~

88## הסוכן הטוב יודע גם להתעלם

89~

90סימן לבגרות אצל סוכנים יהיה היכולת לומר: אני לא צריך את המידע הזה.

91~

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

93~

94יש צורך בדחיסה. יש צורך בסינתזה ביניים. זה צריך להיות מובנה.

95~

96לא "זה כל מה שקרה", אלא:

97~

98- המטרה עדיין תקפה;

99- השערה נוכחית;

100- קבצים שכבר נבדקו;

101- החלטות שהתקבלו;

102- סיכונים פתוחים;

103- הפעולה הבאה.

104~

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

106~

107## הנדסת הקשר לצוותים, לא לאמנים מהירים

108~

109הסיבה שהנושא הזה מעניין אותי היא שהוא מעביר אחריות מהפרט למערכת.

110~

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

112~

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

114~

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

116~

117הסוכנים מגבירים את ההיגיינה של המערכת שהם מוצאים.

118~

119## איך הייתי מיישם את זה מחר

120~

121אם הייתי מכניס הנדסת הקשר לפרויקט אמיתי, הייתי מתחיל מדברים קטנים:

122~

123- קובץ הוראות פרויקט קצר ומתוחזק;

124- דוגמאות טובות לתפוקה צפויה;

125- רשימה של כלים זמינים ומקרים שבהם ניתן להשתמש בהם;

126- החלטות אדריכליות שנכתבו בצורה ניתנת לציטוט;

127- בעיה עם מינימום הקשר חובה;

128- קל לאחזר יומנים ובדיקות;

129- זיכרון מתמשך שניתן לשינוי על ידי בני אדם.

130~

131ואז הייתי מודד דבר פשוט: כמה פעמים הסוכן צריך לבקש הבהרות או שהוא יוצא לכיוון הלא נכון?

132~

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

134~

135## הקריאה שלי

136~

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

138~

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

140~

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

142~

143פחות קסם. חדר נקי יותר. הסוכנים צריכים את זה כמונו.

144~

145## מקורות

146~

147- [בלוג LangChain: עלייתה של הנדסת הקשר](https://blog.langchain.com/the-rise-of-context-engineering/)

148- [סיימון וויליסון: הנדסת הקשר](https://simonwillison.net/2025/Jun/27/context-engineering/)

149- [פרוטוקול הקשר דגם: מבוא](https://modelcontextprotocol.io/introduction)

150- [Anthropic: בניית סוכנים יעילים](https://www.anthropic.com/engineering/building-effective-agents)

151- [OpenAI: כלים חדשים לסוכני בנייה](https://openai.com/index/new-tools-for-building-agents/)

152~