Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

--- techdoc:aiassist [29.05.2025 11:22] – turych
+++ techdoc:aiassist [09.07.2025 11:39] (aktuální) – turych
@@ Řádek 2: / Řádek 2: @@
 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//). 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 lze zdroje pro generování odpovědí rozšiřovat, 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/]].
+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.).\\
-Konfigurace asistenta se provádí v nainstalované službě (//ESO9AIsvc//) v souboru //appsettings.json//. Základními konfiguračními prvky služby jsou:
-  * "AppSettings":"OpenAI_API_Key" - klíč k OpenAI API, který si vygenerujete pod svým účtem na webu OpenAI. Po úhradě předplatného se na základě tohoto klíče počítají použité tokeny.
-  * "ConnectionStrings":"AppDB" - připojovací řetězec k aplikační databázi.
 === 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.\\
@@ Řádek 14: / Řádek 11: @@
 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 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.\\
+//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]].
+  * 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