9 pilierov produkčných AI agentov: čo vám nikto nepovie pred nasadením

Váš demo agent funguje. Váš produkčný agent nebude.

AI agenta dokáže postaviť každý za víkend. Hodíte LLM API volanie do slučky, pridáte vyhľadávací nástroj, nasadíte na Vercel. Hotovo. Ideme.

Potom príde realita.

Váš agent halucinuje finančné dáta. Vykoná rm -rf / na vašom serveri. Unikajú mu osobné údaje zákazníkov naprieč hranicami tenantov. Cez noc premrhá tokeny za 2 000 dolárov, lebo nikto nenastavil limit.

Rozdiel medzi demo agentom a produkčným agentom nie je v kóde, je v infraštruktúre. A v roku 2026 má táto infraštruktúra meno: agent harness.

"Agent = Model + Harness. Ak nie si model, si harness."

• Vivek Trivedy, LangChain

Tento článok rozoberá 9 základných pilierov, ktoré každý produkčný AI agent potrebuje. Žiadne klišé. Žiadne "záleží od situácie". Len konkrétne stavebné bloky, overené v praxi spoločnosťami ako AWS, Anthropic, LangChain a open-source komunitou.

Pilier 1: Agent harness (orchestračná vrstva)

Harness je všetko, čo nie je model. Je to while-slučka, stavový automat, if tool_call then execute logika. Premení jednoduché bezstavové API na inteligentný uvažovací nástroj.

Čo robí:

• Spravuje ReAct slučku agenta (uvažuj, konaj, pozoruj, opakuj)
• Smeruje medzi uzlami stavového grafu (LangGraph, AWS Step Functions)
• Spravuje kontextové okno, kompakciu a pokračovanie
• Riadi výber nástrojov a poradie ich vykonávania

Kľúčové technológie:

• LangGraph - Stavové, cyklické spúšťanie grafov s vstavaným checkpointingom. Skompiluje agenta raz pri štarte, nástroje a LLM vkladá pri volaní. Používajú ho v produkcii LinkedIn, Uber a 400+ spoločností.
• AWS Bedrock AgentCore Runtime - Serverless nasadenie agentov s izoláciou relácií, podporujúce všetko od konverzácií s nízkou latenciou až po 8-hodinové asynchrónne záťaže.
• Deep Agents (LangChain) - Open-source, model-agnostický harness so súborovým systémom, plánovaním, subagentmi a middlewarom v základe.

Zlaté pravidlo: začnite jednoducho. Vlastné odporúčanie Anthropicu: "Nájdite čo najjednoduchšie riešenie a náročnosť zvyšujte len vtedy, keď je to potrebné." Väčšina produkčných agentov je ReAct slučka, nie 47-uzlový orchestračný graf.

Pilier 2: Nástroje a MCP (ruky agenta)

Model bez nástrojov je filozof. Myslí krásne, ale nedokáže nič urobiť.

Nástroje sú spôsob, akým agenti komunikujú s vonkajším svetom: vyhľadávajú na webe, čítajú databázy, posielajú e-maily, vytvárajú dokumenty. A v roku 2026 sa Model Context Protocol (MCP) stal univerzálnym štandardom na prepojenie agentov s nástrojmi.

Čo produkčné systémy nástrojov potrebujú:

• Dynamic assembly - Nástroje sa vkladajú pri každej požiadavke podľa konfigurácie agenta, nie sú zabudované v grafe
• MCP servers - Štandardizovaný protokol pre objavovanie a spúšťanie nástrojov (40+ predpripravených: GitHub, Slack, Notion, Jira a ďalšie)
• Tool descriptions matter more than you think - Anthropic strávil viac času optimalizáciou nástrojov ako promptov pre svojho SWE-bench agenta
• AWS AgentCore Gateway - Konvertuje API a Lambda funkcie na nástroje kompatibilné s agentom, prepája ich s MCP servermi a umožňuje sémantické objavovanie nástrojov

Pro tip: navrhujte Agent-Computer Interface (ACI) rovnako starostlivo, ako by ste navrhovali Human-Computer Interface (HCI). Ak by junior vývojár nerozumel popisu vášho nástroja, model tiež nie.

Pilier 3: Sandbox a spúšťanie kódu (bezpečná miestnosť)

Váš agent bude generovať a spúšťať kód. Tento kód bude niekedy chybný. Niekedy môže byť nebezpečný. Potrebujete nulový dosah škôd.

Ako to vyzerá v produkcii:

• Isolated Docker containers pre každé spustenie, predvolene bez prístupu k sieti
• Whitelisted commands - len to, čo agent potrebuje
• Resource limits - CPU, pamäť, čas, disk
• AWS AgentCore Code Interpreter - Bezpečné sandboxované spúšťanie v Pythone, JavaScripte a ďalších jazykoch
• Browser sandboxes - Pre agentov, ktorí potrebujú interagovať s webovými rozhraniami (AgentCore Browser, Playwright)

Anti-vzor: spúšťanie bash_tool na tom istom serveri ako databáza. Jeden prompt injection a dáta sú preč.

Vzor: každé spustenie kódu vytvorí dočasný container, ktorý žije a zaniká spolu s úlohou. Agent zapisuje do dočasného súborového systému, výsledky sa extrahujú a container sa zničí.

Pilier 4: Pamäť (mozog agenta v čase)

Bez pamäti každá konverzácia začína od nuly. Váš agent zabudne meno používateľa, jeho preferencie aj posledných 47 správ od včera.

Pamäť v produkčných agentoch funguje na troch úrovniach:

Kľúčový poznatok od Harrisona Chasea (LangChain): "Pamäť nie je plugin, je to harness." To, ako pamäť načítava, kompaktuje, sumarizuje a uchováva dáta, je základnou zodpovednosťou harnessu, nie doplnku.

Čo produkčná pamäť potrebuje:

• Sliding window a summarization - Neskracujte len tak, komprimujte inteligentne
• Filesystem-backed memory - Vzory AGENTS.md, CLAUDE.md pre trvalý kontext
• AWS AgentCore Memory - Spravovaná pamäťová služba udržiavajúca kontext naprieč interakciami so špičkovou presnosťou v odvetví
• Checkpointing - LangGraphov AsyncPostgresSaver ukladá každý stavový prechod pre obnovu a ladenie

Upozornenie: ak používate closed-source harness za proprietárnym API, vaša pamäť vám nepatrí. Keď zmeníte model, pamäť zostane za sebou, uzamknutá v cudzej platforme.

Pilier 5: Znalostná báza a RAG (knižnica agenta)

Pamäť je to, čo sa agent naučil. Znalosti sú to, čo si agent môže vyhľadať.

Produkčný RAG vyžaduje:

• Vector databases (Qdrant, Pinecone, pgvector) pre sémantické vyhľadávanie
• Hybrid search - Kombinujte vektorovú podobnosť s kľúčovými slovami BM25 pre lepší recall
• Chunking strategy - Nie všetky dokumenty sú rovnaké. Kód, PDF a markdown potrebujú rôzne prístupy k deleniu
• Citation tracking - Používatelia musia dôverovať odpovediam agenta. Číslované citácie [1], [2] priamo v texte sú základným štandardom

Bežná chyba: nahádzať všetko do jedného vektorového indexu v nádeji, že to embedding vyhľadávanie zvládne. Nezvládne. Produkčný RAG potrebuje filtrovanie metadát, re-ranking a vyhľadávanie s vedomím zdroja.

Pilier 6: Autorizácia a identita (vyhadzovač)

Kto agenta používa? Čo smie robiť? A čie prihlasovacie údaje agent použije, keď volá Slack?

Existujú dva zásadne odlišné autorizačné modely pre agentov:

1. On-behalf-of - Agent koná v mene používateľa. Alicin agent vidí Alicine stránky v Notion. Bobov agent vidí Bobove. Agent dedí oprávnenia používateľa.
2. Agent-as-identity - Agent má vlastné prihlasovacie údaje a oprávnenia nezávisle od toho, kto chatuje. Každý vidí to isté. Predstavte si verejný support bot.

Produkčný autorizačný stack:

• Keycloak / Auth0 / WorkOS - Poskytovateľ identity pre autentifikáciu používateľov (OIDC, JWT)
• Workspace-level RBAC - Role Admin, Editor a Member kontrolujú, kto môže agentov vytvárať a kto ich len používať
• AWS AgentCore Identity - Spravovaná identita agenta pre bezpečný prístup k AWS zdrojom a nástrojom tretích strán s vopred autorizovaným súhlasom používateľa
• Per-tool credential scoping - Agent by nikdy nemal mať širší prístup, ako úloha vyžaduje

Nočná mora: agent s admin prihlasovacími údajmi vystavený cez chatbot. Jeden chytrý prompt sa rovná plnému prístupu k vašim interným systémom.

Pilier 7: Guardrails a pravidlá (záchranná sieť)

Guardrails sú obmedzenia, ktoré bránia agentovi urobiť niečo katastrofálne zlé.

Typy guardrails:

• Input guardrails - Kontrolujú požiadavky používateľov na prompt injection, jailbreaky a nevhodný obsah skôr, ako ich model uvidí
• Output guardrails - Validujú odpovede pred doručením používateľovi. Žiadne osobné údaje? Žiadne halucinované URL? Žiadne medicínske alebo právne rady?
• Action guardrails - Nebezpečné volania nástrojov podmieňujú ľudským schválením. Odoslanie e-mailu? Vytvorenie Jira ticketu? Mazanie súboru? Najprv sa opýtajte.
• Budget guardrails - Maximálny počet tokenov na požiadavku, maximum volaní nástrojov na reláciu, mesačné limity výdavkov na agenta

AWS AgentCore Policy zachytáva volania nástrojov v reálnom čase pomocou Cedar politík definovaných v prirodzenom jazyku. "Agent nemôže mazať produkčné databázy" sa stáva vymáhateľným pravidlom, nie len nádejou.

Kľúčový poznatok Anthropicu: spúšťajte guardrails ako samostatnú inštanciu modelu paralelne s primárnou odpoveďou. Ak ten istý LLM spracúva odpoveď aj vlastnú bezpečnostnú kontrolu, výsledok je horší ako pri dvoch samostatných volaniach.

Pilier 8: Middleware a hooky (riadiaca rovina)

Middleware je tmel medzi komponentmi harnessu. Umožňuje injektovať deterministické správanie v konkrétnych bodoch vykonávania agenta bez úpravy hlavnej slučky.

Bežné vzory middlewaru:

• Pre-LLM hooks - Injektujú vrstvy systémového promptu, formátujú kontext, aplikujú cachovanie promptov
• Post-LLM hooks - Logujú odpovede, vyhodnocujú kvalitu, spúšťajú upozornenia
• Pre-tool hooks - Validujú argumenty nástrojov, kontrolujú oprávnenia, rate-limitujú
• Post-tool hooks - Parsujú výstupy nástrojov, skracujú veľké odpovede, zapisujú do audit logu
• Compaction hooks - Spustia sa pri zaplnení kontextového okna, sumarizujú a pokračujú
• Continuation hooks (Ralph Loop) - Zachytávajú pokus modelu o ukončenie a reinjectujú pôvodný prompt pre dlhodobé úlohy

Implementácia v LangGraph: middleware možno pridať ako hrany grafu, podmienené smerovanie alebo obaly uzlov. Deep Agents má vstavaný middleware systém pre prispôsobenie.

Krása middlewaru: vaša hlavná logika agenta zostáva čistá. Všetky nepríjemné veci (logovanie, rate limiting, filtrovanie obsahu, počítanie tokenov) žijú v kompozitných vrstvách okolo nej.

Pilier 9: Pozorovateľnosť a vyhodnocovanie (oči)

Ak nevidíte, čo váš agent robí, nemôžete to opraviť. A agenti opravu potrebovať budú.

Produkčná pozorovateľnosť zahŕňa:

• Tracing - Úplná cesta vykonávania: každé LLM volanie, každé volanie nástroja, každý stavový prechod. LangSmith, Langfuse a OpenTelemetry sú štandardy.
• Token accounting - Prompt tokeny, completion tokeny, celkové náklady na volanie. Rozložte ich podľa agenta, používateľa a časového obdobia.
• Latency tracking - Celkový čas odozvy, latencia na nástroj, čas inferencie LLM
• Error rates - Zlyhania nástrojov, chyby LLM, miery timeoutov, prekročenia rate limitov
• Evaluation - Automatizované hodnotenia správnosti, podloženosti a relevantnosti. Spúšťajte ich priebežne, nielen pred nasadením.

AWS AgentCore poskytuje:

• Evaluations - Vzorkujte a hodnoťte živé interakcie pomocou vstavaných a vlastných hodnotiteľov
• Observability dashboards - Poháňané CloudWatchom s integráciou OpenTelemetry

Poznatok Harrisona Chasea: "Traces sú základ." Všetko, od priebežného učenia cez optimalizáciu harnessu až po zlepšovanie pamäti, začína kompletnými traces toho, čo váš agent skutočne robil.

Produkčný kontrolný zoznam

Pred nasadením agenta prejdite týmto zoznamom:

Deväť áno znamená nasadenie. Jedno nie je blocker, nie follow-up tiket.

TL;DR

Model je inteligencia. Harness z tej inteligencie robí niečo užitočné. A harness má 9 pilierov:

1. Harness - Orchestračná slučka (LangGraph, Deep Agents)
2. Tools a MCP - Ako agenti interagujú so svetom
3. Sandbox - Bezpečné spúšťanie kódu v izolovaných containeroch
4. Memory - Krátkodobý, pracovný a dlhodobý kontext
5. Knowledge base - RAG s vektorovým vyhľadávaním a citáciami
6. Authorization - Identita používateľa a oprávnenia agenta
7. Guardrails - Záchranné siete pre vstup, výstup, akcie a rozpočet
8. Middleware - Kompozitné hooky pre deterministické riadenie
9. Observability - Tracing, metriky, vyhodnocovanie

Vynechajte čokoľvek z toho a poučíte sa ťažkou cestou.

Referencie a ďalšie čítanie:

• The Anatomy of an Agent Harness - Vivek Trivedy, LangChain (marec 2026)
• Building Effective Agents - Anthropic (december 2024)
• Your Harness, Your Memory - Harrison Chase, LangChain (apríl 2026)
• Two Different Types of Agent Authorization - Harrison Chase (marec 2026)
• Amazon Bedrock AgentCore - AWS (2026)
• Continual Learning for AI Agents - Harrison Chase (apríl 2026)