Собствен AI агент върху правния корпус на Europaius

За интерактивна употреба се извършва стандартен OAuth вход в браузъра; MCP SDK за Python и TypeScript могат да го обработят. За сървърни агенти и автоматизации служи API ключ от ценовата листа на Europaius: при входа го въвеждате вместо имейл, или собственият OAuth клиент минава през авторизация веднъж и запазва обновяващ токен (refresh token). Ключът започва с представката eur_ и е обвързан с акаунта и неговите лимити.

• search(query, states): връща JSON {"results":[{id,title,url,snippet}]} в законодателството и съдебната практика.
• fetch(id): пълен текст на документа по идентификатор, включително метаданни (съд, дата, ECLI, държава).
• search_law, find_caselaw, find_caselaw_cz: целенасочено търсене в законодателството или съдебната практика с параметри.
• get_paragraf(state, law, paragraf): точен текст на параграф по номер на закона.
• souvislosti(para_id): проверени цитатни връзки на параграфа.
• compare_norm(query, states): най-релевантните разпоредби от всяка държава.
• vyklad, list_states: тълкуване на чешки параграф, преглед на покритието.

Идентификаторите от инструмента search са стабилни и могат да се съхраняват. Решения на чешките съдилища: case:<soud>:<slug>, където soud е ns, nss, us или justice (чешки източници). Параграф: para:CZ:89/2012:§2991. Документ на чужда държава: eu:DE:<id>. Инструментът fetch връща при решенията правния извод, диспозитива и мотивите в един текст, до 80 хиляди знака.

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"]}). Резултатът е текст с JSON, който зареждате по стандартен начин. Токенът получавате чрез OAuth преминаване или от вход с API ключ.

• Дайте на агента системна инструкция за всяко правно твърдение да извиква инструмент и в отговора да посочва URL от резултата.
• Съхранявайте идентификатори на документи, не текстове; пълния текст зареждайте едва при нужда.
• Имайте предвид, че първата заявка към чужда държава отнема повече време; използвайте таймаут от поне 120 сек.
• Спазвайте лимитите на акаунта; агент в цикъл изразходва 100 заявки бързо, за продукция използвайте абонамент.