Oma tekoälyagentti Europaius-oikeudellisen korpuksen päälle

Kirjautuminen koodista

Interaktiivisessa käytössä kirjaudutaan standardilla OAuth-kirjautumisella selaimessa; sekä Python- että TypeScript-MCP SDK osaavat hoitaa sen. Palvelinpuolen agenteille ja automaatioille tarkoitettu on Europaius-hinnastosta saatava API-avain: kirjautuessa syötät sen sähköpostin sijaan, tai oma OAuth-asiakas käy autorisoinnin läpi kerran ja tallentaa uudistustokenin. Avain alkaa etuliitteellä eur_ ja on sidottu tiliin ja sen rajoihin.

Työkalut

• search(query, states): palauttaa JSON-muodossa {"results":[{id,title,url,snippet}]} lainsäädännön ja oikeuskäytännön kattavuudella.
• fetch(id): dokumentin koko teksti tunnisteen perusteella, mukaan lukien metatiedot (tuomioistuin, päivämäärä, ECLI, valtio).
• search_law, find_caselaw, find_caselaw_cz: kohdennettu haku lainsäädännöstä tai oikeuskäytännöstä parametrein.
• get_paragraf(state, law, paragraf): pykälän tarkka sanamuoto lain numeron perusteella.
• souvislosti(para_id): pykälän vahvistetut viittaussuhteet.
• compare_norm(query, states): kunkin valtion relevanteimmat säännökset.
• vyklad, list_states: tsekkiläisen pykälän tulkinta, kattavuuden yleiskatsaus.

Tunnisteet

search-työkalun palauttamat tunnisteet ovat pysyviä ja ne voi tallentaa. Tsekkiläisten tuomioistuinten päätökset: case:<soud>:<slug>, jossa tuomioistuin on ns, nss, us tai justice (tsekkiläisiä lähteitä). Pykälä: para:CZ:89/2012:§2991. Ulkomaisen valtion dokumentti: eu:DE:<id>. fetch-työkalu palauttaa päätöksistä oikeusohjeen, tuomiolauselman ja perustelut yhtenä tekstinä, enintään 80 000 merkkiä.

Esimerkki Pythonilla

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"]}). Tulos on tekstimuotoinen JSON, jonka lataat tavalliseen tapaan. Tokenin saat OAuth-kirjautumisen kautta tai API-avaimella kirjautumalla.

Suosituksia agenteille

• Anna agentille järjestelmäohje kutsua työkalua jokaisen oikeudellisen väitteen kohdalla ja mainita vastauksessa tuloksesta saatu URL.
• Tallenna dokumenttien tunnisteet, älä tekstejä; lataa koko teksti vasta tarvittaessa.
• Varaudu siihen, että ensimmäinen ulkomaista valtiota koskeva kysely kestää kauemmin; käytä vähintään 120 sekunnin aikakatkaisua.
• Kunnioita tilin rajoja; agentti voi silmukassa kuluttaa 100 kyselyä nopeasti – käytä tuotannossa tilausta.

Usein kysytyt kysymykset

Aiheeseen liittyvät oppaat

Suuntaa-antavaa tietoa, joka ei korvaa lakineuvontaa. Liittimen käyttö edellyttää Europaius-tiliä (ilmainen). Lisää Europaiuksesta · Europaius FI