NAME
context-engineering-agents — Context engineering: a prompt előtti munka
SYNOPSIS
cat context-engineering-agents.md
DESCRIPTION
A pillanatnyi szó az AI-ügynökök kis világában a kontextus tervezés.
Ú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.
A 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.
Ré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.
A felszólítás az a kifejezés, amelyet mondasz rá. A kontextus a körülötte előkészített világ.
Az azonnali tervezéstől a kontextus tervezésig
Az 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.
A kontextus tervezés közelebb áll az építészethez.
Nem csak azt kérdezed, hogy "hogyan fogalmazzam meg a kérést?". Azt kérdezi:
- milyen információra van igazán szükség?
- mi a zaj?
- mit kell visszaszerezni menet közben?
- mire kell emlékezni?
- milyen eszközöket kell kitenni?
- mely utasítások stabilak és melyek függenek a feladattól?
- hogyan tudom megértetni az ügynökkel, hogy mi a mérvadó?
Ez 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.
Az ü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.
Ez a mérnöki munka.
A szövegkörnyezet nem szemétlerakó
A nagy kontextusablakokkal rendelkező sablonok kísértést keltettek: dobjunk be mindent.
Ez érthető. Ha van egy millió tokenem, miért válasszak?
Mert 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.
A jó kontextusnak hierarchiája van:
- rendszerutasítások és szabályzatok;
- konkrét célkitűzés;
- jelenlegi állapot;
- releváns adatok;
- korlátok;
- rendelkezésre álló eszközök;
- nyomon követni a már meghozott döntéseket.
Nem 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.
A kontextus tervezés súlyok megadását is jelenti, nem csak adatokat.
Memória: emlékezzen kevesebbet, emlékezzen jobban
Az ügynökök emlékezete az egyik legsikamlósabb téma.
Felhaszná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.
A hasznos memóriának legalább három tulajdonsággal kell rendelkeznie:
- származás: honnan származik ez az információ?
- dátum: mikor volt igaz?
- cél: milyen típusú feladatra kell használni?
E három dolog nélkül az emlékezet babonává válik.
Szeretek 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.
Egy jó rendszernek normálissá kell tennie ezt a karbantartást. Nem hősies.
A visszakeresés és az eszközök nem ugyanaz
Amikor kontextusról beszélünk, gyakran azonnal a RAG-ra jutunk. Beágyazás, vektoros adatbázis, darabolás, átsorolás.
Minden hasznos. De a visszakeresés csak az egyik módja annak, hogy információt vigyünk a modellbe. Nem ő az egyetlen.
Az ü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.
Az érdekes része annak eldöntése, hogy melyik útvonalat és mikor használja.
Ha 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.
A kontextus nem adatbázis. Ez egy munkafolyamat.
A jó ügynök is tudja, hogyan kell figyelmen kívül hagyni
Az érettség jele az ügynökökben az lesz, ha kimondják: nincs szükségem erre az információra.
Triviá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.
Tömörítésre van szükség. Köztes szintézis szükséges. Strukturálni kell.
Nem "csak ennyi történt", hanem:
- a cél továbbra is érvényes;
- jelenlegi hipotézis;
- már ellenőrzött fájlok;
- meghozott döntések;
- nyílt kockázatok;
- következő akció.
Ezá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.
Kontextus tervezés csapatoknak, nem azonnali művészeknek
Ez a téma azért érdekel, mert az egyénről a rendszerre hárítja a felelősséget.
Az 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.
A 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.
Ez 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.
A szerek felerősítik az általuk talált rendszer higiéniáját.
Hogyan alkalmaznám holnap
Ha a kontextustervezést bevezetném egy valós projektbe, apró dolgokból indulnék ki:
- egy rövid és karbantartott projekt utasítás fájl;
- jó példák az elvárt teljesítményre;
- a rendelkezésre álló eszközök listája és a használatuk esetei;
- idézhető módon megírt építészeti döntések;
- minimális kötelező szövegkörnyezetű kérdés;
- könnyen visszakereshető naplók és tesztek;
- ember által módosítható perzisztens memória.
Akkor egy egyszerű dolgot mérnék: hányszor kell az ügynöknek pontosítást kérnie, vagy rossz irányba indul el?
Ha gyakran előfordul, akkor nem adnék hozzá egyből nagyobb modellt. Megnézném a kontextust.
Olvasásom
A kontextus mérnöke egy kicsit dagadt szó, igen. De a koncepció helyes.
Arra 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.
Az 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."
Kevesebb varázslat. Tisztább szoba. Az ügynököknek éppúgy szükségük van rá, mint nekünk.
Források
METADATA
- date: 2026-06-30
- reading: 6 min
- author: Filippo Spinella
- tags: AI, Agents, Prompting, Developer Tools