Tudásforrások¶

A tudásforrások lehetővé teszik, hogy az asszisztens a saját anyagaidból válaszoljon: kézikönyvekből, árlistákból, weboldalakról, egy rekordból és annak mellékleteiből. A szöveget darabokra vágja a rendszer, egy beágyazási modell vektorokká alakítja, és a PostgreSQL-ben tárolja. Ha valaki kérdez, megkeresi a leghasonlóbb darabokat, ezekből írja a választ, a számozott hivatkozások pedig megmutatják, honnan származik az egyes állítás.

Követelmények¶

Telepítve kell lennie az AI Knowledge Sources (RAG) modulnak.
Az a PostgreSQL-szerver, amelyhez az Odoo csatlakozik, biztosítsa a pgvector bővítményt (vector). A modul telepítése lefuttatja a CREATE EXTENSION IF NOT EXISTS vector parancsot; ha a bővítmény nem érhető el azon a szerveren, a telepítés érthető üzenettel leáll. A pgvectort magára az adatbázis-szerverre telepítsd, ne az Odoo-szerverre, és győződj meg róla, hogy az adatbázis-felhasználó létrehozhatja a bővítményt.
Dockerrel a bővítménynek az adatbázis-konténer képfájljában kell lennie (például egy pgvectorral készített PostgreSQL-képfájlban), nem az Odoo-konténerben. Ha felügyelt PostgreSQL-szolgáltatást használsz, ott kapcsold be a pgvectort.
Egy beágyazási modell olyan szolgáltatótól, amely kínál ilyet (OpenAI, Google Gemini vagy OpenRouter). Az AI ‣ Konfiguráció ‣ Beállítások oldalon az Beágyazási modell mezőben választhatod ki. A módosítása minden forrást újraindexelésre sorol, mert a különböző modellek vektorait a rendszer sosem hasonlítja össze.

Forrás hozzáadása¶

Nyisd meg az AI ‣ Tudás ‣ Források menüpontot, és hozz létre egy forrást. Válaszd ki a Típus mezőt:

Fájlok: tölts fel PDF-eket, irodai dokumentumokat, OpenDocument-fájlokat vagy egyszerű szöveget.
Weboldal: egy https:// cím. Jelöld be a Bejárás mezőt, hogy ugyanazon webhely más oldalaira mutató hivatkozásokat kövessen, legfeljebb Bejárási mélység lépésnyire és Oldalak max. száma oldalig. A bejáró tiszteletben tartja a webhely robots.txt fájlját (eYssenAIBot néven mutatkozik be), ugyanazon a gazdagépen marad, csak statikus HTML-t olvas (JavaScript nélkül), és soha nem kér le privát hálózati címeket.
Rekord: az adatbázis bármely rekordja; jelöld be az Mellékletekkel együtt mezőt, hogy a mellékleteit is indexelje. A tárolt szöveges mezők indexelődnek, kivéve azokat, amelyeket az asszisztens soha nem olvashat (jelszavak, tokenek és hasonlók).
Mappa: más forrásokat csoportosít egy fában; egy forrást a Mappa mezővel helyezhetsz mappába. Egy mappa újraindexelése mindent sorba állít, ami benne van.

A tudásbázis-cikkek, a dokumentummappák és a felhőben tárolt fájlok további forrástípusként kerülnek hozzá a Knowledge és Documents hidakon keresztül (lásd: AI a Tudásbázisban, a Dokumentumokban és a felhőfájlokban).

Ki használhat egy forrást¶

Elérhető az asszisztens számára kereshetővé teszi a forrást a mindennapi asszisztens számára. Egy ügynök ehelyett a saját forrásaiban keres, amelyeket az ügynök űrlapjának Tudás lapján állítasz be, valamint a globálisakban, ha az Globális források használata is be van kapcsolva.
Az Engedélyezett csoportok és a vállalat korlátozza, ki olvashatja a forrást. A mappák a bennük lévő mindent is korlátoznak.
Bármit is mond a forrás, mindenki csak olyan rekordokból és mellékletekből kap részleteket, amelyeket az Odoo-ban maga is megnyithatna, és csak olyan modellekből, amelyeket az AI hozzáférési szabályai engedélyeznek. Privát vagy archivált rekordra a rendszer soha nem hivatkozik.

Indexelés¶

Az új vagy módosított forrás Függő állapotot kap. Egy ütemezett művelet (AI: tudásforrások indexelése, 10 percenként) feldolgozza a függő forrásokat. Az Indexelés most azonnal feldolgoz egyet, a Újraindexelés újra sorba állítja. Az állapot a Feldolgozás alatt érték után Indexelve lesz; ha valami hibás, az állapot Sikertelen, és a hiba az űrlapon látható. A Részletek gomb mutatja, hány darabot tárolt a rendszer.

A finomhangolás az AI beállításainak Tudásforrások blokkjában található: Részletméret (karakter) és Részletek átfedése (karakter) (alapértelmezés szerint 1500 és 200), Részletek keresésenként (6), Beágyazási dimenziók (a 0 a modell saját méretét jelenti; az OpenAI text-embedding-3 modellek rövidebb vektort is adhatnak), Szövegek beágyazási kérésenként, Beágyazási kérések percenként (elérésekor az indexelés szünetel) és Oldalak max. száma bejárásonként. A beágyazási hívások naplózódnak, és ugyanúgy árazódnak, mint bármely más modellhívás.

Használat: hivatkozások és csak forrásokból¶

Ha van beállított beágyazási modell, és legalább egy indexelt forrás hatókörben van, az asszisztens kereshet a forrásokban. A válasza számozott hivatkozásokkal jelöli az állításokat, és a válasz alatti kattintható címkék mutatják a forrásokat: egy weboldal megnyitja a címét, egy fájl letöltődik, egy rekord megnyitja az űrlapját.

Az AI panel Beszélgetés beállításai beállításai között megjelenik az Válasz csak a forrásokból, ha vannak elérhető források. Bekapcsolva az asszisztensnek kötelezően keresnie kell a forrásokban, és egyértelműen megmondja, hogy nem találta meg a választ, ha a részletek nem tartalmazzák.

Megjegyzés

A forrásokban talált szöveget a rendszer anyagként kezeli, nem utasításként: egy weboldal nem utasíthatja az asszisztenst semmire.

Hasonló feladatok¶

Beágyazási modell beállítása esetén a projektek megtalálhatják azokat a feladatokat, amelyek hasonlítanak az éppen nézettre. A projekt űrlapján, az AI blokkban kapcsold be a Hasonló feladatok bekapcsolva mezőt, és szükség szerint add meg a Hasonlósági küszöb (0 és 1 között, alapértelmezés 0,75) és az Időablak (nap) értékét (0 = nincs korlát). A feladat szövegét (név, leírás és legutóbbi üzenetek) a rendszer 15 percenként a háttérben beágyazza.

A feladatűrlapon ekkor megjelenik egy Hasonló feladatok okosgomb a darabszámmal, például „5, ebből 2 lezárt”. Hasonlóság szerint rendezve nyitja meg a találatokat. A darabszámokat az űrlap megnyitásakor számolja ki a rendszer. Az osztályozás és a jegyes gyorsparancsok ugyanezt a funkciót használják (lásd: AI az SLA-s projektekhez).

Korlátok¶

A darabokhoz kijelzett tokenszámok becslések (a karakterek száma osztva néggyel); a számlázás a szolgáltató saját számait használja az AI naplóban.
A 2000-nél több dimenziós vektorokat a rendszer pontosan (index nélkül) keresi, ami nagy gyűjteményeknél lassabb. Ha lehet, válassz rövidebb vektorméretet.
A weboldalakat statikus HTML-ként olvassa a rendszer; a JavaScripttel felépített tartalmat nem látja.
Ha a hozzáférés nagyon szelektív egy igen nagy gyűjteményen, egy keresés a kértnél kevesebb részletet adhat vissza.