eVIR tudásbázis

Az MCP szerver nem szabad adatbázis-hozzáférést ad az AI-nak, hanem egy rögzített funkciólistát. Az AI ezek közül választ, a többihez nem fér hozzá — szabad SQL, tömeges export és törlés nincs.

Ez az oldal azt írja le, mit tud pontosan kérdezni és mit tud rögzíteni az AI.

Egy funkció akkor jelenik meg az AI-alkalmazásban, ha mindhárom teljesül:

1. a hozzá tartozó eVIR modul telepítve van ezen a példányon,
2. a felhasználónak van menü-jogosultsága a megfelelő menüponthoz,
3. írási funkciónál a hozzáférés read write jogosultsági körrel lett engedélyezve.

Ezért ugyanaz az eVIR más-más funkciólistát mutat két különböző felhasználónak — ez nem hiba, hanem maga a működési elv. Ha valami hiányzik, a menü-jogosultságot kell megnézni, nem az MCP beállításait.

<note>Az AI-nak érdemes az evir_info funkcióval kezdenie: az megmutatja, mi érhető el egyáltalán az adott munkamenetben. Bizonylatoknál ugyanezt a szerepet a bizonylat_tipusok tölti be.</note>

<note important>A rendeles_teljesitheto válaszában a „raktáron„ a rendelés saját rendelési raktárára vonatkozik — vagyis a rendeléshez már odakészített árura, nem az összes raktárkészletre. A funkció ezt a válaszában ki is mondja, hogy az AI ne olvassa általános készletnek.</note>

A „teljesíthető-e ez a rendelés” kérdés valójában kettő, és a keszlet_forras paraméter választ közülük:

<note important>A foraktar ág rendelésenként függetlenül számol: ugyanazt a készletet több rendelésnél is elszámolja, tehát a teljesíthetőnek jelzett rendelések nem feltétlenül teljesíthetők egyszerre. Foglalás ettől nem történik.</note>

<note>Ha a rendszeren egyetlen raktár sincs főraktárnak jelölve, a foraktar ág nem tippel és nem ad üres listát, hanem hibaüzenetben kimondja, hogy ez a beállítás hiányzik — különben az AI azt olvasná ki, hogy semmi nem teljesíthető. A jelölés helye a raktár-telephely beállításokban van.</note>

A bizonylat_kereses és a bizonylat_adatok egyetlen funkció, amely típus-paraméterrel szolgálja ki az összes bizonylatfajtát. A tipus elhagyása esetén a kimenő számlát keresi.

A lista példányonként eltér: csak az a típus jelenik meg, amelynek a modulja telepítve van, és amelyhez a hívó felhasználónak van menü-jogosultsága. Ezért érdemes bizonylat_tipusok-szal kezdeni, nem találgatni.

Ahol a bizonylat tételt is kaphat, ott háromféle forrás lehetséges — hogy melyik, az bizonylatfajtánként eltér, és a bizonylat_tipusok meg is mondja:

• katalógus — a cikktörzsből, készlettől függetlenül (pl. ajánlat, proforma, beszerzési rendelés),
• raktár — raktári készletről, készletfoglalással (pl. számla, szállítólevél, munkalap, raktárközi mozgás, leltár),
• szolgáltatás — nem készletezett tétel (a legtöbb bizonylaton).

<note>Az ajánlaton nem lehet raktárat választani: az eVIR készlet-keresője itt mindig a rendszer főraktárát használja. A funkció a megadott raktárat ezért hibával utasítja vissza — enélkül a hiba néma lenne (találat nélküli, mégis „sikeres” keresés).</note>

Csak read write jogosultsági körrel érhetők el.

<note important>A bizonylat_letrehozas nem piszkozatot készít: a bizonylat az eVIR saját bizonylat-motorján megy át, szabályos bizonylatszámot kap (pl. AJ2026000123), és megjelenik a listákban — ugyanúgy, mintha a felületen vették volna fel. Az árazás, az ÁFA és a számozás is ugyanonnan jön.
Amit nem tesz: nem nyomtat, nem küld ki e-mailt, nem könyvel, nem ad NAV-adatszolgáltatást, nem sztornóz és nem töröl. A továbbiakat a felhasználó végzi a felületen.</note>

A bizonylat listázása és a felvétele két külön menüpont, tehát két külön jogosultság. Aki lát egy bizonylatlistát, még nem feltétlenül állíthat ki olyan bizonylatot — az MCP is így viselkedik: a bizonylat_tipusok minden típusnál külön kiírja, hogy a hívó felveheti-e.

Egyes bizonylatoknak van olyan fejmezője, ami nélkül nem menthetők. Ezek két csoportba esnek:

Hogy egy adott típusnál mi kötelező, azt a bizonylat_tipusok is kiírja.

<note important>Amit egyetlen funkció sem tud: törölni (semmit, semmilyen formában), számlát kiállítani, bizonylatot könyvelni, e-mailt kiküldeni, törzsadatot módosítani, jogosultságot változtatni, felhasználót létrehozni, beállítást átírni.</note>

• Sorlimit. Minden lekérdezésre kötelező limit kerül (alapértelmezés: 100 sor). A hívó kérhet kevesebbet, többet nem — így nem lehet a funkciókkal adatbázist másolni.
• Méretlimit. A válasz mérethatár felett csonkolódik, és a csonkolás ténye ki is íródik, hogy az AI ne hiányos adatra alapozzon.
• Hívásszám-korlát percenként, hozzáférésenként.
• Naplózás. Minden hívás — a sikertelen is — bekerül a hívásnaplóba.

A határértékek a beállításokban módosíthatók.

A funkciók a találatokhoz eVIR-linket is visszaadnak. Ezek a szokásos, bejelentkezést igénylő felületre mutatnak: az AI válaszából egy kattintással a rendes eVIR-képernyőn lehet folytatni. A link önmagában nem ad hozzáférést senkinek.

Kapcsolódó oldalak:

• eVIR MCP szerver (áttekintés)
• Adatbiztonság
• MCP hívásnapló
• Jogosultsági rendszer