# Začnimo

### Kaj je Moj AI?

Moj AI ni preprost chatbot. Naš sistem uporablja napredni AI “Orchestration Engine”, ki deluje kot inteligentni dirigent – analizira vaše vprašanje, izbere prava orodja in koordinira različne vire znanja za zagotovitev najkvalitetnejšega odgovora. Moj AI je v celoti razvit v Sloveniji.

{% hint style="success" %}
Moj AI ni običajna rešitev. Temelji na naprednem sistemu AI ORKESTRACIJE, ki presega klasične poizvedbe. Naš pametni agent razume vaše vprašanje, razmišlja o rešitvah in izbere najboljši pristop in najprimernejše orodje za vaš primer.
{% endhint %}

<figure><img src="/files/FhMJs5QfDTEQK3Ihd1TX" alt=""><figcaption></figcaption></figure>

### Inovacija

Moj AI predstavlja preboj na področju inteligentne AI orkestracije za slovensko gradbeno zakonodajo, kjer v osrčju rešitve ni zgolj ena AI tehnologija, temveč sofisticiran sistem koordinacije naprednih Google Gemini modelov, namenskih orodij in večnivojskega sistema pridobivanja znanja. Sistem deluje v dveh načinih - **Lightning** (⚡ hiter odgovor v 5-15 sekundah) in **Frontier** (🔍 poglobljena raziskava v 15-30 sekundah) - kar uporabnikom omogoča izbiro med hitrostjo in celovitostjo glede na konkretne potrebe.

### Jedro Inovacije: Dvonivojska AI Orkestracija

Sistem temelji na pametni orkestraciji Google Gemini modelov (gemini-2.5-flash) z različnimi konfiguracami orodij:

#### Lightning Način - Hitra Analiza Dokumentov

* **RAG sistem** (Google File Search) z dvojno arhitekturo:
  * **Admin Store**: Trajna baza slovenskih pravnih dokumentov (Zakon o graditvi objektov, prostorski akti, OPN-ji, uredbe, TSG)
  * **User Store**: Uporabniški dokumenti naloženi za kratkotrajno uporabo
* **Gemini Flash 2.5** za hitro analizo in sintezo informacij
* **Uporaba**: Preverjanje zakonodaje, hitra analiza dokumentov, odgovori iz baze znanja
* **Hitrost**: 5-15 sekund za natančen odgovor

#### Frontier Način - Celovita Raziskava

Frontier način uporablja **dvokorako orkestracijsko arhitekturo**, ki premaguje tehnične omejitve Gemini API (File Search in Google Search ne moreta delovati v isti zahtevi):

**Korak 1: Pridobitev RAG Konteksta**

* Gemini z File Search orodjem pridobi relevantne dele iz dokumentov
* Izvleče ključne informacije, člene zakonov, reference

**Korak 2: Google Search z Injektiranim Kontekstom**

* RAG kontekst se vstavi v sistemsko sporočilo
* Gemini z Google Search orodjem pridobi aktualne podatke z interneta
* Sintetizira RAG znanje + internetne vire + splošno znanje

**Uporaba**: Raziskovanje aktualnih sprememb zakonodaje, tržne cene, sodna praksa, kompleksni pravni scenariji

### Napredni RAG Sistem - Google File Search

Sistem uporablja **Google Gemini File Search** - RAG orodje, integrirano neposredno v Gemini modele:

**Arhitektura Shranjenih Dokumentov:**

* **Admin File Search Store**: Centralna baza znanja dostopna vsem uporabnikom
  * Slovenska gradbena zakonodaja (GZ, ZUreP-3, Uredba, TSG)
  * Občinski prostorski načrti (OPN-ji)
  * Gradbeni tehnični predpisi
* **User File Search Stores**: Zasebni dokumenti vsakega uporabnika
  * Avtomatsko ustvarjeni ob prvi naložitvi
  * Trajno shranjeni za prihodnje poizvedbe
  * Dostopni v obeh načinih (Lightning in Frontier)

**Podprti Formati**: PDF, Word, Text, Markdown, CSV (do 5MB)

**Prednosti Gemini File Search Integracije:**

* Optimizirana za velike dokumente (do 100MB v Gemini API)
* Inteligentno razbijanje na relevantne kose
* Kontekstualno razumevanje preko več strani
* Brez potrebe po zunanjih vektorskih bazah

### Google Search - Aktualne Informacije v Realnem Času

**Frontier način** integrira **Google Custom Search API** za dostop do aktualnih informacij:

**Uporaba:**

* Trenutne cene storitev in gradbenih dovoljenj
* Spremembe zakonodaje in predpisov (2025+)
* Sodna praksa in precedensi
* Tržni trendi in statistike
* Uradni viri (Uradni list, ministrstva, sodišča)

**Obvezna Transparentnost:**

* Vsak internetni vir vključuje klikljiv URL: `[Naslov vira](https://example.com)`
* Datum informacije je jasno označen (npr. "2025", "Januar 2026")
* Prednost uradnim virom pred drugimi

### Transparentnost in Navajanje Virov

Ključna prednost sistema je **popolna transparentnost virov** s pomočjo jasnih vizualnih indikatorjev:

**Emoji Ikone:**

* 📚 **RAG** - Informacija iz naloženih dokumentov (z natančnimi členi zakonov)
* 🌐 **Internet** - Informacija z Google Search (z obveznim klikljivim URL-jem)
* 🧠 **Splošno znanje** - Pravno sklepanje, analiza, evropska praksa

**Primer Lightning Odgovora:**

```
Po 10. členu GZ (📚 RAG), je potrebno gradbeno dovoljenje za...
Parcele: 181/1, 182/1, 182/3 (📚 RAG - Zemljiška knjiga)
Splošna praksa (🧠) priporoča, da...
```

**Primer Frontier Odgovora:**

```
Po 10. členu GZ (📚 RAG), je potrebno gradbeno dovoljenje za...
Trenutne cene v letu 2025 (🌐): [Vir](https://url.com)
- Stroški gradbenega dovoljenja: €500-1000
Sodna praksa (🌐): [Višje sodišče, 2024](https://url.com)
Pravna analiza (🧠): Na osnovi kombinacije zakonodaje in prakse...
```

Vsak odgovor vključuje **jasno označene vire** za vsako trditev, kar uporabnikom omogoča:

* Preverjanje točnosti informacij
* Sledenje virom do izvirnih dokumentov
* Razlikovanje med zakonodajo, internetnimi podatki in pravnim sklepanjem
* Gradnjo zaupanja v sistem

### Varnost, Točnost in Zanesljivost

**Strukturirani Sistemi za Preprečevanje Napak:**

* **Jasna navodila v sistemskih sporočilih**: "NIKOLI ne izmišljuj podatkov"
* **Obvezno navajanje virov**: Vsaka trditev mora imeti vir
* **Prioriteta zanesljivosti**: Zakonodaja > Sodna praksa > Strokovni članki > Splošno znanje
* **Datum informacij**: Vedno jasno označen za internetne vire

**Gemini Safety Filters:**

* Avtomatska zaščita pred neprimernimi vsebinami
* Preverjanje citatov (RECITATION filter)
* Varnostni filtri za zanesljive odgovore

**Kvalitetni Kontrolni Mehanizmi:**

* Večkratno preverjanje vseh relevantnih dokumentnih kosov (ne samo prvega)
* Združevanje podatkov razpršenih preko več strani
* Deduplikacija ponavljajočih se informacij
* Podrobna analiza tabel vrstico za vrstico

### Profesionalno Orodje za Pravno Svetovanje

Ta pristop presega tradicionalne AI chatbote in ustvarja **profesionalno orodje za pravno raziskovanje** na področju:

* Slovenske gradbene zakonodaje (GZ, ZUreP-3, TSG, Uredba)
* Prostorskega načrtovanja (OPN-ji, OPPN-ji)
* Nepremičninskega prava
* Gradbenih postopkov in dovoljenj
* Legalizacij in prenov

**Z odgovori raziskovalne kakovosti**, ki jih spremljajo:

* Natančni viri s členi zakonov in klikljivimi URL-ji
* Jasno razlikovanje med tipi virov (📚🌐🧠)
* Datumi in kontekst informacij
* Možnost preverjanja in verifikacije

**Rezultat:** Zaupanja vredno orodje, ki združuje hitrost AI tehnologije s strokovnostjo pravnega svetovanja in transparentnostjo virov.

### Uradne Povezave:

{% hint style="danger" %}
Spodaj navajamo uradne povezave projekta Moj AI, vedno preverite da ste na varni in uradni povezavi projekta!
{% endhint %}

```
https://mojai.xyz/
```

```
https://app.mojai.xyz/
```

```
https://docs.mojai.xyz/
```

{% hint style="info" %}
Tehnologija umetne inteligence je še vedno eksperimentalna in v nenehnem razvoju. Kljub odličnim začetnim rezultatom je nenavaden pojav sanjarjenja v tej fazi mogoč, zato moramo pričakovati tudi kakšen manj točen odgovor. Vse je odvisno tudi od strukture zastavljenega vprašanja. Dokumentacija projekta vsebuje tudi navodila kako formirati vprašanja tako da bodo rezultirala najboljše odgovore, zato vam svetujemo, da se seznanite z dotičnimi nasveti.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mojai.xyz/zacetni-koraki/quickstart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
