ESO9 wiki

Tato stránka je pouze pro čtení. Můžete si pouze prohlédnout zdrojový kód, ale ne ho měnit. Zeptejte se správce, pokud si myslíte, že něco není v pořádku.
==== AI asistent a online Podpora ====
Do aplikací ESO9 přibyla možnost využívat AI asistenta a (živého) asistenta s online Podporou. Obě možnosti jsou zapojeny do dialogu "//AI asistent//", který se zobrazuje v každém formuláři vpravo dole. Oba asistenti využívají členění konverzace do témat pro jejich lepší přehled.\\
=== AI asistent ===
AI asistent využívá pro dotazy uživatelů engine //Open AI// (aka //Chat GPT//). Počítá tedy s některou z placených variant této služby. Pro generování odpovědí uživatelům využívá primárně nápovědu k dané činnosti, pokud se v některé z odpovědí vyskytne i odkaz na naší wiki, použije se i obsah odkazovaného dokumentu. Dále se používá se nápověda ke klávesovým zkratkám. V budoucnu bude kontext uživatelských odpovědí obsahovat i nejvíce relevantní úryvky ze všech dostupných dokumentací uložených v databázi znalostí ESO9. Limitem je pouze omezení dané počtem tokenů, které lze na API rozhraní odeslat v rámci jednoho volání, tj. pro udržení kontextu. Komunikace s AI přes API je bezestavová, tj. veškerý kontext, který je nutný pro generování odpovědí, je třeba poslat AI zároveň s dotazem uživatele. Např. model "//GPT-4-turbo//" má omezen jeden dotaz na 128tis. tokenů. Protože je API zpoplatněno právě na počet tokenů, může být využití velmi širokého kontextu dražší. Bližší informace o cenách předplatného lze najít na [[https://openai.com/api/pricing/]].
V budoucnu nebude problém pro sestavení odpovědí zapojit i další enginy (např. //Claude//, //Deep Seek// aj.).\\
=== Online Podpora ===
Pokud odpovědi od AI nedostačují nebo je problém složitější, lze se v dialogovém okně ikonou uživatele přepnout na online chat s pracovníkem naší Podpory. Při inicializace konverzace s Podporou se stáhnou dostupné informace o uživateli (kód uživatele, jeho e-mail a funkce; vše z tabulky uživatelů v aplikaci) a formuláři (URL). Pracovník Podpory má tak k dispozici základní kontext uživatelovy otázky. V rámci dialogu s Podporou lze kromě textové komunikace i odesílat či přijímat soubory (např. screenshoty). Pokud pracovník Podpory neodpoví zákazníkovi ihned, popř. zákazník nečeká na odpověď a pokračuje v práci v aplikaci, zobrazí se mu v okamžiku příchodu zprávy z Podpory překryvná ikona s počtem nepřečtených zpráv. A naopak pracovníkovi Podpory přijde notifikace dotazu od uživatele standardním mechanismem vyhodnocení událostí. Komunikace s Podporou se na naší straně ukládá a v budoucnu může být předmětem fakturace. Proběhlá konverzace je samozřejmě k dispozici i uživateli pro případ, že by se chtěl v budoucnu ptát na totéž, případně navázat na původní konverzaci např. novým poznatkem.\\
=== Konfigurace ===
Oba asistenti se konfigurují v aplikačních parametrech ve skupině "//AI Assist//":
Parametr "//ESO9AIsvcURL//" obsahuje URL adresu služby //ESO9AIsvc//. Ta se jednorázově instaluje v rámci infrastruktury zákazníka; podrobnější popis je uveden v samostatné kapitole. Jedna webová služba //ESO9AIsvc// obsluhuje jednu aplikaci ESO9. Pro ověření přístupu k této službě se využívají přístupové údaje uvedené v parametrech "//ESO9AIsvcName//" a "//ESO9AIsvcPwd//". V rámci konfigurace pouze AI asistenta může být hodnota těchto parametrů libovolná, jde jen o to neumožnit využívat (předplacené) Open AI API libovolným klientům bez ověření. Pokud zákazník nechce AI asistenta používat, postačí ponechat hodnotu parametru "//ESO9AIsvcURL//" prázdnou, což je zároveň výchozí hodnota po instalaci nové verze.\\

Pro nastavení asistenta s online Podporou je třeba zpřístupnit tuto službu zákazníkovi ze strany společnosti //ESO9 international a.s.// Výsledkem budou přístupové informace (jméno/heslo), které si zákazník nastaví ve své aplikaci v parametrech "//ESO9AIsvcName//" a "//ESO9AIsvcPwd//". Dalším parametrem je "//ESO9CustSuppSvcURL//" s URL adresou online Podpory. Pokud zákazník nechce online Podporu využívat, postačí ponechat hodnotu parametru "//ESO9CustSuppSvcURL//" prázdnou, což je zároveň výchozí hodnota po instalaci nové verze.\\

=== Instalace služby AI asistenta ===
//ESO9 AI asistent// funguje jako samostatný web (webové API) na webovém serveru IIS (Internet Information Server), který je součástí všech serverových edicí MS Windows Serveru. Instalace tedy počítá s existujícím a funkčním prostředím IIS.\\
Instalační soubory pro tuto službu jsou k dispozici na adrese [[https://podpora.eso9.cz/download/ESO9%20AI%20Asistent/]].\\
Postup instalace a zprovoznění služby je podobný instalaci //ESO9 JSON API//, která je detailně popsána {{ :techdoc:eso9_json_api.pdf |zde}}.\\
Po instalaci je nutné službu jednorázově nakonfigurovat. Veškerá konfigurace se týká souboru //appsettings.json// ve webu služby (typicky C:\inetpub\wwwroot\ESO9AIsvc\appsettings.json). Konfigurační soubor obsahuje zejména:\\
  * OpenAI_API_Key - klíč pro přístup k API rozhraní Open AI. Klíče jsou dostupné na adrese [[https://platform.openai.com/api-keys]]. Po úhradě předplatného se na základě tohoto klíče počítají spotřebované tokeny.
  * ConnectionStrings / AppDB - připojovací řetězec k aplikační databázi.
== AI asistent - databázová oprávnění ==
V aplikační databázi je třeba povolit přístupy k těmto objektům:\\
  * Tabulka CINNOST - oprávnění pro SELECT
  * Tabulka ESO9START.DBO.CINPRILOHA - oprávnění pro SELECT
  * Tabulka KONVERZACE, KONVERZACE_TEMA - oprávnění pro SELECT, DELETE, INSERT a UPDATE
  * Procedury spTXT_KONVERZACE a spTXT_KONVERZACE_TEMA - oprávnění pro EXECUTE