Vlastný AI agent nad právnym korpusom Europaius

Prihlásenie z kódu

Pre interaktívne použitie prebehne štandardné OAuth prihlásenie v prehliadači; MCP SDK pre Python aj TypeScript ho vie obslúžiť. Pre serverových agentov a automatizácie slúži API kľúč z cenníka Europaius: pri prihlásení ho vložíte namiesto e-mailu, alebo vlastný OAuth klient prejde autorizáciou raz a uloží si obnovovací token. Kľúč začína predponou eur_ a je viazaný na účet a jeho limity.

Nástroje

• search(query, states): vráti JSON {"results":[{id,title,url,snippet}]} naprieč zákonmi a judikatúrou.
• fetch(id): plný text dokumentu podľa identifikátora, vrátane metadát (súd, dátum, ECLI, štát).
• search_law, find_caselaw, find_caselaw_cz: cielené vyhľadávanie v legislatíve alebo judikatúre s parametrami.
• get_paragraf(state, law, paragraf): presné znenie § podľa čísla zákona.
• súvislosti(para_id): overené citačné väzby paragrafu.
• compare_norm(query, states): najrelevantnejšie ustanovenia z každého štátu.
• vyklad, list_states: výklad českého paragrafu, prehľad pokrytia.

Identifikátory

Identifikátory z nástroja search sú stabilné a možno ich uložiť. Rozhodnutia českých súdov: case:<soud>:<slug>, kde súd je ns, nss, us alebo justice (české zdroje). Paragraf: para:CZ:89/2012:§2991. Dokument zahraničného štátu: eu:DE:<id>. Nástroj fetch vracia pri rozhodnutiach právnu vetu, výrok a odôvodnenie v jednom texte, do 80 tisíc znakov.

Ukážka v Pythone

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": "premlčanie pohľadávky", "states": ["CZ"]}). Výsledok je text s JSON, ktorý načítate štandardne. Token získate OAuth postupom alebo z prihlásenia API kľúčom.

Odporúčania pre agentov

• Dajte agentovi systémovú inštrukciu, aby pre každé právne tvrdenie zavolal nástroj a v odpovedi uviedol URL z výsledku.
• Ukladajte identifikátory dokumentov, nie texty; plný text načítavajte až pri potrebe.
• Počítajte s tým, že prvý dotaz na zahraničný štát trvá dlhšie; použite časový limit aspoň 120 s.
• Rešpektujte limity účtu; agent v cykle spotrebuje 100 dotazov rýchlo, pre produkciu použite predplatné.

Časté otázky

Súvisiace návody

Orientačné informácie, nenahrádzajú právne poradenstvo. Pripojenie konektora vyžaduje účet Europaius (zdarma). Viac o Europaius · Europaius SK