Контекстна інженерія: робота до підказки

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

1~
2У маленькому світі агентів штучного інтелекту актуальною є інженерія контексту.
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. Вбудовування, векторна база даних, фрагментація, переранжування.
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Чисте сховище стає кращим контекстом. Добре написане питання стає кращим паливом. Оновлений Runbook заощаджує жетони та занепокоєння. Чіткий журнал змін зменшує галюцинації.
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У маленькому світі агентів штучного інтелекту актуальною є інженерія контексту.

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. Вбудовування, векторна база даних, фрагментація, переранжування.

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Чисте сховище стає кращим контекстом. Добре написане питання стає кращим паливом. Оновлений Runbook заощаджує жетони та занепокоєння. Чіткий журнал змін зменшує галюцинації.

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~