Dokumentace TIA projektu s AI
Dokumentace bývá na konci zakázky to, na co nezbývá čas. S TIA MCP ji AI asistent připraví přímo z projektu otevřeného v TIA Portalu: návod k obsluze, předávací dokumentaci software, I/O checklist pro FAT a SAT, komentáře v blocích i změnový report. Data bere z projektu, texty napíše AI a vy je zkontrolujete.
Jaké dokumenty AI z TIA projektu vytvoří
Všechno vzniká z dat projektu, která TIA MCP čte přes oficiální rozhraní TIA Portal Openness. Ve sloupci vpravo je formát, který nástroj skutečně uloží, a jeho název pro ty, kdo chtějí vědět víc.
| Dokument | Co obsahuje | Výstup a nástroj |
|---|---|---|
| Návod k obsluze | Kusovník s objednacími čísly, síť a IP adresy, bloky a hierarchie volání, parametry z DB, fyzické I/O, obrazovky HMI, alarmy a F-signatura. Texty kapitol napíše AI. | PDF ze šablony LaTeX, podklady v JSONtia_manual_collecttia_manual_schematia_manual_render |
| Screenshoty HMI do návodu | Obrazovky WinCC Unified z běžící simulace přes webový klient, podle navigace v projektu. U starších panelů se použijí obrázky obrazovek, které dodáte. | PNGtia_manual_screenshots |
| Aktualizace návodu po změnách | Nová data z projektu porovná s minulou verzí a určí, které kapitoly zůstávají, které se přegenerují a které musí někdo přepsat. Pak zapíše jen schválené úpravy. | Plán změn v JSON a Markdownu, nová verze se záznamem revizetia_manual_update |
| Předávací dokumentace software | Přehled projektu, HW a IP, hierarchie volání, popis bloků, DB a UDT, I/O, alarmy HMI, F-otisk, code review, změny proti minulému vydání a předávací protokol k podpisu. | PDF (LaTeX) a baseline JSON pro příští vydánítia_handover_doc |
| Komentáře a titulky v blocích | AI zjistí, které sítě nemají titulek a které proměnné komentář, doplní je a zapíše do bloku. Kód bloku se nemění. | Přímo v projektu, před zápisem zálohatia_block_doc_contexttia_set_block_documentation |
| Nápověda k vlastním blokům | Stránka ke každému bloku s rozhraním, sítěmi, volanými bloky a ukázkou volání. V TIA Portalu se otevře přes Shift+F1. | HTML ve složce projektu UserFilestia_block_help |
| Diagram sítí | Sítě LAD a FBD jako v TIA Portalu, bloky S7-GRAPH jako sekvence kroků a přechodů. | SVGtia_block_diagram |
| Hierarchie volání | Graf volání OB → FB/FC celého PLC. | Graf Mermaidtia_generate_call_hierarchy |
| I/O list a FAT/SAT checklist | Adresa, tag, typ a komentář každého fyzického vstupu a výstupu, k tomu sloupce OK/NOK, datum, kdo a poznámka. | Excel (XLSX) nebo CSVtia_generate_io_checklisttia_export_io_checklist |
| Safety report a protokoly | F-runtime skupiny, F-bloky se signaturou, F-I/O DB a otisk programu. Porovnání s baseline po validaci ukáže, které F-bloky se změnily. V TIA Portalu V21 i oficiální signatury a protokol aktivačního testu. | JSON, protokol aktivačního testu PDF (V21)tia_safety_reporttia_safety_validationtia_safety_validation_printout |
| Servisní report z diagnostiky | Výsledek diagnostiky poruchy stroje do servisní dokumentace. | HTML a PDF (s Edge nebo Chrome na PC)tia_diag_report |
| Změnový report | Co se mezi dvěma verzemi projektu změnilo v blocích, safety blocích, UDT, tagech a hardwaru. Čitelně, ne jako surový rozdíl XML. | Markdowntia_change_report |
| Texty projektu a překlady | Komentáře, alarmy a texty HMI do Excelu se statistikou chybějících překladů. AI je přeloží po dávkách s glosářem a zástupné symboly nechá beze změny, pak import zpět. | Excel (XLSX)tia_export_project_textstia_texts_statstia_texts_translation_batchtia_texts_apply_translationstia_import_project_texts |
| Bloky jako čitelné dokumenty | Bloky a UDT jako SIMATIC SD dokumenty pro code review a archiv. TIA Portal V20 a novější. | .s7dcl a .s7restia_export_documents |
Jak vzniká návod k obsluze
Stejně postupuje i předávací dokumentace. Kroky můžete zadat AI jednou větou, nebo je projít ve webovém rozhraní TIA MCP.
Sběr dat
AI přečte z projektu hardware, bloky, I/O, obrazovky HMI a alarmy. Projekt se nemění.
Texty od AI
Z kódu, komentářů a vašeho zadání napíše úvod a popisy obrazovek a bloků do souboru s texty.
Screenshoty
Z běžící simulace WinCC Unified nafotí obrazovky podle navigace v projektu.
PDF
Data a texty se vyplní do šablony LaTeX a přeloží do PDF. Bez LaTeXu na PC vznikne zdroj .tex.
Kontrola
Texty i tabulky projdete a opravíte. Za obsah odpovídá ten, kdo dokumentaci předává.
Aktualizace
Po změně v projektu AI zjistí, kterých kapitol se týká, a vydá novou verzi se záznamem revize.
Stránka Dokumentace projektu ve web GUI
Od verze 2.19 má webové rozhraní TIA MCP vlastní stránku Dokumentace projektu. Dokumenty z otevřeného projektu na ní vytvoříte bez psaní zadání. Nahoře vyberete PLC nebo HMI, dokumenty jsou v záložkách.
Příručka obsluhy
Stav návodu (data, texty, screenshoty, PDF), nové vykreslení PDF, screenshoty z běžící simulace a aktualizace hotového návodu ve dvou fázích.
Předávací dokumentace
Jazyk, code review, porovnání s minulým vydáním, vlastní texty a výsledné PDF s případnými chybami LaTeXu.
I/O list a checklist
Tabulka fyzických I/O s filtrem a FAT/SAT checklist do Excelu.
Dokumentace bloků
Hierarchie volání, co v bloku chybí, formulář titulků a komentářů se zápisem po potvrzení a diagram sítí v SVG. Texty umí navrhnout Copilot.
Safety (jen s F-CPU)
Safety report s porovnáním proti baseline, protokol aktivačního testu (V21) a matice příčin a následků → F-blok s náhledem a zápisem po potvrzení.
Export dokumentů a textů
SIMATIC SD dokumenty, projektové texty do Excelu se statistikou, překlad Copilotem a import zpět po potvrzení.
Soubory se ukládají do složky exports a jdou stáhnout nebo zobrazit v náhledu (PDF, HTML, obrázky, Markdown). Zápisy do projektu jsou až po potvrzení a v režimu jen pro čtení vypnuté. Změnový report najdete na stránce Verze a změny.
Příklady zadání pro AI
Píšete běžnou řečí. Názvy PLC, bloků a složek nahraďte svými.
Vytvoř předávací dokumentaci software pro PLC_1 do složky D:\Predani: přehled projektu, HW a IP adresy, hierarchii volání, popis bloků, I/O a výsledek code review.
Projdi FB_Dopravnik, doplň titulky všem sítím a komentáře proměnným, které je nemají. Než to zapíšeš, ukaž mi návrh.
Udělej FAT checklist fyzických I/O pro PLC_1 do Excelu.
Sesbírej podklady pro návod k obsluze z PLC_1 a HMI_1, napiš texty kapitol a vytvoř PDF se screenshoty z běžící simulace.
Od minulého vydání jsme měnili sekvenci plnění. Aktualizuj návod k obsluze a ukaž mi, které kapitoly je potřeba přepsat.
Vyexportuj texty projektu do Excelu, přelož chybějící komentáře do angličtiny a před importem mi ukaž statistiku.
Co musí zkontrolovat člověk
AI ušetří psaní a dohledávání v projektu. Odpovědnost za dokumentaci, kterou předáváte zákazníkovi nebo obsluze, ale zůstává na vás.
- Popisy funkcí. AI píše z kódu, komentářů a vašeho zadání. Účel stroje a souvislosti mimo program zná jen projektant, proto si texty přečtěte celé.
- Safety. Safety report a protokoly jsou podklad. Výsledky aktivačního testu nástroj nikdy nepotvrzuje a vygenerovanou safety logiku musí zkontrolovat, otestovat a validovat odpovědná osoba.
- Aktualizace návodu. Změna jen v těle bloku bez změny rozhraní nebo komentáře se z podkladů nepozná. Kapitoly označené ke kontrole projděte vždy.
- Import textů. Přepisuje texty v celém projektu a záloha se pro texty nedělá. Před importem udělejte archiv projektu.
- Screenshoty. Fotí se z běžící simulace. Zkontrolujte, že obrazovky ukazují smysluplné hodnoty.
- I/O checklist. Je to připravený formulář. Výsledky OK/NOK vyplní technik při FAT a SAT.
Článek: dokumentace TIA projektu s AI krok za krokem
Časté otázky k dokumentaci TIA projektu
Co je dokumentace TIA projektu s AI?
AI asistent (například Claude, ChatGPT, Copilot, Gemini nebo lokální model) je přes TIA MCP propojený s projektem otevřeným v TIA Portalu. Data pro dokumentaci čte přímo z projektu a texty píše podle kódu a vašeho zadání. Výsledkem jsou soubory PDF, Excel, SVG nebo HTML a komentáře přímo v blocích.
Mění tvorba dokumentace můj projekt?
Většina nástrojů projekt jen čte. Do projektu se zapisují jen komentáře a titulky bloků a import přeložených textů. Komentáře se zapisují se zálohou a v režimu jen pro čtení se nezapíše nic.
Potřebuji pro PDF LaTeX?
Ano. Návod k obsluze a předávací dokumentace se překládají přes pdflatex (MiKTeX nebo TeX Live). Bez něj vznikne zdrojový soubor .tex, který přeložíte později. Excel, SVG a HTML LaTeX nepotřebují.
Jde dokumentaci po změně programu aktualizovat?
Ano. Návod k obsluze se aktualizuje ve dvou fázích: nejdřív plán změn po kapitolách, pak jen schválené úpravy a nová verze se záznamem revize. Předávací dokumentace si pamatuje minulé vydání a vypíše, co se od něj změnilo.
Umí to i obrazovky HMI?
Ano. Obrazovky WinCC Unified nafotí z běžící simulace přes webový klient. U starších panelů se data obrazovek čtou z projektu a do návodu se vloží obrázky obrazovek, které dodáte.
V jakých jazycích dokumentace vzniká?
Jazyk textů z projektu zvolíte, AI píše v jazyce, o který ji požádáte. Komentáře a texty projektu umí přeložit přes export do Excelu a import zpět.
Pro jaké verze TIA Portalu?
TIA Portal V17 až V21 na Windows. Některé funkce závisí na verzi: SIMATIC SD dokumenty od V20, oficiální safety signatury a protokol aktivačního testu ve V21.
Kolik to stojí?
Dokumentační nástroje jsou součástí TIA MCP. Licence PRO stojí 295 € ročně za počítač bez DPH a prvních 7 dní můžete TIA MCP vyzkoušet zdarma.
Siemens, SIMATIC, TIA Portal, WinCC a S7 jsou ochranné známky Siemens AG. TIA MCP je samostatný produkt Benešl Automation a není produktem společnosti Siemens; s TIA Portalem pracuje přes oficiální rozhraní Openness.