Context engineering: a prompt előtti munka

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

1~
2A pillanatnyi szó az AI-ügynökök kis világában a kontextus tervezés.
3~
4Úgy tűnik, egy újabb kiadó talált ki, hogy eladjon valamit, amit már megtettünk. Részben az. Azonban, ahogy ez gyakran megesik, a címke megragad, mert nevet ad egy igazi fájdalomnak.
5~
6A fájdalom a következő: a modellek nem buknak el csak azért, mert „nem gondolkodnak”. Gyakran meghiúsulnak, mert rossz helyiségbe küldjük őket dolgozni.
7~
8Régi utasításokat adunk nekik. Elrejtjük előle a fontos fájlokat. Olyan dokumentumokat adunk át nekik, amelyek túl hosszúak, és nem mondják el, mi számít. A naplókat prioritás nélkül mutatjuk meg nekik. Tíz eszközt adunk nekik anélkül, hogy elmagyaráznánk, mikor kell használni őket. Aztán meglepődünk, ha az ügynök úgy mozog, mint egy ismeretlen lakásban ébredt ember.
9~
10A felszólítás az a kifejezés, amelyet mondasz rá. A kontextus a körülötte előkészített világ.
11~
12## Az azonnali tervezéstől a kontextus tervezésig
13~
14Az azonnali tervezést gyakran írásnak tekintették. Válassza ki a megfelelő szavakat, kérdezzen a megfelelő módon, adjon hozzá példákat, adja meg a formátumot.
15~
16A kontextus tervezés közelebb áll az építészethez.
17~
18Nem csak azt kérdezed, hogy "hogyan fogalmazzam meg a kérést?". Azt kérdezi:
19~
20- milyen információra van igazán szükség?
21- mi a zaj?
22- mit kell visszaszerezni menet közben?
23- mire kell emlékezni?
24- milyen eszközöket kell kitenni?
25- mely utasítások stabilak és melyek függenek a feladattól?
26- hogyan tudom megértetni az ügynökkel, hogy mi a mérvadó?
27~
28Ez egy finom, de hatalmas változás. Mert amikor ügynökökkel dolgozik, a kontextus nem egy statikus blokk. Minden lépésnél változik.
29~
30Az ügynök megnyit egy fájlt, megtanul valamit, tesztet futtat, hibát kap, frissíti a tervet, meghív egy eszközt, függőséget fedez fel. Minden körben el kell döntenie, hogy mit vigyen magával és mit hagyjon ki.
31~
32Ez a mérnöki munka.
33~
34## A szövegkörnyezet nem szemétlerakó
35~
36A nagy kontextusablakokkal rendelkező sablonok kísértést keltettek: dobjunk be mindent.
37~
38Ez érthető. Ha van egy millió tokenem, miért válasszak?
39~
40Mert még ha mindent bele lehet tenni, az nem jelenti azt, hogy minden segít. Valójában a zajnak ára van. Ez zsetonokba kerül, odafigyelésbe, késleltetésbe, minőségbe kerül. Egy modell ugyanúgy elveszhet a lényegtelen részletekben, mint mi, amikor kinyitunk húsz lapot, és már nem emlékszünk rá, miért.
41~
42A jó kontextusnak hierarchiája van:
43~
441. rendszerutasítások és szabályzatok;
452. konkrét célkitűzés;
463. jelenlegi állapot;
474. releváns adatok;
485. korlátok;
496. rendelkezésre álló eszközök;
507. nyomon követni a már meghozott döntéseket.
51~
52Nem kell mindent egy szinten kezelni. Egy felhasználói parancs többet ér, mint egy régi jegyzet. Egy sikertelen teszt most többet ér, mint egy három hónappal ezelőtti esztétikai preferencia. Egy biztonsági politika többet ér, mint egy termelési parancsikon.
53~
54A kontextus tervezés súlyok megadását is jelenti, nem csak adatokat.
55~
56## Memória: emlékezzen kevesebbet, emlékezzen jobban
57~
58Az ügynökök emlékezete az egyik legsikamlósabb téma.
59~
60Felhasználóként szeretné, ha az ügynök ismerné Önt. Azt akarod, hogy emlékezzen a hangnemre, a tervre, a konvenciókra, a már eldöntött dolgokra. Mérnökként tudja, hogy minden tartós emlék egyben kockázatot is jelent: lehet téves, régi, túl személyes, túl általános, ellenőrizhetetlen.
61~
62A hasznos memóriának legalább három tulajdonsággal kell rendelkeznie:
63~
64- származás: honnan származik ez az információ?
65- dátum: mikor volt igaz?
66- cél: milyen típusú feladatra kell használni?
67~
68E három dolog nélkül az emlékezet babonává válik.
69~
70Szeretek az ügynökmemóriára munkafüzetként gondolni, nem mágikus elmének. Vannak ideiglenes megjegyzések, megerősített döntések, stíluspreferenciák, technikai korlátok, hivatkozások a forrásokhoz. Néhány dolog lejár. Néhányat át kell írni. Néhányat meg kell szüntetni, mert az ügynök félrevezette őket.
71~
72Egy jó rendszernek normálissá kell tennie ezt a karbantartást. Nem hősies.
73~
74## A visszakeresés és az eszközök nem ugyanaz
75~
76Amikor kontextusról beszélünk, gyakran azonnal a RAG-ra jutunk. Beágyazás, vektoros adatbázis, darabolás, átsorolás.
77~
78Minden hasznos. De a visszakeresés csak az egyik módja annak, hogy információt vigyünk a modellbe. Nem ő az egyetlen.
79~
80Az ügynök kontextust kaphat úgy, hogy fájlokat olvas, API-t lekérdez, MCP-kiszolgálót hív, böngészőt nyit, teszteket futtat, keres a Slackben, megnéz egy irányítópultot, megkérdezi az embert.
81~
82Az érdekes része annak eldöntése, hogy melyik útvonalat és mikor használja.
83~
84Ha az ügynöknek meg kell válaszolnia egy történelmi kérdést, talán elég a visszakeresés. Ha hibát kell javítania, valós kódot kell olvasnia. Ha meg kell értenie, miért nem sikerül egy központi telepítés, akkor friss naplókat kell néznie. Ha írnia kell egy ügyfélnek, le kell kérnie a jegy hangszínét, előzményeit és állapotát. Ha a produkció alapján kell cselekednie, engedélyt kell kérnie.
85~
86A kontextus nem adatbázis. Ez egy munkafolyamat.
87~
88## A jó ügynök is tudja, hogyan kell figyelmen kívül hagyni
89~
90Az érettség jele az ügynökökben az lesz, ha kimondják: nincs szükségem erre az információra.
91~
92Triviálisnak tűnik, de nagyon nehéz. Számos ügynökrendszer halmozódik fel. Minden eszközhívás szöveget ad hozzá. Minden hiba a pufferben marad. Minden beolvasott fájl hozzáadódik a veremhez. Végül is a modellnek nagyon hosszú története van, és nincs térkép.
93~
94Tömörítésre van szükség. Köztes szintézis szükséges. Strukturálni kell.
95~
96Nem "csak ennyi történt", hanem:
97~
98- a cél továbbra is érvényes;
99- jelenlegi hipotézis;
100- már ellenőrzött fájlok;
101- meghozott döntések;
102- nyílt kockázatok;
103- következő akció.
104~
105Ezáltal az ügynök kevésbé teátrális és segítőkészebb. Nem azért, mert okosabbnak tűnik, hanem azért, mert rendezett asztallal dolgozik.
106~
107## Kontextus tervezés csapatoknak, nem azonnali művészeknek
108~
109Ez a téma azért érdekel, mert az egyénről a rendszerre hárítja a felelősséget.
110~
111Az azonnali tervezésben gyakran az nyer, aki a legjobban tud beszélni a modellel. A kontextustervezésben az a csapat nyer, amelyik a legjobban megszervezi munkáját: dokumentáció, konvenciók, problémák, naplók, tesztek, tulajdonjog, elnevezés, források.
112~
113A tiszta adattár jobb kontextussá válik. Egy jól megírt kérdés jobb üzemanyaggá válik. A frissített runbook megmenti a tokeneket és a szorongást. A világos változásnapló csökkenti a hallucinációkat.
114~
115Ez jó és kissé kellemetlen hír. Szép, mert jutalmazza a jó gyakorlatokat. Kényelmetlen, mert egy ügyes felszólítással nem lehet mindent megoldani.
116~
117A szerek felerősítik az általuk talált rendszer higiéniáját.
118~
119## Hogyan alkalmaznám holnap
120~
121Ha a kontextustervezést bevezetném egy valós projektbe, apró dolgokból indulnék ki:
122~
123- egy rövid és karbantartott projekt utasítás fájl;
124- jó példák az elvárt teljesítményre;
125- a rendelkezésre álló eszközök listája és a használatuk esetei;
126- idézhető módon megírt építészeti döntések;
127- minimális kötelező szövegkörnyezetű kérdés;
128- könnyen visszakereshető naplók és tesztek;
129- ember által módosítható perzisztens memória.
130~
131Akkor egy egyszerű dolgot mérnék: hányszor kell az ügynöknek pontosítást kérnie, vagy rossz irányba indul el?
132~
133Ha gyakran előfordul, akkor nem adnék hozzá egyből nagyobb modellt. Megnézném a kontextust.
134~
135## Olvasásom
136~
137A kontextus mérnöke egy kicsit dagadt szó, igen. De a koncepció helyes.
138~
139Arra emlékeztet bennünket, hogy az ügynök intelligenciája nem csak a modellben rejlik. A környezetben rejlik, amit felkészítünk neki: mit lát, mire emlékszik, mit tehet, mit tilos, mely forrásokat ismeri el igaznak.
140~
141Az emberi rész a következő: a kontextus jó előkészítése az ellátás egy formája. Azt mondja az ügynöknek, de a csapatnak is: "Nem akarom, hogy találgasson, azt akarom, hogy megkapja, amire szüksége van."
142~
143Kevesebb varázslat. Tisztább szoba. Az ügynököknek éppúgy szükségük van rá, mint nekünk.
144~
145## Források
146~
147- [LangChain Blog: A kontextustervezés felemelkedése](https://blog.langchain.com/the-rise-of-context-engineering/)
148- [Simon Willison: Context engineering](https://simonwillison.net/2025/Jun/27/context-engineering/)
149- [Model Context Protocol: Bevezetés](https://modelcontextprotocol.io/introduction)
150- [Anthropic: Building hatékony szerek](https://www.anthropic.com/engineering/building-effective-agents)
151- [OpenAI: Új eszközök építőanyagokhoz](https://openai.com/index/new-tools-for-building-agents/)
152~

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

2A pillanatnyi szó az AI-ügynökök kis világában a kontextus tervezés.

4Úgy tűnik, egy újabb kiadó talált ki, hogy eladjon valamit, amit már megtettünk. Részben az. Azonban, ahogy ez gyakran megesik, a címke megragad, mert nevet ad egy igazi fájdalomnak.

6A fájdalom a következő: a modellek nem buknak el csak azért, mert „nem gondolkodnak”. Gyakran meghiúsulnak, mert rossz helyiségbe küldjük őket dolgozni.

8Régi utasításokat adunk nekik. Elrejtjük előle a fontos fájlokat. Olyan dokumentumokat adunk át nekik, amelyek túl hosszúak, és nem mondják el, mi számít. A naplókat prioritás nélkül mutatjuk meg nekik. Tíz eszközt adunk nekik anélkül, hogy elmagyaráznánk, mikor kell használni őket. Aztán meglepődünk, ha az ügynök úgy mozog, mint egy ismeretlen lakásban ébredt ember.

10A felszólítás az a kifejezés, amelyet mondasz rá. A kontextus a körülötte előkészített világ.

11~

12## Az azonnali tervezéstől a kontextus tervezésig

13~

14Az azonnali tervezést gyakran írásnak tekintették. Válassza ki a megfelelő szavakat, kérdezzen a megfelelő módon, adjon hozzá példákat, adja meg a formátumot.

15~

16A kontextus tervezés közelebb áll az építészethez.

17~

18Nem csak azt kérdezed, hogy "hogyan fogalmazzam meg a kérést?". Azt kérdezi:

19~

20- milyen információra van igazán szükség?

21- mi a zaj?

22- mit kell visszaszerezni menet közben?

23- mire kell emlékezni?

24- milyen eszközöket kell kitenni?

25- mely utasítások stabilak és melyek függenek a feladattól?

26- hogyan tudom megértetni az ügynökkel, hogy mi a mérvadó?

27~

28Ez egy finom, de hatalmas változás. Mert amikor ügynökökkel dolgozik, a kontextus nem egy statikus blokk. Minden lépésnél változik.

29~

30Az ügynök megnyit egy fájlt, megtanul valamit, tesztet futtat, hibát kap, frissíti a tervet, meghív egy eszközt, függőséget fedez fel. Minden körben el kell döntenie, hogy mit vigyen magával és mit hagyjon ki.

31~

32Ez a mérnöki munka.

33~

34## A szövegkörnyezet nem szemétlerakó

35~

36A nagy kontextusablakokkal rendelkező sablonok kísértést keltettek: dobjunk be mindent.

37~

38Ez érthető. Ha van egy millió tokenem, miért válasszak?

39~

40Mert még ha mindent bele lehet tenni, az nem jelenti azt, hogy minden segít. Valójában a zajnak ára van. Ez zsetonokba kerül, odafigyelésbe, késleltetésbe, minőségbe kerül. Egy modell ugyanúgy elveszhet a lényegtelen részletekben, mint mi, amikor kinyitunk húsz lapot, és már nem emlékszünk rá, miért.

41~

42A jó kontextusnak hierarchiája van:

43~

441. rendszerutasítások és szabályzatok;

452. konkrét célkitűzés;

463. jelenlegi állapot;

474. releváns adatok;

485. korlátok;

496. rendelkezésre álló eszközök;

507. nyomon követni a már meghozott döntéseket.

51~

52Nem kell mindent egy szinten kezelni. Egy felhasználói parancs többet ér, mint egy régi jegyzet. Egy sikertelen teszt most többet ér, mint egy három hónappal ezelőtti esztétikai preferencia. Egy biztonsági politika többet ér, mint egy termelési parancsikon.

53~

54A kontextus tervezés súlyok megadását is jelenti, nem csak adatokat.

55~

56## Memória: emlékezzen kevesebbet, emlékezzen jobban

57~

58Az ügynökök emlékezete az egyik legsikamlósabb téma.

59~

60Felhasználóként szeretné, ha az ügynök ismerné Önt. Azt akarod, hogy emlékezzen a hangnemre, a tervre, a konvenciókra, a már eldöntött dolgokra. Mérnökként tudja, hogy minden tartós emlék egyben kockázatot is jelent: lehet téves, régi, túl személyes, túl általános, ellenőrizhetetlen.

61~

62A hasznos memóriának legalább három tulajdonsággal kell rendelkeznie:

63~

64- származás: honnan származik ez az információ?

65- dátum: mikor volt igaz?

66- cél: milyen típusú feladatra kell használni?

67~

68E három dolog nélkül az emlékezet babonává válik.

69~

70Szeretek az ügynökmemóriára munkafüzetként gondolni, nem mágikus elmének. Vannak ideiglenes megjegyzések, megerősített döntések, stíluspreferenciák, technikai korlátok, hivatkozások a forrásokhoz. Néhány dolog lejár. Néhányat át kell írni. Néhányat meg kell szüntetni, mert az ügynök félrevezette őket.

71~

72Egy jó rendszernek normálissá kell tennie ezt a karbantartást. Nem hősies.

73~

74## A visszakeresés és az eszközök nem ugyanaz

75~

76Amikor kontextusról beszélünk, gyakran azonnal a RAG-ra jutunk. Beágyazás, vektoros adatbázis, darabolás, átsorolás.

77~

78Minden hasznos. De a visszakeresés csak az egyik módja annak, hogy információt vigyünk a modellbe. Nem ő az egyetlen.

79~

80Az ügynök kontextust kaphat úgy, hogy fájlokat olvas, API-t lekérdez, MCP-kiszolgálót hív, böngészőt nyit, teszteket futtat, keres a Slackben, megnéz egy irányítópultot, megkérdezi az embert.

81~

82Az érdekes része annak eldöntése, hogy melyik útvonalat és mikor használja.

83~

84Ha az ügynöknek meg kell válaszolnia egy történelmi kérdést, talán elég a visszakeresés. Ha hibát kell javítania, valós kódot kell olvasnia. Ha meg kell értenie, miért nem sikerül egy központi telepítés, akkor friss naplókat kell néznie. Ha írnia kell egy ügyfélnek, le kell kérnie a jegy hangszínét, előzményeit és állapotát. Ha a produkció alapján kell cselekednie, engedélyt kell kérnie.

85~

86A kontextus nem adatbázis. Ez egy munkafolyamat.

87~

88## A jó ügynök is tudja, hogyan kell figyelmen kívül hagyni

89~

90Az érettség jele az ügynökökben az lesz, ha kimondják: nincs szükségem erre az információra.

91~

92Triviálisnak tűnik, de nagyon nehéz. Számos ügynökrendszer halmozódik fel. Minden eszközhívás szöveget ad hozzá. Minden hiba a pufferben marad. Minden beolvasott fájl hozzáadódik a veremhez. Végül is a modellnek nagyon hosszú története van, és nincs térkép.

93~

94Tömörítésre van szükség. Köztes szintézis szükséges. Strukturálni kell.

95~

96Nem "csak ennyi történt", hanem:

97~

98- a cél továbbra is érvényes;

99- jelenlegi hipotézis;

100- már ellenőrzött fájlok;

101- meghozott döntések;

102- nyílt kockázatok;

103- következő akció.

104~

105Ezáltal az ügynök kevésbé teátrális és segítőkészebb. Nem azért, mert okosabbnak tűnik, hanem azért, mert rendezett asztallal dolgozik.

106~

107## Kontextus tervezés csapatoknak, nem azonnali művészeknek

108~

109Ez a téma azért érdekel, mert az egyénről a rendszerre hárítja a felelősséget.

110~

111Az azonnali tervezésben gyakran az nyer, aki a legjobban tud beszélni a modellel. A kontextustervezésben az a csapat nyer, amelyik a legjobban megszervezi munkáját: dokumentáció, konvenciók, problémák, naplók, tesztek, tulajdonjog, elnevezés, források.

112~

113A tiszta adattár jobb kontextussá válik. Egy jól megírt kérdés jobb üzemanyaggá válik. A frissített runbook megmenti a tokeneket és a szorongást. A világos változásnapló csökkenti a hallucinációkat.

114~

115Ez jó és kissé kellemetlen hír. Szép, mert jutalmazza a jó gyakorlatokat. Kényelmetlen, mert egy ügyes felszólítással nem lehet mindent megoldani.

116~

117A szerek felerősítik az általuk talált rendszer higiéniáját.

118~

119## Hogyan alkalmaznám holnap

120~

121Ha a kontextustervezést bevezetném egy valós projektbe, apró dolgokból indulnék ki:

122~

123- egy rövid és karbantartott projekt utasítás fájl;

124- jó példák az elvárt teljesítményre;

125- a rendelkezésre álló eszközök listája és a használatuk esetei;

126- idézhető módon megírt építészeti döntések;

127- minimális kötelező szövegkörnyezetű kérdés;

128- könnyen visszakereshető naplók és tesztek;

129- ember által módosítható perzisztens memória.

130~

131Akkor egy egyszerű dolgot mérnék: hányszor kell az ügynöknek pontosítást kérnie, vagy rossz irányba indul el?

132~

133Ha gyakran előfordul, akkor nem adnék hozzá egyből nagyobb modellt. Megnézném a kontextust.

134~

135## Olvasásom

136~

137A kontextus mérnöke egy kicsit dagadt szó, igen. De a koncepció helyes.

138~

139Arra emlékeztet bennünket, hogy az ügynök intelligenciája nem csak a modellben rejlik. A környezetben rejlik, amit felkészítünk neki: mit lát, mire emlékszik, mit tehet, mit tilos, mely forrásokat ismeri el igaznak.

140~

141Az emberi rész a következő: a kontextus jó előkészítése az ellátás egy formája. Azt mondja az ügynöknek, de a csapatnak is: "Nem akarom, hogy találgasson, azt akarom, hogy megkapja, amire szüksége van."

142~

143Kevesebb varázslat. Tisztább szoba. Az ügynököknek éppúgy szükségük van rá, mint nekünk.

144~

145## Források

146~

147- [LangChain Blog: A kontextustervezés felemelkedése](https://blog.langchain.com/the-rise-of-context-engineering/)

148- [Simon Willison: Context engineering](https://simonwillison.net/2025/Jun/27/context-engineering/)

149- [Model Context Protocol: Bevezetés](https://modelcontextprotocol.io/introduction)

150- [Anthropic: Building hatékony szerek](https://www.anthropic.com/engineering/building-effective-agents)

151- [OpenAI: Új eszközök építőanyagokhoz](https://openai.com/index/new-tools-for-building-agents/)

152~