Agente AI proprio sul corpus giuridico Europaius

Login da codice

Per l'uso interattivo si esegue il consueto login OAuth nel browser; l'MCP SDK, sia per Python che per TypeScript, è in grado di gestirlo. Per agenti server e automazioni si usa l'API key indicata nel listino prezzi di Europaius: al momento del login la si inserisce al posto dell'e-mail, oppure un client OAuth proprio completa l'autorizzazione una sola volta e salva il refresh token. La chiave inizia con il prefisso eur_ ed è legata all'account e ai relativi limiti.

Strumenti

• search(query, states): restituisce il JSON {"results":[{id,title,url,snippet}]} su leggi e giurisprudenza.
• fetch(id): testo integrale del documento in base all'identificatore, inclusi i metadati (corte, data, ECLI, stato).
• search_law, find_caselaw, find_caselaw_cz: ricerca mirata nella legislazione o nella giurisprudenza con parametri specifici.
• get_paragraf(state, law, paragraf): testo esatto dell'articolo in base al numero di legge.
• souvislosti(para_id): collegamenti citazionali verificati dell'articolo.
• compare_norm(query, states): le disposizioni più rilevanti per ciascuno stato.
• vyklad, list_states: interpretazione dell'articolo ceco, panoramica della copertura.

Identificatori

Gli identificatori restituiti dallo strumento search sono stabili e possono essere salvati. Decisioni dei tribunali cechi: case:<soud>:<slug>, dove il tribunale è ns, nss, us o justice (fonti ceche). Articolo: para:CZ:89/2012:§2991. Documento di uno stato estero: eu:DE:<id>. Lo strumento fetch restituisce per le decisioni la massima, il dispositivo e la motivazione in un unico testo, fino a 80 mila caratteri.

Esempio in Python

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": "prescrizione del credito", "states": ["CZ"]}). Il risultato è un testo con JSON, che si può caricare in modo standard. Il token si ottiene tramite il flusso OAuth oppure a partire dal login con API key.

Raccomandazioni per gli agenti

• Date all'agente un'istruzione di sistema che lo obblighi a richiamare lo strumento per ogni affermazione giuridica e a citare nella risposta l'URL presente nel risultato.
• Salvate gli identificatori dei documenti, non i testi; caricate il testo integrale solo quando serve.
• Tenete conto che la prima richiesta relativa a uno stato estero richiede più tempo; usate un timeout di almeno 120 s.
• Rispettate i limiti dell'account; un agente in un ciclo consuma rapidamente 100 richieste, per la produzione usate un abbonamento.

Domande frequenti

Guide correlate

Informazioni indicative, non sostituiscono una consulenza legale. Il collegamento del connettore richiede un account Europaius (gratuito). Maggiori informazioni su Europaius · Europaius IT