Kontextové inženýrství: práce před výzvou

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

1~
2Slovo okamžiku v malém světě agentů AI je kontextové inženýrství.
3~
4Zdá se, že další značka byla vynalezena, aby prodávala něco, co jsme již udělali. Částečně ano. Jak se však často stává, etiketa se chytne, protože dává jméno skutečné bolesti.
5~
6Bolest je tato: modelky neselžou jen proto, že „nemyslí“. Často selhávají, protože je posíláme do práce se špatnou místností.
7~
8Dáváme jim staré pokyny. Skrýváme před ním důležité soubory. Předáváme jim dokumenty, které jsou příliš dlouhé a neříkají, na čem záleží. Zobrazujeme jim protokoly bez priority. Dáváme jim deset nástrojů, aniž bychom jim vysvětlili, kdy je použít. Pak jsme překvapeni, když se agent pohybuje jako člověk probuzený v neznámém bytě.
9~
10Výzva je fráze, kterou jí řeknete. Kontext je svět, který kolem něj připravujete.
11~
12## Od rychlého inženýrství po kontextové inženýrství
13~
14Pohotové inženýrství bylo často chápáno jako psaní. Vyberte správná slova, ptejte se správným způsobem, přidejte příklady, určete formát.
15~
16Kontextové inženýrství má blíže k architektuře.
17~
18Neptáte se jen „jak mám formulovat žádost?“. Ptá se:
19~
20- jaké informace jsou skutečně potřeba?
21- co je hluk?
22- co je třeba obnovit za běhu?
23- co je třeba pamatovat?
24- které nástroje by měly být vystaveny?
25- které instrukce jsou stabilní a které závisí na úloze?
26- jak přimět agenta, aby pochopil, co je směrodatné?
27~
28Je to jemná, ale obrovská změna. Protože když pracujete s agenty, kontext není statický blok. Mění se na každém kroku.
29~
30Agent otevře soubor, něco se naučí, spustí test, přijme chybu, aktualizuje plán, zavolá nástroj, objeví závislost. S každým kolem se musí rozhodnout, co si vzít s sebou a co vynechat.
31~
32To je strojírenství.
33~
34## Kontext není skládka
35~
36Šablony s velkými kontextovými okny nám daly pokušení: pojďme všechno hodit dovnitř.
37~
38Je to pochopitelné. Když mám milion tokenů, proč bych si měl vybírat?
39~
40Protože i když do toho můžete dát všechno, neznamená to, že všechno pomáhá. Hluk skutečně něco stojí. Stojí to tokeny, stojí to pozornost, stojí to latence, stojí to kvalita. Model se může ztratit v nepodstatných detailech stejně jako my, když otevřeme dvacet záložek a už si nepamatujeme proč.
41~
42Dobrý kontext má hierarchii:
43~
441. systémové pokyny a zásady;
452. specifický cíl;
463. aktuální stav;
474. relevantní údaje;
485. omezení;
496. dostupné nástroje;
507. sledovat již učiněná rozhodnutí.
51~
52Není potřeba zacházet se vším na stejné úrovni. Uživatelský příkaz má větší cenu než stará poznámka. Neúspěšný test má nyní větší hodnotu než jen estetická preference z doby před třemi měsíci. Bezpečnostní politika má větší cenu než produkční zkratka.
53~
54Kontextové inženýrství také znamená dávat váhy, nejen data.
55~
56## Paměť: pamatujte si méně, pamatujte si lépe
57~
58Paměť v agentech je jedním z nejkluzčích témat.
59~
60Jako uživatel chcete, aby vás agent znal. Chcete, aby si pamatoval tón, plán, konvence, věci, o kterých už bylo rozhodnuto. Jako inženýr víte, že každá trvalá paměť je také rizikem: může být chybná, stará, příliš osobní, příliš obecná, neověřitelná.
61~
62Užitečná paměť by měla mít alespoň tři vlastnosti:
63~
64- provenience: odkud tyto informace pocházejí?
65- datum: kdy to byla pravda?
66- účel: pro jaký typ úkolu by měl být použit?
67~
68Bez těchto tří věcí se paměť stává pověrou.
69~
70Rád přemýšlím o agentní paměti jako o pracovním sešitu, ne jako o magické mysli. Jsou zde dočasné poznámky, potvrzená rozhodnutí, preference stylu, technická omezení, odkazy na zdroje. Některé věci vyprší. Některé je třeba přepsat. Některé musí být odstraněny, protože je agent špatně odvodil.
71~
72Dobrý systém musí tuto údržbu zajistit běžnou. Ne hrdinské.
73~
74## Vyhledávání a nástroje nejsou totéž
75~
76Když mluvíme o kontextu, často okamžitě skončíme na RAG. Vkládání, vektorová databáze, chunking, reranking.
77~
78Vše užitečné. Vyhledání je ale jen jeden způsob, jak do modelu přinést informace. Není jediný.
79~
80Agent může získat kontext čtením souborů, dotazem na API, voláním serveru MCP, otevřením prohlížeče, spuštěním testů, prohledáním Slacku, pohledem na řídicí panel, dotazem na člověka.
81~
82Zajímavou částí je rozhodování, jakou trasu použít a kdy.
83~
84Pokud agent potřebuje odpovědět na historickou otázku, stačí snad jen vyhledání. Pokud má opravit chybu, musí přečíst skutečný kód. Pokud potřebuje pochopit, proč se nasazení nezdaří, musí se podívat na čerstvé protokoly. Pokud potřebujete napsat zákazníkovi, musíte získat tón, historii a stav lístku. Pokud musí jednat o produkci, musí požádat o povolení.
85~
86Kontext není databáze. Je to pracovní postup.
87~
88## Dobrý agent také ví, jak ignorovat
89~
90Známkou vyspělosti u agentů bude schopnost říci: Tyto informace nepotřebuji.
91~
92Zdá se to triviální, ale je to velmi obtížné. Akumuluje se mnoho agentních systémů. Každé volání nástroje přidává text. Každá chyba zůstává ve vyrovnávací paměti. Každý přečtený soubor se přidá do zásobníku. Nakonec má model velmi dlouhou historii a žádnou mapu.
93~
94Je potřeba komprese. Je nutná střední syntéza. Je potřeba to strukturovat.
95~
96Ne "to je vše, co se stalo", ale:
97~
98- cíl stále platný;
99- současná hypotéza;
100- soubory již zkontrolovány;
101- učiněná rozhodnutí;
102- otevřená rizika;
103- další akce.
104~
105Tím je agent méně teatrální a užitečnější. Ne proto, že by se zdál chytřejší, ale proto, že pracuje s uklizeným stolem.
106~
107## Kontextové inženýrství pro týmy, ne pro pohotové umělce
108~
109Důvod, proč mě toto téma zajímá, je ten, že přesouvá odpovědnost z jednotlivce na systém.
110~
111V pohotovém inženýrství často vyhrává ten, kdo umí s modelem nejlépe mluvit. V kontextovém inženýrství vítězí tým, který nejlépe organizuje svou práci: dokumentace, konvence, problémy, protokoly, testy, vlastnictví, pojmenování, zdroje.
112~
113Čisté úložiště se stává lepším kontextem. Dobře napsaný problém se stává lepším palivem. Aktualizovaný runbook šetří tokeny a úzkost. Přehledný seznam změn snižuje halucinace.
114~
115To je dobrá a poněkud nepříjemná zpráva. Krásné, protože odměňuje dobré postupy. Nepohodlné, protože vše nevyřešíte chytrou výzvou.
116~
117Agenti zesilují hygienu systému, který najdou.
118~
119## Jak bych to použil zítra
120~
121Pokud bych měl zavést kontextové inženýrství do skutečného projektu, začal bych od malých věcí:
122~
123- krátký a udržovaný soubor s instrukcemi projektu;
124- dobré příklady očekávaného výstupu;
125- seznam dostupných nástrojů a případů, ve kterých je lze použít;
126- architektonická rozhodnutí psaná citovatelným způsobem;
127- problém s minimálním povinným kontextem;
128- snadné načítání protokolů a testů;
129- perzistentní paměť modifikovatelná lidmi.
130~
131Pak bych změřil jednoduchou věc: kolikrát musí agent žádat o vysvětlení nebo se vydá špatným směrem?
132~
133Pokud se to stává často, nepřidával bych hned větší model. Podíval bych se na kontext.
134~
135## Moje čtení
136~
137Kontextové inženýrství je trochu nabubřelé slovo, to ano. Ale koncept je dobrý.
138~
139Připomíná nám to, že inteligence agenta není jen v modelu. Spočívá v prostředí, které mu připravujeme: co vidí, co si pamatuje, co může, co má zakázáno, které zdroje uznává za pravdivé.
140~
141Lidská část je taková: dobře připravit kontext je formou péče. Říká agentovi, ale také týmu: "Nechci, abyste hádali, chci, abyste měli, co potřebujete."
142~
143Méně magie. Čistší místnost. Agenti to potřebují stejně jako my.
144~
145## Zdroje
146~
147– [Blog LangChain: Vzestup kontextového inženýrství](https://blog.langchain.com/the-rise-of-context-engineering/)
148~
149- [Simon Willison: Kontextové inženýrství](https://simonwillison.net/2025/Jun/27/context-engineering/)
150- [Model Context Protocol: Introduction](https://modelcontextprotocol.io/introduction)
151  – [Anthropic: Budování efektivních agentů](https://www.anthropic.com/engineering/building-effective-agents)
152- [OpenAI: Nové nástroje pro stavební agenty](https://openai.com/index/new-tools-for-building-agents/)
153~

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

2Slovo okamžiku v malém světě agentů AI je kontextové inženýrství.

4Zdá se, že další značka byla vynalezena, aby prodávala něco, co jsme již udělali. Částečně ano. Jak se však často stává, etiketa se chytne, protože dává jméno skutečné bolesti.

6Bolest je tato: modelky neselžou jen proto, že „nemyslí“. Často selhávají, protože je posíláme do práce se špatnou místností.

8Dáváme jim staré pokyny. Skrýváme před ním důležité soubory. Předáváme jim dokumenty, které jsou příliš dlouhé a neříkají, na čem záleží. Zobrazujeme jim protokoly bez priority. Dáváme jim deset nástrojů, aniž bychom jim vysvětlili, kdy je použít. Pak jsme překvapeni, když se agent pohybuje jako člověk probuzený v neznámém bytě.

10Výzva je fráze, kterou jí řeknete. Kontext je svět, který kolem něj připravujete.

11~

12## Od rychlého inženýrství po kontextové inženýrství

13~

14Pohotové inženýrství bylo často chápáno jako psaní. Vyberte správná slova, ptejte se správným způsobem, přidejte příklady, určete formát.

15~

16Kontextové inženýrství má blíže k architektuře.

17~

18Neptáte se jen „jak mám formulovat žádost?“. Ptá se:

19~

20- jaké informace jsou skutečně potřeba?

21- co je hluk?

22- co je třeba obnovit za běhu?

23- co je třeba pamatovat?

24- které nástroje by měly být vystaveny?

25- které instrukce jsou stabilní a které závisí na úloze?

26- jak přimět agenta, aby pochopil, co je směrodatné?

27~

28Je to jemná, ale obrovská změna. Protože když pracujete s agenty, kontext není statický blok. Mění se na každém kroku.

29~

30Agent otevře soubor, něco se naučí, spustí test, přijme chybu, aktualizuje plán, zavolá nástroj, objeví závislost. S každým kolem se musí rozhodnout, co si vzít s sebou a co vynechat.

31~

32To je strojírenství.

33~

34## Kontext není skládka

35~

36Šablony s velkými kontextovými okny nám daly pokušení: pojďme všechno hodit dovnitř.

37~

38Je to pochopitelné. Když mám milion tokenů, proč bych si měl vybírat?

39~

40Protože i když do toho můžete dát všechno, neznamená to, že všechno pomáhá. Hluk skutečně něco stojí. Stojí to tokeny, stojí to pozornost, stojí to latence, stojí to kvalita. Model se může ztratit v nepodstatných detailech stejně jako my, když otevřeme dvacet záložek a už si nepamatujeme proč.

41~

42Dobrý kontext má hierarchii:

43~

441. systémové pokyny a zásady;

452. specifický cíl;

463. aktuální stav;

474. relevantní údaje;

485. omezení;

496. dostupné nástroje;

507. sledovat již učiněná rozhodnutí.

51~

52Není potřeba zacházet se vším na stejné úrovni. Uživatelský příkaz má větší cenu než stará poznámka. Neúspěšný test má nyní větší hodnotu než jen estetická preference z doby před třemi měsíci. Bezpečnostní politika má větší cenu než produkční zkratka.

53~

54Kontextové inženýrství také znamená dávat váhy, nejen data.

55~

56## Paměť: pamatujte si méně, pamatujte si lépe

57~

58Paměť v agentech je jedním z nejkluzčích témat.

59~

60Jako uživatel chcete, aby vás agent znal. Chcete, aby si pamatoval tón, plán, konvence, věci, o kterých už bylo rozhodnuto. Jako inženýr víte, že každá trvalá paměť je také rizikem: může být chybná, stará, příliš osobní, příliš obecná, neověřitelná.

61~

62Užitečná paměť by měla mít alespoň tři vlastnosti:

63~

64- provenience: odkud tyto informace pocházejí?

65- datum: kdy to byla pravda?

66- účel: pro jaký typ úkolu by měl být použit?

67~

68Bez těchto tří věcí se paměť stává pověrou.

69~

70Rád přemýšlím o agentní paměti jako o pracovním sešitu, ne jako o magické mysli. Jsou zde dočasné poznámky, potvrzená rozhodnutí, preference stylu, technická omezení, odkazy na zdroje. Některé věci vyprší. Některé je třeba přepsat. Některé musí být odstraněny, protože je agent špatně odvodil.

71~

72Dobrý systém musí tuto údržbu zajistit běžnou. Ne hrdinské.

73~

74## Vyhledávání a nástroje nejsou totéž

75~

76Když mluvíme o kontextu, často okamžitě skončíme na RAG. Vkládání, vektorová databáze, chunking, reranking.

77~

78Vše užitečné. Vyhledání je ale jen jeden způsob, jak do modelu přinést informace. Není jediný.

79~

80Agent může získat kontext čtením souborů, dotazem na API, voláním serveru MCP, otevřením prohlížeče, spuštěním testů, prohledáním Slacku, pohledem na řídicí panel, dotazem na člověka.

81~

82Zajímavou částí je rozhodování, jakou trasu použít a kdy.

83~

84Pokud agent potřebuje odpovědět na historickou otázku, stačí snad jen vyhledání. Pokud má opravit chybu, musí přečíst skutečný kód. Pokud potřebuje pochopit, proč se nasazení nezdaří, musí se podívat na čerstvé protokoly. Pokud potřebujete napsat zákazníkovi, musíte získat tón, historii a stav lístku. Pokud musí jednat o produkci, musí požádat o povolení.

85~

86Kontext není databáze. Je to pracovní postup.

87~

88## Dobrý agent také ví, jak ignorovat

89~

90Známkou vyspělosti u agentů bude schopnost říci: Tyto informace nepotřebuji.

91~

92Zdá se to triviální, ale je to velmi obtížné. Akumuluje se mnoho agentních systémů. Každé volání nástroje přidává text. Každá chyba zůstává ve vyrovnávací paměti. Každý přečtený soubor se přidá do zásobníku. Nakonec má model velmi dlouhou historii a žádnou mapu.

93~

94Je potřeba komprese. Je nutná střední syntéza. Je potřeba to strukturovat.

95~

96Ne "to je vše, co se stalo", ale:

97~

98- cíl stále platný;

99- současná hypotéza;

100- soubory již zkontrolovány;

101- učiněná rozhodnutí;

102- otevřená rizika;

103- další akce.

104~

105Tím je agent méně teatrální a užitečnější. Ne proto, že by se zdál chytřejší, ale proto, že pracuje s uklizeným stolem.

106~

107## Kontextové inženýrství pro týmy, ne pro pohotové umělce

108~

109Důvod, proč mě toto téma zajímá, je ten, že přesouvá odpovědnost z jednotlivce na systém.

110~

111V pohotovém inženýrství často vyhrává ten, kdo umí s modelem nejlépe mluvit. V kontextovém inženýrství vítězí tým, který nejlépe organizuje svou práci: dokumentace, konvence, problémy, protokoly, testy, vlastnictví, pojmenování, zdroje.

112~

113Čisté úložiště se stává lepším kontextem. Dobře napsaný problém se stává lepším palivem. Aktualizovaný runbook šetří tokeny a úzkost. Přehledný seznam změn snižuje halucinace.

114~

115To je dobrá a poněkud nepříjemná zpráva. Krásné, protože odměňuje dobré postupy. Nepohodlné, protože vše nevyřešíte chytrou výzvou.

116~

117Agenti zesilují hygienu systému, který najdou.

118~

119## Jak bych to použil zítra

120~

121Pokud bych měl zavést kontextové inženýrství do skutečného projektu, začal bych od malých věcí:

122~

123- krátký a udržovaný soubor s instrukcemi projektu;

124- dobré příklady očekávaného výstupu;

125- seznam dostupných nástrojů a případů, ve kterých je lze použít;

126- architektonická rozhodnutí psaná citovatelným způsobem;

127- problém s minimálním povinným kontextem;

128- snadné načítání protokolů a testů;

129- perzistentní paměť modifikovatelná lidmi.

130~

131Pak bych změřil jednoduchou věc: kolikrát musí agent žádat o vysvětlení nebo se vydá špatným směrem?

132~

133Pokud se to stává často, nepřidával bych hned větší model. Podíval bych se na kontext.

134~

135## Moje čtení

136~

137Kontextové inženýrství je trochu nabubřelé slovo, to ano. Ale koncept je dobrý.

138~

139Připomíná nám to, že inteligence agenta není jen v modelu. Spočívá v prostředí, které mu připravujeme: co vidí, co si pamatuje, co může, co má zakázáno, které zdroje uznává za pravdivé.

140~

141Lidská část je taková: dobře připravit kontext je formou péče. Říká agentovi, ale také týmu: "Nechci, abyste hádali, chci, abyste měli, co potřebujete."

142~

143Méně magie. Čistší místnost. Agenti to potřebují stejně jako my.

144~

145## Zdroje

146~

147– [Blog LangChain: Vzestup kontextového inženýrství](https://blog.langchain.com/the-rise-of-context-engineering/)

148~

149- [Simon Willison: Kontextové inženýrství](https://simonwillison.net/2025/Jun/27/context-engineering/)

150- [Model Context Protocol: Introduction](https://modelcontextprotocol.io/introduction)

151 – [Anthropic: Budování efektivních agentů](https://www.anthropic.com/engineering/building-effective-agents)

152- [OpenAI: Nové nástroje pro stavební agenty](https://openai.com/index/new-tools-for-building-agents/)

153~