Web spravovaný AI agentem – návod pro vás i pro vašeho asistenta
Web u nás může za vás upravovat váš AI asistent (Claude, ChatGPT a podobní), který umí pracovat se soubory a příkazovým řádkem. Vy mu řeknete, co chcete změnit, on web upraví a nahraje. Tato stránka má dvě části: pro vás a pro vašeho agenta. Tu druhou mu můžete rovnou dát přečíst, nebo mu pošlete odkaz na itrady.cz/llms.txt.
Pro vás: jak to funguje
- Agent dostane stejné přístupy jako člověk: server, uživatele a heslo pro SFTP (údaje máte v našem e-mailu). Heslo zadávejte jen tam, kde ho agent opravdu potřebuje k nahrávání, a nesdílejte konverzace, ve kterých je.
- U běžných tarifů je web statický: HTML, CSS, JavaScript a obrázky. Agent tedy může web postavit a měnit, jak chce, ale na serveru nespustí žádný program (PHP, databázi, Node). Díky tomu je web rychlý a nedá se „hacknout“ přes starý plugin.
- Tarif „Pro AI agenta“ navíc spouští PHP a má vlastní databázi. Agent tak může postavit i web, který něco umí, třeba ukládá přihlášky nebo rezervace. Za kód a data takové aplikace ale odpovídáte vy, viz oddíl o tarifu níže.
- Kontaktní formulář u běžných tarifů zapneme na požádání, napište nám. Agent ho pak jen vloží do stránky podle návodu k formuláři.
- Držte si vlastní kopii webu. U webu nahrávaného přes SFTP máte kopii vždy ve složce, ze které nahráváte (nebo v repozitáři agenta).
- Kdyby se něco pokazilo, napište nám.
Pro vašeho agenta: pravidla serveru
Server: sftp.itrady.cz
Port: 22
Protokol: SFTP (bez shellu; ForceCommand internal-sftp)
Uživatel: web_<slug> (přesně podle e-mailu klienta)
Kořen webu: /web (po přihlášení je tam rovnou; výš nevidí)
Úvodní str.: /web/index.html (u tarifu „Pro AI agenta“ i index.php, viz níže)
Otisk: ED25519 SHA256:22nvqPGbVOc/7S6GGcJ1m3/QcRfd2NcSm+I/SDZeIg0
Co funguje: sftp (vč. put -r), scp -r jen s OpenSSH 9 a novějším (jede přes SFTP; ověř ssh -V).
Co nefunguje: rsync, ssh s příkazy, jakýkoli shell. Účet má jen SFTP.
Obsah webu:
- Běžné tarify: jen statické soubory:
.html,.css,.js, obrázky (.jpg,.png,.webp,.svg),.pdf, písma. PHP, CGI ani serverové skripty se nespustí (jedinou výjimkou je formulář, jehož serverovou část zapínáme my). - Tarif „Pro AI agenta“: navíc PHP 8.4 a databáze MariaDB, pravidla viz oddíl o tarifu níže.
- HTTPS a certifikát řeší server automaticky. Neřeš ho.
- Mezipaměť (hlavička Cache-Control): HTML 5 minut,
/assets/1 den,/_astro/1 rok (jen weby z našeho systému), ostatní soubory podle Last-Modified/ETag. Má-li být změna CSS/JS/obrázku vidět hned, změň název souboru (např.styl.20261001.css). - Vlastní 404: stačí
404.htmlv kořeni webu (server ji používá automaticky). .htaccessv omezeném rozsahu: fungujeRedirect,RewriteRule,ErrorDocument,Header,AddType,DirectoryIndex. Nefunguje: hesla (AuthType/Require),php_value, spouštění skriptů,Options +ExecCGI/+FollowSymLinks. Soubory.ht*,.git,.env,.user.iniserver nikdy nevydá. Na přesměrování a 404 nic dalšího nepotřebuješ.- Kontaktní formulář (běžné tarify):
<form method="post" action="/odeslat.php">přesně podle /napoveda/formular/ (povinná polejmeno,email,zprava,souhlas; pastweb;casvyplněný JavaScriptem; návratzpet). Vlastní pole NEpojmenovávejweb,casanizpet.odeslat.phpnenahrávej, dodává ho server. Formulář u webu zapíná ITRADY na požádání majitele. Když/odeslat.phpvrací 403/404, ještě zapnutý není.
Postup, který doporučujeme:
- Stáhni si aktuální obsah
/webdo pracovní složky (sftp:get -r /web) a pracuj na kopii. - Změny ověř lokálně (otevři
index.htmlv prohlížeči, zkontroluj odkazy). - Nahraj jen změněné soubory (
put), u nových složekput -r. - Nic nemaž hromadně. Když je potřeba smazat, smaž konkrétní soubory.
- Ověř výsledek na živém webu (HTTPS) a u nových assetů použij nový název souboru.
Statistiky návštěvnosti: https://<doména>/webstats/, přihlášení HTTP Basic: uživatel = název domény (např. vasedomena.cz), heslo je jiné než k SFTP (majitel ho má na jednorázovém odkazu).
Strojově čitelná verze (JSON) se připravuje, zatím jen HTML přehled.
Místo na disku: technické kvóty nejsou, platí rozumné užívání (fair use). Obrovské soubory (videa, archivy) patří jinam, třeba na YouTube.
Tarif „Pro AI agenta“: PHP a databáze
Tarif „Pro AI agenta“ se od ostatních liší tím, že web nemusí být jen statický: server u něj spouští PHP a web má vlastní databázi. Běžné tarify zůstávají statické. Který tarif web má, poznáte z uvítacího e-mailu: u tarifu „Pro AI agenta“ v něm je oddíl DATABÁZE s údaji pro připojení.
Pro vás: za server odpovídáme my, za kód a data aplikace vy. Proto agentovi zadejte hlavně tři věci: administrace musí být za heslem, vstupy z formulářů musí být ošetřené a ukládat se má jen to, co web opravdu potřebuje. Export databáze (dump) vám na požádání pošleme. Agent může do aplikace přidat i vlastní export dat, třeba CSV v administraci.
Pro agenta:
PHP: 8.4, vlastní izolovaný proces webu
Databáze: MariaDB 11.8 (kompatibilní s MySQL)
Host: localhost (unixový socket)
Uživatel: web_<slug> (stejný jako pro SFTP)
Heslo: žádné – server ověřuje systémový účet webu
Název DB: podle uvítacího e-mailu (oddíl DATABÁZE)
Zvenku: do databáze se připojit nedá
Připojení z PHP (PDO):
$db = new PDO('mysql:host=localhost;dbname=<databáze z e-mailu>;charset=utf8mb4', '<uživatel webu>', '');
NEpoužívej 127.0.0.1, databáze neposlouchá na síti. Připojuj se přes localhost.
- Heslo k databázi do kódu nepiš, žádné není. Ve webu tak nezůstane nic, co by šlo ukrást.
- Tabulky založ instalačním PHP skriptem: nahraj ho, jednou spusť a hned ho smaž. Import hotového dumpu (SQL) udělá ITRADY na požádání majitele.
- Dotazy jen připravené (
preparea parametry). SQL nikdy neskládej z textu, který poslal návštěvník. - Úvodní stránka je
index.phpneboindex.html. Když jsou ve složce oba, má přednostindex.php. - Administraci chraň přihlášením v aplikaci.
AuthTypeaRequirev.htaccessnefungují (server vrátí chybu 500).Redirect,RewriteRuleaErrorDocumentfungují. - Ukládej jen nutná data, u osobních údajů dvojnásob.
- E-maily z aplikace posílej PHP funkcí
mail(). Funguje až po zapnutí na požádání majitele, k tomu pošleme pár záznamů do DNS. Odesílá se zwebform@<doména>, nejvýš 30 za hodinu a 100 za den. Kód žádné heslo nepotřebuje. - Pravidelné úlohy zapíná ITRADY na požádání majitele.
- Kontaktní formulář zpracuj vlastním PHP. Sdílený
/odeslat.phpu tohoto tarifu není. - Nefunguje: shell, trvale běžící programy (Node.js, servery v Pythonu), přístup k jiným webům. Node.js používej jen u sebe na build a na server nahraj výsledek.
Co agent nedostane (a proč)
- Žádný shell ani trvale běžící programy na serveru, a to ani u tarifu „Pro AI agenta“: server hostuje desítky webů a ty musí zůstat v bezpečí.
- Žádný přístup k poště ani DNS: to nastavujeme my na požádání.
- Heslo nikdy nepošleme agentovi ani do chatu. Dostává ho jen majitel webu přes jednorázový odkaz.