Přejít na hlavní obsah
Zpět na slovník
SEO & GEO

AGENTS.md

AGENTS.md je otevřený formát textového souboru v repozitáři kódu. Programovací AI agenti z něj zjistí, jak projekt sestavit, otestovat a jaká pravidla v kódu platí.

AGENTS.md je obyčejný textový soubor ve formátu Markdown (jednoduchý zápis textu s nadpisy a odrážkami), který leží v repozitáři, tedy v úložišti zdrojového kódu projektu. Čtou ho programovací AI agenti: nástroje jako OpenAI Codex, Cursor, GitHub Copilot, Gemini CLI nebo Claude Code, které samy píšou a upravují kód. Autoři formátu ho přirovnávají k README (úvodnímu souboru s popisem projektu), jen psanému pro agenty. Agent v něm najde, jak projekt sestavit, jak spustit testy a jaká pravidla v kódu platí.

Odkud AGENTS.md pochází

Formát zveřejnila OpenAI v srpnu 2025 a na jeho podobě se podílely i týmy nástrojů Amp, Jules od Googlu, Cursor a Factory. Od prosince 2025 ho spravuje Agentic AI Foundation, nadace pod Linux Foundation, kam OpenAI formát předala spolu s Anthropicem a jeho protokolem MCP. Podle Linux Foundation ho tehdy používalo přes 60 000 open source projektů (projektů s veřejně dostupným kódem) a agentních nástrojů.

Podporují ho mimo jiné Codex, Cursor, GitHub Copilot, Gemini CLI, Jules a Devin. Claude Code, který používá vlastní soubor CLAUDE.md, umí v aktuálních verzích načíst i AGENTS.md, pokud CLAUDE.md v projektu chybí.

Co do AGENTS.md patří

Formát nemá povinná pole ani pevnou strukturu. Typicky obsahuje:

  • příkazy pro instalaci, sestavení a spuštění testů,
  • pravidla psaní kódu, například styl a pojmenování,
  • jak popisovat změny před odesláním ke kontrole,
  • bezpečnostní pravidla a části projektu, na které agent nemá sahat.

Velké projekty mohou mít víc souborů v podsložkách. Agent se řídí tím, který je nejblíž upravovanému souboru. Pokyn, který mu člověk zadá přímo v chatu, má přednost před souborem.

Pomáhá AGENTS.md agentům?

Přínos je menší, než se často tvrdí. Tým ETH Curych a firmy LogicStar.ai v únoru 2026 zveřejnil studii (aktualizovanou v září 2026). Soubory vygenerované jazykovým modelem podle ní úspěšnost agentů nezlepšily (v průměru byla o 0,5 až 2 % nižší, rozdíl ale nebyl statisticky průkazný) a náklady na provoz zvýšily o 20 až 23 %. Soubory napsané vývojáři zvedly úspěšnost v průměru o 2,4 %, ani to ale nebylo statisticky průkazné. Autoři doporučují psát do souboru jen to, co agent nenajde jinde, třeba v README.

Jiná studie na 124 změnách v 10 repozitářích zjistila, že s AGENTS.md agenti pracovali rychleji (medián času o 28,64 % kratší) a vygenerovali o 16,58 % méně tokenů (jednotek textu, za které se u modelů platí). Úkoly přitom dokončovali srovnatelně. Prakticky: soubor má smysl krátký, napsaný člověkem a jen o tom, co je v projektu nestandardní. Pro tyto dva přístupy se objevují zatím neustálené názvy behavior steering a capability injection.

AGENTS.md a viditelnost webu v AI

Nejčastější omyl je považovat AGENTS.md za další soubor do kořene webu, vedle robots.txt a llms.txt. Standard pro to nevznikl. Žádná AI firma neuvádí, že by její vyhledávací roboti (ChatGPT, Perplexity, Google AI Overviews) AGENTS.md na webech četli. Na to, jestli vás AI asistent najde a ocituje, proto prokazatelný vliv nemá.

Výjimkou je Shopify. Generuje každému obchodu veřejnou stránku /agents.md určenou nákupním agentům a adresy /llms.txt a /llms-full.txt ve výchozím stavu zobrazují stejný obsah. Jde o vlastní řešení Shopify, které si od formátu půjčilo jméno. Shopify ho sám odlišuje od AGENTS.md pro programovací agenty, který leží ve zdrojovém kódu šablony a na webu se nezobrazuje. Veřejná data o tom, že nákupní agenti tuto stránku skutečně čtou, jsme zatím nenašli.

Rozdíl tří souborů:

  • robots.txt říká robotům, kam na webu smějí. Je to standard a vyhledávače i velké AI firmy ho u svých hlavních robotů dodržují.
  • llms.txt je návrh přehledu nejdůležitějšího obsahu webu pro jazykové modely. Standardem zatím není.
  • AGENTS.md je návod pro AI agenty, kteří pracují s kódem.

Pozor také na bezpečnost. Agent se pokyny ze souboru řídí, takže podvržený AGENTS.md může agenta navést ke škodlivé akci. Riziko popisuje heslo Stored Prompt Injection.

Časté otázky

Kvůli viditelnosti v AI ne. OpenAI, Perplexity ani Google neuvádějí, že by ho jejich vyhledávání na webech četlo. Smysl má v repozitáři, pokud váš web nebo aplikaci vyvíjíte s pomocí programovacích AI agentů. Pokud provozujete obchod na Shopify, stránku /agents.md vám Shopify vytvoří sám.

Není. llms.txt je návrh souboru na webu, který jazykovým modelům podává přehled obsahu. AGENTS.md je návod pro programovací agenty uložený v kódu projektu. Splývat začaly jen na Shopify, kde obě adresy ve výchozím stavu zobrazují stejný obsah.

Raději ne. Podle studie ETH Curych soubory vygenerované jazykovým modelem agentům nepomohly a provoz prodražily o víc než 20 %. Lépe funguje krátký soubor, který napíše vývojář a uvede v něm jen to, co agent sám z projektu nevyčte.

Chcete vědět, co o vás AI skutečně čte?

O viditelnosti v AI rozhoduje hlavně to, jestli vás roboti smějí přečíst a jestli na webu najdou jasná a ověřitelná fakta. Na auditu zdarma zjistíme, jestli vás ChatGPT, Claude a Perplexity znají a doporučují, a do 48 hodin dostanete doporučení, co udělat jako první.

Související články

Newsletter

Novinky z SEO a AI vyhledávání do e-mailu

Jednou měsíčně vybereme to nejdůležitější a k tomu krátce, co to znamená pro váš web. Kdo chce víc, může dostávat každý týden celé zpravodajství.

Jak často?