Rozdíly

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

--- techdoc:aiassist [15.04.2025 11:46] – 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.).\\
 === Online Podpora ===
@@ Řádek 8: / Řádek 8: @@
 === 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. 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.\\
+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 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}}.
+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