PŘÍPADOVÁ STUDIE / KECALO
Co si v hotovém systému nastavíte sami
Kecalo je asistent, který odpovídá výhradně z nahraných dokumentů a u každé odpovědi řekne, odkud ji má. Tahle stránka není o modelu — je o tom, co si v dodaném systému nastaví váš člověk, bez vývojáře a bez nasazení. Znalostní báze, chování bota, oprávnění, poptávky i agenda osobních údajů se ovládají z administrace.
- sekcí administrace
- 10sekcí administrace
- parametrů laditelných za běhu
- 15parametrů laditelných za běhu
- úrovně oprávnění
- 3úrovně oprávnění
- nasazení ke změně chování bota
- 0nasazení ke změně chování bota
Znalostní bázi mění byznys, ne dodavatel
Nahrání souboru je celá integrace. Chování bota se ladí posuvníkem a přepisuje v textovém poli — obojí platí okamžitě.
- Nahrání přetažením — PDF, TXT a MD do 20 MB. Zpracování běží samo: extrakce textu, odstranění záhlaví a patiček, rozdělení podle částí a článků, výpočet embeddingů, uložení. Obsluha jen sleduje stav.
- Chyba se vysvětlí — u neúspěšného dokumentu je vidět důvod, ne jen červený štítek. Reindexace je jedno kliknutí, bez opětovného nahrávání souboru.
- Patnáct parametrů vyhledávání — počet pasáží v kontextu, práh podobnosti, teplota modelu, velikost pasáží. Administrace sama rozlišuje, co se projeví okamžitě a co až po reindexaci, a u druhé skupiny na to upozorní.
- Prompty v textovém poli — jak bot mluví, co smí a jak cituje zdroje. Karta je proti překlepu zamčená a systém pojmenuje instrukce, které nesmíte smazat, protože by vypnuly sběr poptávek nebo oslabily ochranu proti podvrženým instrukcím.
- Návrat na dodávané znění jedním kliknutím — u každého promptu i u celé sady parametrů.
Zastará-li konfigurace, systém sám označí dokumenty, které je potřeba přeindexovat. Nikdo nemusí pamatovat, co se kdy měnilo.
Když bot odpoví špatně, dohledáte proč
Než se zeptá klient, zeptáte se vy — a vidíte přesně, z čeho by bot odpovídal.
- Libovolný dotaz vrátí pasáže, které by šly modelu do kontextu — dřív, než je uvidí zákazník.
- Skóre podobnosti v procentech u každé pasáže. Poznáte rozdíl mezi jistým a nataženým zásahem.
- Přesná adresa nálezu: soubor, strana a cesta v dokumentu — část › článek › odstavec. Celý text pasáže jde rozbalit, když je potřeba ověřit znění.
Reklamace odpovědi se tím vyřeší za minutu: buď je chyba v datech, nebo v nastavení, a je to vidět. Bez takového nástroje zbývá hádání — a to je rozdíl mezi systémem a demem.
Kvalita je měřitelná, ne dojmová
Každý dotaz nechává záznam. Hodnocení sbírá aplikace sama, ne dotazník po půl roce.
- Záznam u každého dotazu s latencí a spotřebou.
- Palce nahoru a dolů přímo v chatu se ukládají jako skóre; administrace z nich počítá spokojenost v poměru i v procentech.
- Automatické vyhodnocení nad testovacími sadami — zhoršení kvality odpovědí poznáte z čísla, ne ze stížnosti.
- Stav báze na jeden pohled: počet dokumentů, pasáží a zaindexovaných stran, rozpad stavů a graf, ze kterého je vidět, který podklad bázi váhově ovládá.
Jedna báze, různá publika
Dokument je veřejný, nebo omezený na štítky. Vyhledávání filtruje už v databázi, ne až v odpovědi.
- Štítky dokumentů (například Právní oddělení nebo Interní metodika) se zakládají a přejmenovávají v administraci; u každého je vidět počet navázaných dokumentů, takže je zřejmé, co by smazání rozpojilo.
- Štítek nikdy nedostane uživatel přímo — vždy jen přes pracovní roli. Odebrání role odebere přístup naráz a bez výjimek.
- Pracovní role se jmenují slovy z organizace — „Vedoucí účtárny“, ne technický identifikátor. Přidání štítku k roli zpřístupní obsah všem jejím nositelům.
- Účty zakládá správce, hesla nevidí — aplikace heslo vygeneruje, ukáže právě jednou a v databázi drží jen otisk. První přihlášení vynutí změnu.
- Oprávnění se čte při každém požadavku, ne z přihlašovací cookie. Odebrání práv platí okamžitě, ne až po odhlášení, a kontrola drží na každé serverové operaci zvlášť.
Přihlášení firemním účtem přes OIDC je v aplikaci připravené včetně překlápění skupin z adresáře na pracovní role. Proti reálnému firemnímu adresáři je zatím neověřené — napojení je otázka konfigurace, ne vývoje.
Agenda osobních údajů se vyřídí na obrazovce
Žádost podle GDPR nevyžaduje e-mail dodavateli ani zásah do databáze.
- Retenční lhůty zvlášť pro poptávky a zpětnou vazbu, 1 až 120 měsíců, s automatickým denním úklidem.
- Vyhledání subjektu podle e-mailu nebo telefonu — bez ohledu na velikost písmen a formát čísla.
- Export do JSON pro právo na přístup a přenositelnost (čl. 15 a 20) a trvalý výmaz na žádost (čl. 17) včetně navázaných hodnocení.
- Auditní historie úkonů s otiskem subjektu místo jeho kontaktu — evidence sama nesmí být další databází osobních údajů.
- Právní titul u každého záznamu, uložený v okamžiku sběru — doložitelný i po pozdější změně konfigurace.
Veřejné zásady zpracování si lhůty čtou z nastavení, místo aby je opisovaly. Změna lhůty v administraci proto nemůže udělat ze zveřejněného dokumentu nepravdu.
Z konverzace vypadne kontakt, ne přepis chatu
Obchodník čte, co člověk chtěl — ne surový dotaz.
- Kontakt s kontextem: jméno, e-mail nebo telefon a k tomu automatické shrnutí konverzace.
- Dva typy záznamu: zájem o produkt, který bot pozná sám z povahy dotazu, a kontakt zanechaný po záporném hodnocení odpovědi.
- Workflow nová → převzatá → uzavřená se jménem zpracovatele. Poptávky se nemažou, jen uzavírají — historie zůstává průkazná.
- Deduplikace podle kontaktu — druhý dotaz téhož člověka rozšíří existující záznam místo zakládání dubletu.
- Sběr kontaktů jde vypnout — u interního nasazení nedává smysl.
Kdo co smí
Tři aplikační role. Vodicí pravidlo: editor spravuje obsah a agendu, ne systém — chování bota a přístupy zůstávají správci.
| Činnost | Čtenář | Editor | Správce |
|---|---|---|---|
| Prohlížet dokumenty, testovat retrieval, číst parametry | ano | ano | ano |
| Nahrávat, reindexovat a mazat dokumenty | ne | ano | ano |
| Zpracovávat poptávky | ne | ano | ano |
| Měnit parametry vyhledávání a prompty | ne | ne | ano |
| Spravovat uživatele, pracovní role a štítky | ne | ne | ano |
| Retence, výmazy a žádosti subjektů | ne | ne | ano |
Skrytí položky v menu je jen kosmetika. Kontrola oprávnění drží na každé serverové operaci zvlášť a čte se z databáze při každém požadavku.
Co zatím neumí
Dvě věci, které do dodávky patří a hotové nejsou. Píšeme je sem proto, že se na ně stejně zeptáte — a lépe dřív než po podpisu.
v přípravě
Widget na cizí web
Vložení chatovací bubliny na existující web jedním řádkem skriptu. Dnes chat běží jen na vlastních stránkách aplikace.
v přípravě
Strop provozních nákladů z administrace
Denní limit útraty a sdílené omezení počtu dotazů pro veřejné nasazení. Dnes se hlídá na úrovni provozu, ne přepínačem v administraci.
Ukázková instance odpovídá nad pojistnými podmínkami fiktivní pojišťovny. Obor není v aplikaci nikde zadrátovaný — bázi tvoří nahrané dokumenty, ať jde o pojišťovnu, výrobní firmu nebo úřad.
Stejnou disciplínu aplikujeme na váš proces.
Kecalo není produkt, který bychom vám prodávali. Je to doklad, jak vypadá systém, který od nás převezmete: s administrací pro vaše lidi, s doložitelnými odpověďmi a s kódem, který běží u vás. Nejpozději do dvou týdnů postavíme totéž na vašich datech.