Rozdíly

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

--- techdoc:aiassist [10.09.2025 08:32] – turych
+++ techdoc:aiassist [10.09.2025 13:28] (aktuální) – turych
@@ Řádek 11: / Řádek 11: @@
 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. V případě provozu zákazníka na našem cloudu tuto služnu instalujeme my. 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.\\
+Pro nastavení asistenta s online Podporou není třeba nic dalšího instalovat, služba běží na portále společnosti ESO9 international a.s. Pro zpřístupnění této služby zákazníkovi je třeba zažádat si u naší společnosti o 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 služby 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 ===
@@ Řádek 18: / Řádek 18: @@
 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.
+  * //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.
+  * //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
+  * Tabulky a pohled //CINNOST, CINPRILOHA, UZIVATEL, PARAM, QKONVERZACE_TEMA// - 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
+  * Funkce //fnHodnotaParUziv_Varchar// - oprávnění pro EXECUTE
+  * Funkce //fnUSerParams// - oprávnění pro SELECT
+  * Procedury //spTXT_KONVERZACE, spTXT_KONVERZACE_TEMA// - oprávnění pro EXECUTE
+== AI asistent - databázová oprávnění - SQL skript ==
+Následující skript provede nastavení oprávnění pro roli //eso9ai_role//:
+<code>
+-- založení role v databázi
+USE [< DBname , sysname, >]
+CREATE ROLE [eso9ai_role]
+GO
+-- procedury v roli
+USE [< DBname , sysname, >]
+GRANT SELECT ON CINNOST TO [eso9ai_role]
+GRANT SELECT ON CINPRILOHA TO [eso9ai_role]
+GRANT EXECUTE ON [dbo].[fnHodnotaParUziv_Varchar] TO [eso9ai_role]
+GRANT SELECT ON [dbo].[fnUSerParams] TO [eso9ai_role]
+GRANT DELETE ON KONVERZACE TO [eso9ai_role]
+GRANT INSERT ON KONVERZACE TO [eso9ai_role]
+GRANT SELECT ON KONVERZACE TO [eso9ai_role]
+GRANT UPDATE ON KONVERZACE TO [eso9ai_role]
+GRANT DELETE ON KONVERZACE_TEMA TO [eso9ai_role]
+GRANT INSERT ON KONVERZACE_TEMA TO [eso9ai_role]
+GRANT SELECT ON KONVERZACE_TEMA TO [eso9ai_role]
+GRANT UPDATE ON KONVERZACE_TEMA TO [eso9ai_role]
+GRANT SELECT ON PARAM TO [eso9ai_role]
+GRANT SELECT ON QKONVERZACE_TEMA TO [eso9ai_role]
+GRANT EXECUTE ON spTXT_KONVERZACE TO [eso9ai_role]
+GRANT EXECUTE ON spTXT_KONVERZACE_TEMA TO [eso9ai_role]
+GRANT SELECT ON UZIVATEL TO [eso9ai_role]
+GO
+GO
+-- založení sql loginu
+USE [master]
+CREATE LOGIN [eso9api.ai.< DBname , sysname, >] WITH PASSWORD=N'<login_password,varchar,>', DEFAULT_DATABASE=[< DBname , sysname, >], CHECK_EXPIRATION=OFF, CHECK_POLICY=ON
+-- Na Cloud ESO9:
+-- ALTER SERVER ROLE [ESO_SQLUser] ADD MEMBER [eso9api.ai.< DBname , sysname, >]
+GO
+-- přiřazení sql loginu do role v databázi
+USE [< DBname , sysname, >]
+CREATE USER [eso9api.ai.< DBname , sysname, >] FOR LOGIN [eso9api.ai.< DBname , sysname, >]
+ALTER ROLE [eso9ai_role] ADD MEMBER [eso9api.ai.< DBname , sysname, >]
+GO
+</code>