AI asistent a MCP
E-shop dokáže pomocí umělé inteligence odpovídat na dotazy týkající se jeho dat. K dispozici jsou dva způsoby:
- AI asistent v administraci – chat v administraci Edee.one, který se otevírá tlačítkem Asistent v jejím pravém dolním rohu
- MCP server – připojení externích AI nástrojů (například Claude Code nebo Codex) k datům e-shopu přes protokol MCP (Model Context Protocol)
Oba způsoby používají stejné nástroje a řídí se stejnými oprávněními. AI vždy pracuje pod účtem přihlášeného uživatele a vidí jen to, co tento uživatel vidí v administraci. Odpovídá v jazyce dotazu; názvy produktů a dalších záznamů ponechává tak, jak jsou v datech.
E-shopové nástroje data pouze čtou. Nemění ceny, stavy objednávek, produkty ani zákazníky. Požádá-li uživatel o změnu, AI zpravidla sdělí, že ji nemůže provést, a nabídne odkaz do administrace, kde ji uživatel může provést sám.
Co AI umí
Katalog
- Vyhledá produkty, kategorie, značky, skupiny produktů, způsoby dopravy a platby – podle názvu, kódu, EAN, štítku, kategorie, značky nebo data vytvoření a změny.
- Zobrazí detail produktu: texty, ceny a ceníky, zařazení do kategorií, varianty, média a skladové zásoby.
- Najde například chybějící popisy, hlavní obrázky, URL, povinná pole produktu nebo hodnoty parametrů, podle kterých se tvoří varianty. Kontroluje také ceny, zařazení do kategorií, možné duplicity a kategorie, značky či skupiny bez viditelných produktů.
- Vysvětlí, proč se produkt na webu zobrazuje nebo nezobrazuje, případně proč ho nelze objednat.
Příklady dotazů:
- Kolik produktů nemá český popis?
- Najdi produkt Taška easy a jeho varianty.
- Proč se produkt XY nezobrazuje na webu?
Prodeje a sklad
- Zobrazí počet objednávek, tržby objednávek, tržby položek, prodané kusy a průměrnou hodnotu objednávky za zvolené období – celkem nebo po dnech, týdnech a měsících.
- Rozdělí výsledky podle způsobu dopravy a platby a podle země nebo regionu doručení a fakturace.
- Rozdělí výsledky podle produktu, kategorie a značky – zde uvádí jen počet objednávek, tržby položek a prodané kusy. Jedna objednávka se může započítat do více řádků.
- Srovná výsledky s předchozím obdobím nebo se stejným obdobím loňského roku.
- Zobrazí skladové zásoby: produkty, kterým docházejí zásoby, produkty skladem bez zaznamenaného prodeje a skladové položky vybraných produktů.
Stornované objednávky se do reportu standardně nezapočítávají; na vyžádání je lze zahrnout. Při rozdělení podle zemí a regionů se nezobrazují skupiny s méně než pěti zákazníky.
Příklady dotazů:
- Jaké byly tržby za minulý měsíc oproti loňsku?
- Které produkty jsou skladem, ale za poslední dva měsíce se neprodaly?
Objednávky a reklamace
- Vyhledá objednávky a reklamace či vratky podle čísla, stavu, produktu nebo stáří, včetně objednávek čekajících na expedici a otevřených reklamací.
- Zobrazí stav, historii změn stavu, položky, platbu, dopravu a navázané reklamace.
Příklady dotazů:
- Je objednávka 2025000123 už odeslaná?
- Které zaplacené objednávky čekají na expedici déle než 3 dny?
- Jaké reklamace jsou otevřené k produktu XY?
Zákazníci
- Vyhledá registrované zákazníky podle e-mailu nebo loginu, případně podle telefonu, IČO či názvu firmy, pokud e-shop tyto údaje eviduje. Zobrazí přehled jejich účtu.
- Seřadí zákazníky podle útraty.
Tyto dotazy pracují s osobními údaji a jsou dostupné jen tehdy, když to dovoluje nastavená úroveň přístupu k osobním údajům (viz část Osobní údaje). Uživatel navíc potřebuje právo k zobrazení registrovaných uživatelů webu.
Nápověda k administraci
AI hledá odpovědi na otázky typu „jak v administraci…“ v uživatelské a funkční dokumentaci EdeeShopu na doc.edee.one a uvádí odkaz na příslušnou kapitolu. Pokud dokumentace postup nepopisuje, AI to sdělí.
- Kde nastavím dopravu zdarma?
- Jak skryju produkt z nabídky?
Oprávnění
O tom, kdo může AI používat, rozhodují práva v administraci (bezpečnostní modul AI integration). Právo ke spuštění (EXECUTE) se přiděluje zvlášť pro každou oblast:
| Oblast | Identifikátor |
|---|---|
| Katalog | shopCatalog |
| Prodeje a sklad | shopSales |
| Objednávky a reklamace | shopSupport |
| Zákazníci | shopCustomers |
| Nápověda | shopHelp |
- Uživatel, který nemá právo k žádné oblasti AI (e-shopové ani obsahové), AI asistenta v administraci nevidí. Uživatel s právem pouze k obsahovým oblastem Edee.one asistenta vidí, ale asistent mu na dotazy k e-shopu neodpoví.
- Nástroje oblasti, ke které uživatel právo nemá, AI vůbec nenabídne.
- Právo pro oblast Zákazníci je samostatné a má se přidělovat jen rolím, které v administraci pracují se zákazníky.
- Nad těmito právy platí běžná práva uživatele: AI nezobrazí katalog, objednávky ani zákazníky, ke kterým uživatel nemá přístup.
Osobní údaje
Způsob, jakým AI zachází s osobními údaji zákazníků (jmény, e-maily, telefony a adresami), určuje nastavení instalace. Výchozí nastavení je nejpřísnější.
| Úroveň | Chování |
|---|---|
| Bez osobních údajů (NONE, výchozí) | AI osobní údaje nezobrazí a nehledá podle nich. Dotazy typu „kdo objednal“ nebo „jaký e-mail má zákazník“ odmítne. |
| Jen vyhledávání (SEARCH_ONLY) | AI smí vyhledat objednávku podle e-mailu či telefonu a zákazníka podle e-mailu, loginu, telefonu, IČO nebo názvu firmy, ale osobní údaje ve výsledku nezobrazí. Žebříček zákazníků podle útraty není dostupný. |
| Čtení (READ) | AI zobrazí osobní údaje objednávek včetně kontaktů a adres a kontaktní údaje registrovaných zákazníků. U zákaznického účtu uvádí jen počet adres, ne jejich obsah. Umí také seřadit zákazníky podle útraty. |
Při hledání podle telefonu nezáleží na mezerách a dalších oddělovačích. Číslo zadané bez předvolby země najde i stejné číslo uložené s předvolbou a naopak.
O změnu úrovně v konfiguraci e-shopu se stará dodavatel řešení.
Připojení přes MCP
MCP server je dostupný na adrese administrace:
https://<adresa administrace>/api/mcp/<název serveru>Název serveru a přesnou adresu sdělí dodavatel řešení.
Přihlášení
AI nástroj lze připojit pomocí existujícího účtu administrace. Používá stejné jméno a heslo, kterými se uživatel přihlašuje do Edee.one. Přihlašovací údaje posílá s každým požadavkem v hlavičce Authorization (standard HTTP Basic; jméno a heslo ve tvaru login:heslo zakódované do Base64). Příklad připojení v Claude Code:
claude mcp add --transport http edee https://<adresa administrace>/api/mcp/<název serveru> --header "Authorization: Basic <login:heslo v Base64>"Přes MCP server jsou kromě e-shopových nástrojů dostupné i obsahové nástroje Edee.one (stránky, hromadné operace, mailing). Ty mohou měnit data, pokud k tomu má účet právo; uživatel změnu před jejím provedením potvrzuje v připojeném nástroji.
Omezení
- Odpovědi mají omezenou délku; AI načítá dlouhé seznamy po částech a na další část je možné se doptat.
- Report prodejů pokrývá v jednom dotazu nejvýše 25 měsíců.
- Instalace má nastavený denní a měsíční limit spotřeby AI. Po jeho vyčerpání asistent dotaz odmítne a sdělí, kdy se limit obnoví. Výši limitu nastavuje dodavatel řešení.
- Nápověda čerpá jen z dokumentace EdeeShopu, nikoli z nastavení konkrétní instalace.
- AI se může splést. Před rozhodnutím nebo změnou dat je potřeba údaje ověřit v administraci; AI k záznamům uvádí odkaz do administrace, pokud je k dispozici.