AI agenti se pletou při stavbě cloudových aplikací. AWS dala zdarma návod, jak je to odnaučit
AWS vydala podrobný návod, jak naučit AI programovací agenty od Claude Code po GitHub Copilot správně stavět serverless aplikace v Step Functions. Je zdarma, funguje s nástroji, které vývojáři už používají, a řeší časté chyby agentů trénovaných na zastaralých datech.
Co se vlastně stalo
AWS doplnila oficiální dokumentaci služby Step Functions o stránku s názvem „Agent setup guide“. Krok za krokem v ní ukazuje, jak připojit AI agenta ke cloudu pomocí dvou věcí: takzvané dovednosti aws-serverless a Serverless MCP Serveru. Dohromady agenta naučí navrhovat, konfigurovat a nasazovat serverless aplikace tak, jak to AWS doporučuje.
Když to trochu zjednodušíme: Step Functions je služba, která v cloudu řídí sled kroků — třeba zpracování objednávky, nahrání souboru nebo datovou analýzu rozdělenou na dílčí úlohy. A „serverless“ znamená, že vývojář nespravuje žádné servery, jen píše kód a definuje, co se má stát. AI agent je pak pomocník, který tento kód píše, kontroluje a pomáhá ho nasadit.
Průvodce najdete na adrese docs.aws.amazon.com a pokrývá sedm konkrétních nástrojů: Claude Code, Codex od OpenAI, Cursor, Kiro, GitHub Copilot, Windsurf a OpenCode. Navíc funguje s jakýmkoli dalším agentem, který podporuje otevřený formát agent skills a protokol MCP.
Proč agent návod vůbec potřebuje
Základní problém je v datech, na kterých jsou velké jazykové modely trénované. Vědí hodně o tom, jak se programuje, ale jejich znalosti končí měsíce nebo i roky před dneškem. Když AWS vydá novou službu nebo upraví tu stávající, agent o tom jednoduše neví. U jednoduchých úloh, jako je vytvoření úložiště, to nevadí. U složitějších vícekrokových postupů ale agent vybere špatnou službu, špatně ji nastaví nebo zkouší funkci, která už neexistuje.
Přesně to potvrzuje samotné AWS v dokumentaci svého Agent Toolkit for AWS: agenti si při komplexních úlohách často vyberou nesprávnou službu, špatně nakonfigurují prostředky nebo opakovaně zkoušejí operace na novějších službách, na kterých nebyli trénovaní. Nový návod má tento nedostatek vyrovnat — dá agentovi přístup k aktuální dokumentaci a ověřeným postupům.
MCP a skills: dva pojmy, které se vyplatí znát
MCP (Model Context Protocol) je otevřený standard, který AI modelům umožňuje napojit se na externí nástroje a data. Představte si ho jako univerzální konektor: stejně jako USB funguje u myši i u klávesnice, MCP funguje napříč různými AI asistenty. Když tedy AWS vydá jeden „konektor“ ke svým službám, použije ho Claude Code, Cursor i Codex.
Dovednosti (agent skills) jsou pak balíčky instrukcí, skriptů a referenčních materiálů, které agentovi vysvětlí konkrétní úlohu. Důležité je, že se načítají až ve chvíli, kdy je agent potřebuje — nezabírají tedy zbytečně paměť a „kontext“, když zrovna děláte něco jiného. Formát má otevřenou specifikaci na webu agentskills.io, takže ho může použít kterýkoli agent.
Kolik to stojí a co k tomu potřebujete
Dobrá zpráva: Agent Toolkit for AWS je zdarma, bez dalších poplatků. Platíte pouze za skutečně využité cloudové zdroje podle standardního ceníku AWS, případně nic, pokud se vejdete do bezplatného limitu Free Tier. A samozřejmě dál platíte své případné předplatné samotného agenta — Cursoru, Copilota nebo jiného nástroje.
Technicky potřebujete jen dvě věci. Zaprvé nástroj uv, správce Python balíčků od firmy Astral, který se instaluje jedním příkazem. Zadruhé — volitelně — účet AWS s přihlašovacími údaji IAM. Bez nich si agent stále může prohlížet dokumentaci, ale pro skutečné akce, jako je nasazení aplikace, údaje potřebuje.
Přehled podporovaných agentů z návodu:
| Agent | Instalace dovednosti | Instalace MCP serveru |
|---|---|---|
| Claude Code | plugin aws-core | příkaz claude mcp add |
| Codex (OpenAI) | přes npx skills | příkaz codex mcp add |
| Cursor | přes npx skills | zápis do .cursor/mcp.json |
| Kiro | přes npx skills | zápis do ~/.kiro/settings/mcp.json |
| GitHub Copilot | přes npx skills | zápis do .vscode/mcp.json |
| Windsurf | přes npx skills | zápis do /.codeium/windsurf/mcp_config.json |
| OpenCode | přes npx skills | zápis do /.config/opencode/opencode.jsonc |
Česká stopa: EU region a soukromí
Pro české firmy je důležitý jeden detail, který v návodu snadno zapadne. Výchozí příklady používají americký region us-east-1, ale hodnotu regionu si nastavíte sami. U projektů, kde na tom záleží — typicky kvůli GDPR a tomu, aby data neopouštěla Evropskou unii — stačí nastavit evropský region, třeba eu-central-1 ve Frankfurtu. Serverless MCP server pak komunikuje s tímto regionem a vaše data zůstávají v EU.
AWS je přitom mezi českými vývojáři i firmami rozšířená platforma, takže novinka není jen záležitostí amerického trhu. Rozhraní a dokumentace jsou sice v angličtině — česky tento návod AWS nepřekládá — ale samotné služby fungují identicky i z Česka. Stačí účet, případně se dohodnout na regionu s vaším týmem.
Vyplatí se to vyzkoušet?
Tady musím být upřímná: tohle není nástroj pro běžného uživatele ani pro grafičku, jako jsem já. Je to pomůcka pro lidi, kteří skutečně stavějí aplikace běžící v cloudu. Pro ně ale dává smysl — instalace je otázka dvou příkazů, nic navíc nestojí a výsledkem je agent, který místo hádání podle zastaralých znalostí pracuje s aktuální dokumentací a ověřenými postupy.
Širší souvislost je možná důležitější než samotný návod. AWS, jedna z největších cloudových firem světa, tím oficiálně vsadila na protokol MCP a otevřený formát agent skills jako standardní cestu, jak propojit AI agenty s reálnými systémy. Pro každého, kdo s AI asistenty pracuje, to znamená jedno: vyplatí se sledovat, zda i vaše nástroje tyto standardy podporují.
Potřebuji k použití návodu účet AWS?
Pro instalaci dovednosti a MCP serveru ani pro prohledávání dokumentace účet nepotřebujete. Přihlašovací údaje IAM jsou nutné až pro akce, které reálně něco vytvářejí nebo mění — tedy pro nasazení aplikace nebo spouštění skriptů.
Jaký je rozdíl mezi dovedností (skill) a Serverless MCP serverem?
Dovednost je balíček návodů a postupů, který agenta naučí, jak správně serverless aplikace stavět. MCP server je naopak živé propojení s AWS, přes které agent prohledává aktuální dokumentaci a provádí skutečné úkony v cloudu. V praxi se instalují oba společně.
Mohu nastavit evropský region, aby data zůstala v EU?
Ano. Region se nastavuje proměnnou AWS_REGION — místo výchozího amerického us-east-1 lze zvolit evropský region, například eu-central-1 ve Frankfurtu. Konkrétní region si ale ověřte podle svých požadavků na umístění dat.