spinny:~/writing $ less context-engineering-agents.md
12Slovo okamžiku v malém světě agentů AI je kontextové inženýrství.34Zdá 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.56Bolest 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í.78Dá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ě.910Výzva je fráze, kterou jí řeknete. Kontext je svět, který kolem něj připravujete.1112## Od rychlého inženýrství po kontextové inženýrství1314Pohotové 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.1516Kontextové inženýrství má blíže k architektuře.1718Neptáte se jen „jak mám formulovat žádost?“. Ptá se:1920- 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é?2728Je to jemná, ale obrovská změna. Protože když pracujete s agenty, kontext není statický blok. Mění se na každém kroku.2930Agent 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.3132To je strojírenství.3334## Kontext není skládka3536Šablony s velkými kontextovými okny nám daly pokušení: pojďme všechno hodit dovnitř.3738Je to pochopitelné. Když mám milion tokenů, proč bych si měl vybírat?3940Protož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č.4142Dobrý kontext má hierarchii:43441. 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í.5152Není 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.5354Kontextové inženýrství také znamená dávat váhy, nejen data.5556## Paměť: pamatujte si méně, pamatujte si lépe5758Paměť v agentech je jedním z nejkluzčích témat.5960Jako 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á.6162Užitečná paměť by měla mít alespoň tři vlastnosti:6364- 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?6768Bez těchto tří věcí se paměť stává pověrou.6970Rá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.7172Dobrý systém musí tuto údržbu zajistit běžnou. Ne hrdinské.7374## Vyhledávání a nástroje nejsou totéž7576Když mluvíme o kontextu, často okamžitě skončíme na RAG. Vkládání, vektorová databáze, chunking, reranking.7778Vše užitečné. Vyhledání je ale jen jeden způsob, jak do modelu přinést informace. Není jediný.7980Agent 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.8182Zajímavou částí je rozhodování, jakou trasu použít a kdy.8384Pokud 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í.8586Kontext není databáze. Je to pracovní postup.8788## Dobrý agent také ví, jak ignorovat8990Známkou vyspělosti u agentů bude schopnost říci: Tyto informace nepotřebuji.9192Zdá 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.9394Je potřeba komprese. Je nutná střední syntéza. Je potřeba to strukturovat.9596Ne "to je vše, co se stalo", ale:9798- 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.104105Tí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.106107## Kontextové inženýrství pro týmy, ne pro pohotové umělce108109Důvod, proč mě toto téma zajímá, je ten, že přesouvá odpovědnost z jednotlivce na systém.110111V 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.112113Č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.114115To 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.116117Agenti zesilují hygienu systému, který najdou.118119## Jak bych to použil zítra120121Pokud bych měl zavést kontextové inženýrství do skutečného projektu, začal bych od malých věcí:122123- 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.130131Pak bych změřil jednoduchou věc: kolikrát musí agent žádat o vysvětlení nebo se vydá špatným směrem?132133Pokud se to stává často, nepřidával bych hned větší model. Podíval bych se na kontext.134135## Moje čtení136137Kontextové inženýrství je trochu nabubřelé slovo, to ano. Ale koncept je dobrý.138139Př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é.140141Lidská čá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."142143Méně magie. Čistší místnost. Agenti to potřebují stejně jako my.144145## Zdroje146147– [Blog LangChain: Vzestup kontextového inženýrství](https://blog.langchain.com/the-rise-of-context-engineering/)148149- [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
:Kontextové inženýrství: práce před výzvoulines 1-153 (END) — press q to close