Právny AI Asistent – integrácia s API

POPIS

Právny AI Asistent je inteligentný asistent integrovaný s oficiálnymi verejnými API Ministerstva spravodlivosti Slovenskej republiky. Systém poskytuje užívateľom prístup k štruktúrovaným právnym informáciám prostredníctvom prirodzeného jazyka.

Hlavné funkcie:

• Interpretácia užívateľských otázok v prirodzenom jazyku
• Automatická extrakcia a validácia parametrov
• Načítavanie dát výlučne cez oficiálne API
• Prezentácia výsledkov v zrozumiteľnom formáte v slovenskom jazyku

POUŽITÉ KNIŽNICE A TECHNOLÓGIE

• Python – hlavný programovací jazyk
• openai-agent – tvorba AI agentov od OpenAI
• httpx – asynchrónna komunikácia s API
• Chainlit – framework pre chat rozhranie
• Ollama – lokálne používanie AI modelov
• Docker – kontajnerizácia aplikácie
• a iné

ŠTRUKTÚRA PROJEKTU

ai-lawyer-agent/                
├── api/                        # API logika
│   └── tools/                  # API nástroje
│       ├── __init__.py
│       ├── fetch_api_data.py   # Spracovanie API
│       └── schemas.py          # Pydantic schémy 
├── core/
│   ├── __init__.py
│   ├── initialize_agent.py     # Inicializácia AI agenta
│   ├── stream_response.py      # Streamovanie odpovedí
│   └── system_prompt.py        # Systémový prompt
├── public/                     # Verejné zdroje
│   ├── icon/                   # Ikony a logá
│   │   ├── favicon.png
│   │   ├── logo_dark.png
│   │   └── logo_light.png
│   ├── img/
│   ├── styles.css              # Štýly rozhrania
│   └── theme.json              # Nastavenia témy
├── .chainlit/                  # Markdown pre Chainlit
└── app.py                      # Hlavný súbor aplikácie (Сhainlit + spracovanie API)

INŠTRUKCIA PRE INŠTALÁCIU

Inštalácia cez Git

1. Naklonovanie repozitára

git clone git@git.kemt.fei.tuke.sk:od059jr/ai-lawyer-agent.git

2. Vytvorenie virtuálneho prostredia

Pre Windows

python -m venv venv

venv\Scripts\activate

Pre macOS/Linux

python3 -m venv venv

source venv/bin/activate

3. Inštalácia závislostí

pip install -r requirements.txt

4. Sťahovanie inštalátora Ollama

https://ollama.com/download

5. Sťahovanie modelov

ollama pull qwen3.5:cloud

ollama pull gpt-oss:20b-cloud

Inštalácia cez DOCKER

1. Inštalácia Docker a Docker Desktop

2. Nainštalujte a spustite aplikáciu

https://hub.docker.com/r/alexgott0616/ai-lawyer-agent