Ingineria contextului: lucrul înainte de prompt

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

1~
2Cuvântul momentului, în mica lume a agenților AI, este ingineria contextului.
3~
4Se pare că încă o etichetă a fost inventată pentru a vinde ceva ce am făcut deja. În parte este. Totuși, așa cum se întâmplă de multe ori, eticheta prinde pentru că dă un nume unei dureri reale.
5~
6Durerea este aceasta: modelele nu eșuează doar pentru că „nu gândesc”. De multe ori eșuează pentru că îi trimitem să lucreze cu camera greșită.
7~
8Le dăm instrucțiuni vechi. Îi ascundem fișiere importante. Le dăm documente prea lungi și nu spunem ce contează. Le arătăm jurnalele fără prioritate. Le oferim zece instrumente fără a le explica când să le folosească. Atunci suntem surprinși dacă agentul se mută ca o persoană trezită într-un apartament necunoscut.
9~
10Solicitarea este expresia pe care i-o spui. Contextul este lumea pe care o pregătești în jurul lui.
11~
12## De la inginerie promptă la inginerie de context
13~
14Ingineria promptă a fost adesea considerată ca scriere. Alegeți cuvintele potrivite, întrebați în modul corect, adăugați exemple, specificați formatul.
15~
16Ingineria contextului este mai aproape de arhitectură.
17~
18Nu te întrebi doar „cum formulez cererea?”. Se întreabă:
19~
20- de ce informații sunt necesare cu adevărat?
21- ce sunt zgomotul?
22- ce trebuie recuperat din mers?
23- ce ar trebui să ne amintim?
24- ce instrumente ar trebui expuse?
25- ce instrucțiuni sunt stabile și care depind de sarcină?
26- cum îl fac pe agent să înțeleagă ce este autoritar?
27~
28Este o schimbare subtilă, dar uriașă. Pentru că atunci când lucrați cu agenți, contextul nu este un bloc static. Se schimbă la fiecare pas.
29~
30Agentul deschide un fișier, învață ceva, execută un test, primește o eroare, actualizează planul, apelează un instrument, descoperă o dependență. Cu fiecare tură trebuie să decidă ce să ia cu el și ce să lase deoparte.
31~
32Aceasta este inginerie.
33~
34## Contextul nu este o groapă de gunoi
35~
36Șabloanele cu ferestre mari de context ne-au dat o tentație: să aruncăm totul înăuntru.
37~
38Este de înțeles. Dacă am un milion de jetoane, de ce ar trebui să aleg?
39~
40Pentru că chiar și atunci când poți pune totul, nu înseamnă că totul ajută. Într-adevăr, zgomotul are un cost. Costă jetoane, costă atenție, costă latența, costă calitate. Un model se poate pierde în detalii irelevante la fel ca noi când deschidem douăzeci de file și nu ne mai amintim de ce.
41~
42Contextul bun are o ierarhie:
43~
441. instrucțiuni și politici de sistem;
452. obiectiv specific;
463. starea actuală;
474. date relevante;
485. constrângeri;
496. instrumente disponibile;
507. urmăriți deciziile deja luate.
51~
52Nu este nevoie să tratezi totul la același nivel. O comandă de utilizator valorează mai mult decât o notă veche. Un test nereușit valorează acum mai mult decât o preferință estetică de acum trei luni. O politică de securitate valorează mai mult decât o scurtătură de producție.
53~
54Ingineria contextului înseamnă, de asemenea, a oferi ponderi, nu doar date.
55~
56## Memorie: amintiți-vă mai puțin, amintiți-vă mai bine
57~
58Memoria în agenți este unul dintre cele mai alunecoase subiecte.
59~
60În calitate de utilizator, doriți ca agentul să vă cunoască. Vrei să-și amintească tonul, planul, convențiile, lucrurile deja decise. Ca inginer, știi că fiecare amintire persistentă este și un risc: poate fi greșită, veche, prea personală, prea generică, neverificabilă.
61~
62O memorie utilă ar trebui să aibă cel puțin trei calități:
63~
64- proveniența: de unde provin aceste informații?
65- data: cand a fost adevarat?
66- scop: pentru ce tip de sarcină ar trebui să fie folosit?
67~
68Fără aceste trei lucruri, memoria devine superstiție.
69~
70Îmi place să mă gândesc la memoria agentică ca la un registru de lucru, nu ca la o minte magică. Există note temporare, decizii confirmate, preferințe de stil, constrângeri tehnice, link-uri către surse. Unele lucruri expiră. Unele trebuie rescrise. Unele trebuie eliminate pentru că agentul le-a dedus greșit.
71~
72Un sistem bun trebuie să facă această întreținere normală. Nu eroic.
73~
74## Recuperarea și instrumentele nu sunt același lucru
75~
76Când vorbim despre context, de multe ori ajungem imediat pe RAG. Încorporare, bază de date vectorială, fragmentare, reclasificare.
77~
78Toate utile. Dar recuperarea este doar o modalitate de a aduce informații la model. El nu este singurul.
79~
80Un agent poate obține context citind fișiere, interogând un API, apelând un server MCP, deschizând un browser, executând teste, căutând Slack, uitându-se la un tablou de bord, întrebând uman.
81~
82Partea interesantă este să decizi ce rută să folosești și când.
83~
84Dacă agentul trebuie să răspundă la o întrebare istorică, poate că doar recuperarea este suficientă. Dacă trebuie să remedieze o eroare, trebuie să citească cod real. Dacă trebuie să înțeleagă de ce o implementare eșuează, trebuie să se uite la jurnalele noi. Dacă trebuie să scrieți unui client, trebuie să recuperați tonul, istoricul și starea biletului. Dacă trebuie să acționeze în baza producției, trebuie să ceară permisiunea.
85~
86Contextul nu este o bază de date. Este un flux de lucru.
87~
88## Agentul bun știe și să ignore
89~
90Un semn de maturitate la agenți va fi capacitatea de a spune: nu am nevoie de această informație.
91~
92Pare banal, dar este foarte greu. Se acumulează multe sisteme agentice. Fiecare apel de instrument adaugă text. Fiecare eroare rămâne în buffer. Fiecare fișier citit se adaugă la stivă. În cele din urmă, modelul are o istorie foarte lungă și nicio hartă.
93~
94Este nevoie de compresie. Este nevoie de sinteză intermediară. Trebuie structurat.
95~
96Nu „atât s-a întâmplat”, ci:
97~
98- obiectiv încă valabil;
99- ipoteza actuală;
100- fișiere deja verificate;
101- deciziile luate;
102- riscuri deschise;
103- următoarea acțiune.
104~
105Acest lucru îl face pe agent mai puțin teatral și mai util. Nu pentru că pare mai inteligent, ci pentru că lucrează cu un birou ordonat.
106~
107## Ingineria contextului pentru echipe, nu pentru artiști prompti
108~
109Motivul pentru care acest subiect mă interesează este că transferă responsabilitatea de la individ la sistem.
110~
111În inginerie promptă, cel care poate vorbi cel mai bine cu modelul câștigă adesea. În ingineria contextului, echipa care își organizează cel mai bine munca câștigă: documentație, convenții, probleme, jurnale, teste, proprietate, denumire, surse.
112~
113Un depozit curat devine un context mai bun. O problemă bine scrisă devine un combustibil mai bun. Un runbook actualizat salvează jetoane și anxietate. Un jurnal clar al schimbărilor reduce halucinațiile.
114~
115Aceasta este o veste bună și oarecum incomodă. Frumos pentru că recompensează bunele practici. Incomod pentru că nu poți rezolva totul cu un prompt inteligent.
116~
117Agenții amplifică igiena sistemului pe care îl găsesc.
118~
119## Cum l-aș aplica mâine
120~
121Dacă ar fi să introduc ingineria contextului într-un proiect real, aș pleca de la lucruri mărunte:
122~
123- un dosar de instrucțiuni de proiect scurt și întreținut;
124- exemple bune de rezultate așteptate;
125- o listă de instrumente disponibile și cazuri în care să le folosească;
126- decizii de arhitectură redactate în mod citabil;
127- problema cu context minim obligatoriu;
128- ușor de preluat jurnalele și testele;
129- memorie persistentă modificabilă de om.
130~
131Atunci aș măsura un lucru simplu: de câte ori agentul trebuie să ceară lămuriri sau pleacă în direcția greșită?
132~
133Dacă se întâmplă des, nu aș adăuga imediat un model mai mare. M-as uita la context.
134~
135## Lectura mea
136~
137Ingineria contextului este un cuvânt umflat, da. Dar conceptul este solid.
138~
139Ne reamintește că inteligența unui agent nu este doar în model. Constă în mediul pe care îl pregătim pentru el: ce vede, ce își amintește, ce poate face, ce îi este interzis să facă, ce surse le recunoaște drept adevărate.
140~
141Partea umană este aceasta: pregătirea bine a contextului este o formă de îngrijire. Îi spune agentului, dar și echipei: „Nu vreau să ghiciți, vreau să aveți ceea ce aveți nevoie”.
142~
143Mai puțină magie. Cameră mai curată. Agenții au nevoie de el la fel de mult ca și noi.
144~
145## Surse
146~
147- [Blog LangChain: Ascensiunea ingineriei contextului](https://blog.langchain.com/the-rise-of-context-engineering/)
148- [Simon Willison: Ingineria contextului](https://simonwillison.net/2025/Jun/27/context-engineering/)
149- [Model Context Protocol: Introducere](https://modelcontextprotocol.io/introduction)
150- [Anthropic: Construire agenți eficienți](https://www.anthropic.com/engineering/building-effective-agents)
151- [OpenAI: noi instrumente pentru agenții de construcții](https://openai.com/index/new-tools-for-building-agents/)
152~

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

2Cuvântul momentului, în mica lume a agenților AI, este ingineria contextului.

4Se pare că încă o etichetă a fost inventată pentru a vinde ceva ce am făcut deja. În parte este. Totuși, așa cum se întâmplă de multe ori, eticheta prinde pentru că dă un nume unei dureri reale.

6Durerea este aceasta: modelele nu eșuează doar pentru că „nu gândesc”. De multe ori eșuează pentru că îi trimitem să lucreze cu camera greșită.

8Le dăm instrucțiuni vechi. Îi ascundem fișiere importante. Le dăm documente prea lungi și nu spunem ce contează. Le arătăm jurnalele fără prioritate. Le oferim zece instrumente fără a le explica când să le folosească. Atunci suntem surprinși dacă agentul se mută ca o persoană trezită într-un apartament necunoscut.

10Solicitarea este expresia pe care i-o spui. Contextul este lumea pe care o pregătești în jurul lui.

11~

12## De la inginerie promptă la inginerie de context

13~

14Ingineria promptă a fost adesea considerată ca scriere. Alegeți cuvintele potrivite, întrebați în modul corect, adăugați exemple, specificați formatul.

15~

16Ingineria contextului este mai aproape de arhitectură.

17~

18Nu te întrebi doar „cum formulez cererea?”. Se întreabă:

19~

20- de ce informații sunt necesare cu adevărat?

21- ce sunt zgomotul?

22- ce trebuie recuperat din mers?

23- ce ar trebui să ne amintim?

24- ce instrumente ar trebui expuse?

25- ce instrucțiuni sunt stabile și care depind de sarcină?

26- cum îl fac pe agent să înțeleagă ce este autoritar?

27~

28Este o schimbare subtilă, dar uriașă. Pentru că atunci când lucrați cu agenți, contextul nu este un bloc static. Se schimbă la fiecare pas.

29~

30Agentul deschide un fișier, învață ceva, execută un test, primește o eroare, actualizează planul, apelează un instrument, descoperă o dependență. Cu fiecare tură trebuie să decidă ce să ia cu el și ce să lase deoparte.

31~

32Aceasta este inginerie.

33~

34## Contextul nu este o groapă de gunoi

35~

36Șabloanele cu ferestre mari de context ne-au dat o tentație: să aruncăm totul înăuntru.

37~

38Este de înțeles. Dacă am un milion de jetoane, de ce ar trebui să aleg?

39~

40Pentru că chiar și atunci când poți pune totul, nu înseamnă că totul ajută. Într-adevăr, zgomotul are un cost. Costă jetoane, costă atenție, costă latența, costă calitate. Un model se poate pierde în detalii irelevante la fel ca noi când deschidem douăzeci de file și nu ne mai amintim de ce.

41~

42Contextul bun are o ierarhie:

43~

441. instrucțiuni și politici de sistem;

452. obiectiv specific;

463. starea actuală;

474. date relevante;

485. constrângeri;

496. instrumente disponibile;

507. urmăriți deciziile deja luate.

51~

52Nu este nevoie să tratezi totul la același nivel. O comandă de utilizator valorează mai mult decât o notă veche. Un test nereușit valorează acum mai mult decât o preferință estetică de acum trei luni. O politică de securitate valorează mai mult decât o scurtătură de producție.

53~

54Ingineria contextului înseamnă, de asemenea, a oferi ponderi, nu doar date.

55~

56## Memorie: amintiți-vă mai puțin, amintiți-vă mai bine

57~

58Memoria în agenți este unul dintre cele mai alunecoase subiecte.

59~

60În calitate de utilizator, doriți ca agentul să vă cunoască. Vrei să-și amintească tonul, planul, convențiile, lucrurile deja decise. Ca inginer, știi că fiecare amintire persistentă este și un risc: poate fi greșită, veche, prea personală, prea generică, neverificabilă.

61~

62O memorie utilă ar trebui să aibă cel puțin trei calități:

63~

64- proveniența: de unde provin aceste informații?

65- data: cand a fost adevarat?

66- scop: pentru ce tip de sarcină ar trebui să fie folosit?

67~

68Fără aceste trei lucruri, memoria devine superstiție.

69~

70Îmi place să mă gândesc la memoria agentică ca la un registru de lucru, nu ca la o minte magică. Există note temporare, decizii confirmate, preferințe de stil, constrângeri tehnice, link-uri către surse. Unele lucruri expiră. Unele trebuie rescrise. Unele trebuie eliminate pentru că agentul le-a dedus greșit.

71~

72Un sistem bun trebuie să facă această întreținere normală. Nu eroic.

73~

74## Recuperarea și instrumentele nu sunt același lucru

75~

76Când vorbim despre context, de multe ori ajungem imediat pe RAG. Încorporare, bază de date vectorială, fragmentare, reclasificare.

77~

78Toate utile. Dar recuperarea este doar o modalitate de a aduce informații la model. El nu este singurul.

79~

80Un agent poate obține context citind fișiere, interogând un API, apelând un server MCP, deschizând un browser, executând teste, căutând Slack, uitându-se la un tablou de bord, întrebând uman.

81~

82Partea interesantă este să decizi ce rută să folosești și când.

83~

84Dacă agentul trebuie să răspundă la o întrebare istorică, poate că doar recuperarea este suficientă. Dacă trebuie să remedieze o eroare, trebuie să citească cod real. Dacă trebuie să înțeleagă de ce o implementare eșuează, trebuie să se uite la jurnalele noi. Dacă trebuie să scrieți unui client, trebuie să recuperați tonul, istoricul și starea biletului. Dacă trebuie să acționeze în baza producției, trebuie să ceară permisiunea.

85~

86Contextul nu este o bază de date. Este un flux de lucru.

87~

88## Agentul bun știe și să ignore

89~

90Un semn de maturitate la agenți va fi capacitatea de a spune: nu am nevoie de această informație.

91~

92Pare banal, dar este foarte greu. Se acumulează multe sisteme agentice. Fiecare apel de instrument adaugă text. Fiecare eroare rămâne în buffer. Fiecare fișier citit se adaugă la stivă. În cele din urmă, modelul are o istorie foarte lungă și nicio hartă.

93~

94Este nevoie de compresie. Este nevoie de sinteză intermediară. Trebuie structurat.

95~

96Nu „atât s-a întâmplat”, ci:

97~

98- obiectiv încă valabil;

99- ipoteza actuală;

100- fișiere deja verificate;

101- deciziile luate;

102- riscuri deschise;

103- următoarea acțiune.

104~

105Acest lucru îl face pe agent mai puțin teatral și mai util. Nu pentru că pare mai inteligent, ci pentru că lucrează cu un birou ordonat.

106~

107## Ingineria contextului pentru echipe, nu pentru artiști prompti

108~

109Motivul pentru care acest subiect mă interesează este că transferă responsabilitatea de la individ la sistem.

110~

111În inginerie promptă, cel care poate vorbi cel mai bine cu modelul câștigă adesea. În ingineria contextului, echipa care își organizează cel mai bine munca câștigă: documentație, convenții, probleme, jurnale, teste, proprietate, denumire, surse.

112~

113Un depozit curat devine un context mai bun. O problemă bine scrisă devine un combustibil mai bun. Un runbook actualizat salvează jetoane și anxietate. Un jurnal clar al schimbărilor reduce halucinațiile.

114~

115Aceasta este o veste bună și oarecum incomodă. Frumos pentru că recompensează bunele practici. Incomod pentru că nu poți rezolva totul cu un prompt inteligent.

116~

117Agenții amplifică igiena sistemului pe care îl găsesc.

118~

119## Cum l-aș aplica mâine

120~

121Dacă ar fi să introduc ingineria contextului într-un proiect real, aș pleca de la lucruri mărunte:

122~

123- un dosar de instrucțiuni de proiect scurt și întreținut;

124- exemple bune de rezultate așteptate;

125- o listă de instrumente disponibile și cazuri în care să le folosească;

126- decizii de arhitectură redactate în mod citabil;

127- problema cu context minim obligatoriu;

128- ușor de preluat jurnalele și testele;

129- memorie persistentă modificabilă de om.

130~

131Atunci aș măsura un lucru simplu: de câte ori agentul trebuie să ceară lămuriri sau pleacă în direcția greșită?

132~

133Dacă se întâmplă des, nu aș adăuga imediat un model mai mare. M-as uita la context.

134~

135## Lectura mea

136~

137Ingineria contextului este un cuvânt umflat, da. Dar conceptul este solid.

138~

139Ne reamintește că inteligența unui agent nu este doar în model. Constă în mediul pe care îl pregătim pentru el: ce vede, ce își amintește, ce poate face, ce îi este interzis să facă, ce surse le recunoaște drept adevărate.

140~

141Partea umană este aceasta: pregătirea bine a contextului este o formă de îngrijire. Îi spune agentului, dar și echipei: „Nu vreau să ghiciți, vreau să aveți ceea ce aveți nevoie”.

142~

143Mai puțină magie. Cameră mai curată. Agenții au nevoie de el la fel de mult ca și noi.

144~

145## Surse

146~

147- [Blog LangChain: Ascensiunea ingineriei contextului](https://blog.langchain.com/the-rise-of-context-engineering/)

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

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

150- [Anthropic: Construire agenți eficienți](https://www.anthropic.com/engineering/building-effective-agents)

151- [OpenAI: noi instrumente pentru agenții de construcții](https://openai.com/index/new-tools-for-building-agents/)

152~