110 lines
2.8 KiB
Markdown
110 lines
2.8 KiB
Markdown
# 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**
|
||
|
||
```bash
|
||
git clone git@git.kemt.fei.tuke.sk:od059jr/ai-lawyer-agent.git
|
||
```
|
||
|
||
### 2. **Vytvorenie virtuálneho prostredia**
|
||
|
||
#### Pre Windows
|
||
```bash
|
||
python -m venv venv
|
||
|
||
venv\Scripts\activate
|
||
```
|
||
|
||
#### Pre macOS/Linux
|
||
```
|
||
python3 -m venv venv
|
||
|
||
source venv/bin/activate
|
||
```
|
||
|
||
### 3. **Inštalácia závislostí**
|
||
```bash
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
### 4. **Sťahovanie inštalátora Ollama**
|
||
|
||
https://ollama.com/download
|
||
|
||
|
||
### 5. **Sťahovanie modelov**
|
||
|
||
```bash
|
||
ollama pull qwen3-next:80b-cloud
|
||
```
|
||
|
||
```bash
|
||
ollama pull gpt-oss:20b-cloud
|
||
```
|
||
|
||
```bash
|
||
ollama pull deepseek-v3.1:671b-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
|
||
|