AI agent pro IT dokumentaci: zadání a návody, které nezastarávají
AI agent pro IT dokumentaci sepíše z porad, e-mailů a poznámek zadání projektu, technickou specifikaci nebo provozní návod a pak hlídá, aby dokumentace odpovídala skutečnosti. Vedoucí IT a správci tak nemusí psát dokumenty od nuly a mají jistotu, že návody platí i za rok.
Jaký problém řeší
Dokumentace je v IT věc, na kterou nikdy nezbývá čas. Zadání nového systému vzniká z několika porad a desítek e-mailů a nakonec ho někdo narychlo sepíše večer před jednáním s dodavatelem. Často v něm chybí řada požadavků, které se pak objeví až během realizace a prodražují projekt. S provozní dokumentací je to ještě horší: popis serverů a sítě zná jen správce, a když odejde nebo onemocní, firma neví, kde co běží.
Agent udělá z podkladů, které už vznikají, ucelené dokumenty a udržuje je aktuální.
Jak to vypadá v praxi
Firma chce propojit e-shop se skladem v Money S3. Proběhnou dvě porady s obchodem a skladem a vedoucí IT k tomu má několik e-mailů. Agent z nich sestaví návrh zadání: kdo bude propojení používat, jaká data se mají přenášet a jak často, co se stane při výpadku. Do seznamu otázek zařadí věci, na které nikdo nepomyslel – třeba jak řešit dobropisy a vrácené zboží. Vedoucí IT doplní odpovědi, obchod pošle připomínky a agent je zapracuje do nové verze. Schválené zadání pak odchází třem dodavatelům, jejichž nabídky jsou díky tomu srovnatelné.
Co agent potřebuje
Přístup ke složkám a kanálům, kde vznikají podklady – zápisy porad, e-maily k projektu, sdílené dokumenty. Pro provozní dokumentaci přístup ke konfiguraci a poznámkám správců. Hodí se firemní šablony; pokud je nemáte, navrhneme je.
Dokumentace navíc nemusí ležet jen ve složce. Agent z ní umí odpovídat na otázky – správce se zeptá, kde běží zálohy účetnictví nebo jaké porty používá skladový systém, a dostane odpověď s odkazem na konkrétní dokument. Totéž platí pro nového kolegu nebo externího dodavatele, který potřebuje rychle pochopit, jak firemní IT funguje. Když odpověď v dokumentaci chybí, agent to přizná a zařadí otázku na seznam věcí k doplnění.
Jak probíhá nasazení
Začínáme jedním typem dokumentu, nejčastěji zadáním projektu nebo popisem infrastruktury. Dohodneme šablonu, zdroje podkladů a kdo dokumenty schvaluje. Agent připraví první dokumenty souběžně s vaším týmem, který je porovná s tím, co by napsal sám. Pak přidáme další typy dokumentů a hlídání aktuálnosti.
Kontrola zůstává u vás
Každý dokument je návrh, dokud ho neschválí odpovědná osoba. Agent u tvrzení ukazuje, z jakého podkladu vycházejí, a vede historii verzí. Dokumenty zůstávají ve vašich úložištích a agenta lze provozovat i na vlastním serveru.
Agent nevymýšlí požadavky, které v podkladech nejsou. Co neví, uvede jako otevřenou otázku pro zadavatele. Citlivé údaje, například hesla nebo přístupové klíče, do dokumentace nezapisuje a upozorní, pokud je v podkladech najde.
Jak AI využít při práci s kódem a technickou dokumentací, ukazuje kurz Claude Code. Další agenty najdete v přehledu AI agenti pro IT.
Scénář: jak pracuje AI agent pro IT dokumentaci
- Sběr podkladůAgent shromáždí zápisy z porad, e-maily, poznámky z workshopů a stávající dokumenty k projektu nebo systému.
- Rozbor požadavkůZ podkladů vytáhne, co zadavatel potřebuje, kdo bude systém používat a jaká jsou omezení. Chybějící informace označí jako otázky.
- Struktura podle šablonyObsah uspořádá do firemní šablony – zadání, technická specifikace, provozní návod nebo popis infrastruktury.
- Návrh dokumentuSepíše rozsah, funkce, scénáře použití, kritéria převzetí a technické detaily srozumitelně pro zadavatele i pro dodavatele.
- PřipomínkyDokument sdílí k připomínkám, zapracuje komentáře, vede verze a ukáže, co se mezi nimi změnilo.
- Hlídání aktuálnostiPři změně systému nebo konfigurace upozorní, které části dokumentace přestaly platit, a navrhne úpravu.
Diagram a architektura: AI agent pro IT dokumentaci
RAG – agent vyhledává ve vašich dokumentech uložených ve vektorové databázi, místo aby odpovídal zpaměti.MCP – standardní konektor, přes který agent pracuje s vašimi systémy jen v povolených akcích.Dovednosti – naučené postupy pro opakované úkoly. Paměť – co si agent pamatuje mezi jednotlivými úkoly.
Co měřit: ukazatele přínosu
- Doba přípravy zadání
- Jak dlouho trvá od prvního jednání po schválené zadání projektu.
- Počet kol připomínek
- Kolikrát se dokument vrací k přepracování, než ho všichni přijmou.
- Změny rozsahu během projektu
- Kolik požadavků se objeví až během realizace, protože v zadání chyběly.
- Aktuálnost dokumentace
- Jak velká část provozních návodů odpovídá skutečnému stavu systémů.
Hodnoty změříme na začátku pilotu a po jeho skončení, abyste přínos viděli na vlastních číslech.