Poptat projekt
Benešl Automation / AI pro TIA Portal / Dokumentace projektu
Návod k obsluze · Předávací dokumentace · I/O checklist · Komentáře bloků · Safety

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.

DokumentCo obsahujeVýstup a nástroj
Návod k obsluzeKusovní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 JSON
tia_manual_collect
tia_manual_schema
tia_manual_render
Screenshoty HMI do návoduObrazovky 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.PNG
tia_manual_screenshots
Aktualizace návodu po změnáchNová 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 revize
tia_manual_update
Předávací dokumentace softwarePř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íchAI 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áloha
tia_block_doc_context
tia_set_block_documentation
Nápověda k vlastním blokůmStrá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 UserFiles
tia_block_help
Diagram sítíSítě LAD a FBD jako v TIA Portalu, bloky S7-GRAPH jako sekvence kroků a přechodů.SVG
tia_block_diagram
Hierarchie voláníGraf volání OB → FB/FC celého PLC.Graf Mermaid
tia_generate_call_hierarchy
I/O list a FAT/SAT checklistAdresa, 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 CSV
tia_generate_io_checklist
tia_export_io_checklist
Safety report a protokolyF-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_report
tia_safety_validation
tia_safety_validation_printout
Servisní report z diagnostikyVýsledek diagnostiky poruchy stroje do servisní dokumentace.HTML a PDF (s Edge nebo Chrome na PC)
tia_diag_report
Změnový reportCo 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.Markdown
tia_change_report
Texty projektu a překladyKomentář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_texts
tia_texts_stats
tia_texts_translation_batch
tia_texts_apply_translations
tia_import_project_texts
Bloky jako čitelné dokumentyBloky a UDT jako SIMATIC SD dokumenty pro code review a archiv. TIA Portal V20 a novější..s7dcl a .s7res
tia_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.

  1. Sběr dat

    AI přečte z projektu hardware, bloky, I/O, obrazovky HMI a alarmy. Projekt se nemění.

  2. Texty od AI

    Z kódu, komentářů a vašeho zadání napíše úvod a popisy obrazovek a bloků do souboru s texty.

  3. Screenshoty

    Z běžící simulace WinCC Unified nafotí obrazovky podle navigace v projektu.

  4. PDF

    Data a texty se vyplní do šablony LaTeX a přeloží do PDF. Bez LaTeXu na PC vznikne zdroj .tex.

  5. Kontrola

    Texty i tabulky projdete a opravíte. Za obsah odpovídá ten, kdo dokumentaci předává.

  6. 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

Git a verze TIA projektů

Testování PLC programu v PLCSIM s AI

Všechny nástroje TIA MCP po oblastech

Č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.