Poptat projekt
Benešl Automation / Články / Dokumentace TIA projektu
Odborný článek · Dokumentace PLC a HMI

Dokumentace TIA Portal projektu za pár minut: co umí AI a co musí zkontrolovat člověk

Dokumentaci software chce každý zákazník a skoro nikdo ji nechce psát. Velká část obsahu přitom už v projektu je: hardware, IP adresy, bloky, hierarchie volání, vstupy a výstupy, alarmy. AI napojená na TIA Portal je umí vytáhnout, doplnit popisy a sestavit do PDF nebo Excelu. Popisujeme, co jde udělat jedním zadáním a co musí před předáním zkontrolovat člověk.

Ing. Tomáš Benešl · 21. 10. 2026 · 6 minut čtení

Co v dokumentaci TIA projektu obvykle chybí

Typický stav před předáním: sítě bez titulků, proměnné bez komentářů, I/O list v Excelu, který neodpovídá projektu, a návod k obsluze převzatý ze staršího stroje. Dokumentace se píše na konci, kdy na ni nezbývá čas, a po každé změně zastará.

Dobrá zpráva je, že většinu faktů jde z projektu přečíst strojově. Ruční práce zůstává hlavně na vysvětlení, proč program něco dělá, a na pokynech pro obsluhu.

Co AI z TIA projektu vytáhne sama

  • Přehled projektu: PLC a HMI, počty bloků podle typu a jazyka, F-CPU, tabulky tagů a UDT.
  • Hardware a síť: moduly, IP adresy a graf síťové topologie.
  • Hierarchii volání bloků jako diagram.
  • Sítě LAD a FBD jako obrázky SVG a sekvence GRAPH s kroky a přechody.
  • Fyzické vstupy a výstupy s komentáři a z nich checklist pro FAT a SAT v Excelu se sloupci OK a NOK.
  • Tabulku poruch: alarmy WinCC Unified a hlášení z PLC s prázdnými sloupci pro možnou příčinu a odstranění.
  • Bloky a UDT jako čitelné textové dokumenty SIMATIC SD, od TIA Portalu V20.

To všechno jsou fakta z projektu. AI je nevymýšlí, jen je čte a skládá dohromady.

Komentáře a titulky přímo do bloků

Nejužitečnější dokumentace je ta, která je v projektu. TIA MCP pro každý blok připraví podklady: rozhraní, kód, stávající titulky a komentáře, co chybí a kdo blok volá. AI z toho napíše titulek a komentář bloku, titulky sítí a komentáře proměnných a zapíše je do bloku. Kód se při tom nemění a před zápisem se uloží záloha.

Tady je kontrola potřeba nejvíc. AI popisuje, co kód dělá. Proč to dělá, pozná jen z názvů a komentářů. Komentář „Zpoždění 5 s“ je pravdivý, užitečný je ale až komentář „Zpoždění 5 s, aby se ventil stihl otevřít před startem čerpadla“.

Předávací dokumentace a návod k obsluze v PDF

Předávací dokumentace software obsahuje přehled projektu, hardware a IP adresy, hierarchii volání, popis bloků, datové bloky a UDT, vstupy a výstupy, alarmy HMI, otisk safety programu, souhrn code review a předávací protokol k podpisu. Při dalším vydání ji TIA MCP porovná s minulým a vypíše, co se změnilo.

Návod k obsluze vzniká ve dvou krocích. TIA MCP sesbírá data z projektu včetně obrazovek HMI, AI napíše texty kapitol a šablona se vysází do PDF. Screenshoty obrazovek WinCC Unified se pořídí automaticky z běžící simulace. Když se projekt změní, aktualizace návodu nejdřív ukáže plán: které kapitoly jsou beze změny, které se přegenerují z dat a které musí někdo přepsat. Nová verze dostane záznam v historii revizí.

PDF se sází v LaTeXu, na počítači proto musí být pdflatex (MiKTeX nebo TeX Live). Bez něj dostanete zdrojový soubor .tex.

Stránka Dokumentace projektu ve webovém rozhraní

Od verze 2.19.0 má webové rozhraní TIA MCP stránku Dokumentace projektu. Po výběru PLC a HMI nabízí záložky: příručka obsluhy, předávací dokumentace, IO list a checklist, dokumentace bloků, změnový report, safety (jen u projektů s F-CPU) a export dokumentů a textů. Soubory se ukládají do složky exports a jdou rovnou stáhnout nebo zobrazit v náhledu.

Na stejné stránce jsou i projektové texty: export do Excelu, překlad pomocí AI a import zpět po potvrzení. Po importu TIA MCP texty znovu vyexportuje a ukáže, co zůstalo nepřeložené.

Příklady zadání pro AI

Udělej přehled projektu a vygeneruj hierarchii volání pro PLC_1. Pak vypiš bloky, které nemají titulky sítí nebo komentáře proměnných.
Doplň titulky sítí a komentáře proměnných do FB_Doser v češtině. Nejdřív mi texty ukaž, zapiš je až po schválení. Kde účel kódu nepoznáš, napiš otázku místo odhadu.
Vytvoř předávací dokumentaci software pro PLC_1 a HMI_1 v češtině se souhrnem code review. Porovnej ji s baseline z minulého vydání.
Vygeneruj I/O checklist pro FAT do Excelu a tabulku poruch z alarmů HMI_1 a PLC_1.

Na co si dát pozor: co musí zkontrolovat člověk

  • Účel a souvislosti. AI popíše kód, ale nezná technologii ani dohody se zákazníkem. Popisy bloků a kapitoly návodu musí přečíst někdo, kdo stroj zná.
  • Bezpečnost obsluhy. Varování, postupy při poruše a pokyny pro bezpečnou práci musí napsat nebo schválit člověk, který za ně odpovídá. Za návod k použití stroje odpovídá jeho výrobce.
  • Safety program. Otisk a signatury z projektu jsou fakta, validace safety programu ale zůstává na kvalifikované osobě.
  • Čísla a parametry. Žádané hodnoty, časy a meze v textu porovnejte s projektem i se specifikací. Jsou-li v rozporu, chyba může být v programu i v zadání.
  • Překlady. Odborné termíny a zkratky ověřte s glosářem zákazníka nebo rodilým mluvčím. Zástupné symboly v textech alarmů musí zůstat beze změny, TIA MCP překlad s rozbitými zástupnými symboly odmítne.
  • Aktuálnost. Dokumentace platí pro konkrétní verzi projektu. Uveďte ji v dokumentu a po změnách dokumentaci aktualizujte.

Shrnutí

Sesbírat fakta z TIA projektu a sestavit z nich dokumenty je s AI otázka jednoho zadání. Čas, který tím ušetříte, dejte kontrole: účelu bloků, bezpečnostních pokynů, čísel a překladů. Dokumentace pak odpovídá projektu a jde ji po změnách aktualizovat, místo aby se psala znovu.

Přehled všech dokumentačních nástrojů najdete na stránce Dokumentace TIA projektu s AI.

Časté otázky

Umí AI napsat dokumentaci k PLC programu v TIA Portalu?

Ano, pokud vidí projekt. Přes TIA MCP AI přečte bloky, hardware, vstupy a výstupy a alarmy, doplní titulky a komentáře a vytvoří předávací dokumentaci v PDF. Popisy účelu a pokyny pro obsluhu musí zkontrolovat člověk.

Mění AI při doplňování komentářů kód bloku?

Ne. Zapisují se jen titulky a komentáře bloku, sítí a proměnných. Před zápisem se uloží záloha, kterou jde jedním příkazem vrátit.

V jakých formátech dokumentace vzniká?

Předávací dokumentace a návod k obsluze v PDF přes LaTeX, I/O checklist a tabulka poruch v Excelu, diagramy jako SVG nebo Mermaid a změnový report v Markdownu. Bloky jde exportovat i jako textové dokumenty SIMATIC SD.

Jak udržet dokumentaci aktuální po změnách v projektu?

Předávací dokumentace se porovná s minulým vydáním a vypíše změny. Návod k obsluze se aktualizuje podle plánu změn po kapitolách. Změnový report mezi verzemi projektu vznikne z textového exportu projektu v Gitu.

Související články a stránky

Zdokumentujte svůj projekt s AI

TIA MCP propojí ChatGPT, Claude, Copilot nebo Gemini s TIA Portalem V17–V21 na Windows. Licence PRO stojí 295 € ročně za počítač bez DPH, prvních 7 dní je zdarma.

Siemens, SIMATIC, TIA Portal, WinCC a S7 jsou ochranné známky Siemens AG. TIA MCP je samostatný produkt Benešl Automation, není produktem společnosti Siemens a s TIA Portalem pracuje přes oficiální rozhraní TIA Portal Openness.