Saját AI ügynök az Europaius jogi korpusza felett

Interaktív használatra a szokásos OAuth bejelentkezés zajlik a böngészőben; az MCP SDK ezt Pythonban és TypeScriptben is kezeli. Szerveroldali ügynökök és automatizációk esetén az Europaius árlistájában szereplő API kulcsot használhatja: bejelentkezéskor az e-mail helyett ezt adja meg, vagy saját OAuth kliens egyszer végrehajtja az autorizációt, és elmenti a frissítő tokent. A kulcs eur_ előtaggal kezdődik, és a fiókhoz, valamint annak korlátaihoz van kötve.

• search(query, states): JSON-t ad vissza {"results":[{id,title,url,snippet}]} formátumban, jogszabályok és ítélkezési gyakorlat körében.
• fetch(id): a dokumentum teljes szövege azonosító alapján, metaadatokkal együtt (bíróság, dátum, ECLI, ország).
• search_law, find_caselaw, find_caselaw_cz: célzott keresés jogszabályokban vagy ítélkezési gyakorlatban, paraméterekkel.
• get_paragraf(state, law, paragraf): § pontos szövege a törvény száma alapján.
• souvislosti(para_id): a paragrafus ellenőrzött hivatkozási kapcsolatai.
• compare_norm(query, states): a legrelevánsabb rendelkezések az egyes országokból.
• vyklad, list_states: cseh paragrafus értelmezése, a lefedettség áttekintése.

A search eszköz által visszaadott azonosítók stabilak, elmenthetők. Cseh bírósági határozatok: case:<soud>:<slug>, ahol a bíróság értéke ns, nss, us vagy justice lehet – ezek cseh bírósági forrásokra utalnak. Paragrafus: para:CZ:89/2012:§2991. Külföldi ország dokumentuma: eu:DE:<id>. A fetch eszköz határozatoknál a jogi tételt, a rendelkező részt és az indokolást egy szövegben adja vissza, legfeljebb 80 ezer karakter terjedelemben.

from mcp import ClientSession; from mcp.client.streamable_http import streamablehttp_client; async with streamablehttp_client("https://mcp.europaius.com/mcp", headers={"Authorization": "Bearer <token>"}) as (r, w, _): async with ClientSession(r, w) as s: await s.initialize(); res = await s.call_tool("search", {"query": "promlčení pohledávky", "states": ["CZ"]}). Az eredmény egy JSON-t tartalmazó szöveg, amelyet a szokásos módon dolgozhat fel. A tokent OAuth folyamattal vagy API kulcsos bejelentkezéssel szerezheti meg.

• Adjon az ügynöknek olyan rendszerutasítást, hogy minden jogi állítás esetén hívjon meg egy eszközt, és a válaszban tüntesse fel az eredményből származó URL-t.
• A dokumentumok azonosítóit tárolja, ne a szövegeket; a teljes szöveget csak szükség esetén töltse be.
• Számoljon azzal, hogy a külföldi országra vonatkozó első lekérdezés tovább tart; állítson be legalább 120 másodperces időkorlátot.
• Tartsa be a fiók korlátait; egy ciklusban futó ügynök gyorsan felhasználhat 100 lekérdezést, produkciós használatra előfizetést válasszon.