Albanian Rules Bot Logo
Dokumentacioni Teknik

🎓 Qëllimi i këtij dokumenti: Ky seksion shpjegon si funksionon chatbot-i, jo vetëm për të kuptuar mjetin, por edhe për të mësuar rreth teknologjisë së inteligjencës artificiale (AI). Është shkruar për të gjithë — deputetë, staf parlamentar dhe qytetarë të interesuar.

1. Çfarë është Inteligjenca Artificiale (AI)?

Inteligjenca Artificiale (AI) është teknologji që i mundëson kompjuterit të "kuptojë" dhe të përgjigjet pyetjeve në gjuhën njerëzore. Mendoni si një asistent virtual që ka lexuar të gjitha dokumentet parlamentare dhe mund të përgjigjet pyetjeve tuaja menjëherë.

🧠 Analogji e thjeshtë: Imagjinoni një bibliotekist të specializuar që njeh përmendësh çdo faqe të Rregullores së Kuvendit. Kur bëni një pyetje, ai gjen seksionet përkatëse dhe ju jep një përgjigje të qartë. Kjo është ajo që bën AI-ja — por më shpejt.

Cila AI Përdoret?

GPT-4 (OpenAI)

Modeli kryesor i AI që formulon përgjigjet. GPT-4 është një nga modelet më të avancuara të AI në botë, i trajnuar me miliarda tekste.

Embeddings (Vektorët)

Teknologji që kthen tekstin në numra për të gjetur pyetje të ngjashme. Kjo mundëson kërkimin "inteligjent" jo vetëm me fjalë kyçe.

Pse "Kreativiteti i Ulët"?

AI mund të jetë shumë "kreative" dhe të shpikë informacione që duken të vërteta por nuk janë (quhen "hallucinations"). Për dokumentet ligjore dhe parlamentare, kjo është e rrezikshme. Prandaj, kemi konfiguruar AI-në me kreativitet të ulët (temperatura 0.1-0.3) për të dhënë vetëm përgjigje të bazuara në dokumentet zyrtare.

2. Dokumentet Reference
Burimi Kryesor
📜 Rregullorja e Kuvendit të Republikës së Shqipërisë
  • Versioni: I miratuar mĂ« 2026

  • Nenet: 1-200+ (tĂ« gjitha nenet procedurale)

  • Gjuha: Shqip (me pĂ«rkthime nĂ« Anglisht)

  • Link: Shkarko PDF

Dokumentet Mbështetëse
📋 Kodi i Sjelljes së Administratës

Shkarko PDF

📚 Kodi i Sjelljes së Deputetëve

Shkarko PDF

📖 Udhëzuesi i Detajuar për Sjelljen në Kuvend

Shiko dokumentet

📝 Modelet e Deklarimit

Modeli i deklarimit të dhuratave dhe pjesëmarrjes në veprimtaritë e organizuara nga të tretë

3. Si Funksionon Chatbot-i? (RAG — Retrieval Augmented Generation)
🧩 5 Elementet Kryesore të një Chatbot
🤖

LLM

Gjeneron përgjigjet

📚

RAG

Përmirëson saktësinë

🔢

Vektorët

Tekst → Numra

🔍

Kërkim Semantik

Gjen përmbajtje relevante

📝

Prompt Template

Udhëzimet për AI

❓ Çfarë është RAG?

Retrieval-Augmented Generation (RAG) përmirëson përgjigjet e chatbot-it duke kombinuar një LLM me një funksion kërkimi. Në vend që të mbështetet vetëm në njohuritë e brendshme të modelit, ai rikuperon dokumentet ose të dhënat relevante (duke përdorur kërkimin semantik) dhe pastaj përdor atë informacion për të gjeneruar një përgjigje më të saktë dhe të bazuar në fakte.

📊 Faza 1: Informacioni Konvertohet në "Vektorë"

(Kjo ndodh para se chatbot-i të jetë gati për përdorim)

📄→📄📄📄
1. Ndarja në "Chunks"

Informacioni ndahet në copa më të vogla (paragrafë, faqe, ose seksione)

📄→🔢
2. Konvertimi në Vektorë

Çdo copë konvertohet në numra të gjatë që quhen "vektorë"

🔢→💾
3. Ruajtja në Bazën e të Dhënave

Vektorët grupohen sipas ngjashmërisë dhe ruhen, duke mundësuar "kërkimin semantik"

🔄 Faza 2: Cikli RAG (Kur Përdoruesi Bën një Pyetje)
1

Përdoruesi bën pyetje

"Si zhvillohet votimi në seancë plenare?"

2

Pyetja → Vektor

Sistemi e kthen pyetjen në numra (vektor)

3

Kërkimi në bazën e dhënave

Sistemi kërkon vektorë të ngjashëm në databazë

4

Rikuperimi i fragmenteve

5 fragmentet më relevante rikuperohen

5

Dërgimi te LLM

Pyetja + Fragmentet + Prompt dërgohen te GPT-4

6

Përgjigja gjenerohet

LLM-ja shkruan përgjigjen bazuar VETËM në informacionin e dhënë

🤔 Pse RAG është më i mirë se AI e zakonshme?

❌ AI pa RAG (ChatGPT i zakonshëm)

  • • PĂ«rpiqet tĂ« "kujtojĂ«" nga trajnimi

  • • Mund tĂ« shpikĂ« fakte (hallucinations)

  • • Informacioni mund tĂ« jetĂ« i vjetĂ«ruar

  • • Nuk mund tĂ« citojĂ« burime specifike

âś… AI me RAG (ky chatbot)

  • • GjithmonĂ« kĂ«rkon nĂ« dokumentet aktuale

  • • PĂ«rgjigjet bazohen nĂ« fakte reale

  • • Informacioni Ă«shtĂ« i pĂ«rditĂ«suar

  • • Citon nenet dhe dokumentet specifike

4. System Prompt (Udhëzimet për AI)

Çfarë është System Prompt? Është udhëzimi bazë që i jepet modelit AI për të përcaktuar rolin, sjelljen dhe mënyrën e përgjigjes. Ky prompt dërgohet në çdo bisedë para pyetjes së përdoruesit.

🤖 System Prompt (Shqip)
Ju jeni një asistent informativ që citon vetëm dokumentet zyrtare parlamentare të Kuvendit të Republikës së Shqipërisë. Ju NUK shprehni opinione, interpretime ose këshilla — vetëm citoni drejtpërdrejt nga dokumentet buruese.

Dokumentet Buruese:
1. Rregullorja e Kuvendit të Republikës së Shqipërisë (Vendim Nr. 166/2004, ndryshuar deri në Nr. 57/2025)
2. Rregullorja e Brendshme e Administratës së Kuvendit
3. Kodi i Sjelljes së Administratës së Kuvendit
4. Kodi i Etikës së Deputetëve
5. Udhëzuesi i Detajuar për Sjelljen në Kuvend
6. Modelet e Deklarimit (dhurata, pjesëmarrje në veprimtari)

**RREGULLA TË RËNDËSISHME:**
- GJITHMONË citoni drejtpërdrejt nga dokumentet zyrtare
- ASNJËHERË mos jepni opinione, interpretime ose gjykime
- ASNJËHERË mos përdorni gjuhë si "duhet", "është e rëndësishme", "është thelbësore" — vetëm thoni çfarë thonë dokumentet
- Nëse pyetja kërkon opinion, drejtojini në dokumentet zyrtare
- Paraqitni vetëm faktet siç janë shkruar në burime

Si të përgjigjeni:

**Për pyetje rreth chatbot-it (meta-pyetje):**
Nëse përdoruesi pyet rreth asaj që mund të pyesë, si funksionon chatbot-i, ose çfarë mund të bëni, jepni një përgjigje të shkurtër, miqësore dhe të qartë. Për shembull:
- Listoni temat kryesore që mbuloni (procedurat e seancave, votimi, komisionet, kodi i sjelljes, etj.)
- Jini të ngrohtë dhe të aksesueshëm
- Mos jepni shpjegime të gjata procedurale përveç nëse kërkohet

**Për pyetje rreth procedurave parlamentare:**
Citoni drejtpërdrejt nga dokumentet zyrtare. Përgjigjja juaj duhet të:
- Citoni nenin, pikën ose seksionin e saktë (p.sh., "Sipas Nenit 15, pika 2...")
- Paraqitni tekstin e dokumentit pa shtuar interpretime
- Jepni referencën e plotë të dokumentit

Gjithmonë jepni përgjigje duke përdorur **formatim HTML**:
- Përdorni `<strong>` për tituj me shkronja të zeza
- Përdorni `<ul><li>` për lista me pika dhe `<ol><li>` për lista të numëruara
- Përdorni `<p>` për të ndarë seksione të ndryshme
- Shmangni blloqe të mëdha teksti, ndani përmbajtjen në paragrafë

Kufizime:
- Kufizoni përgjigjet në 200-400 fjalë për qartësi
- Citoni GJITHMONË klauza specifike të rregullave
- Bazoni shpjegimet VETËM në tekstin e dokumenteve zyrtare
- Mbani një ton neutral dhe faktik — nuk ka opinione

Prioriteti i Burimit:
1. Rregullorja e Kuvendit të Republikës së Shqipërisë (Vendim Nr. 166/2004, ndryshuar me Nr. 57/2025)
2. Kodi i Sjelljes dhe Kodi i Etikës
3. Rregullorja e Brendshme e Administratës
4. Udhëzuesit dhe modelet e deklarimit

Gjithmonë citoni numrat e nenit në formatin: "Neni 15" ose "Neni a/1".
Si Funksionon
  • 1. Roli: AI-ja identifikohet si asistent i specializuar pĂ«r dokumentet parlamentare shqiptare.

  • 2. Dokumentet: Specifikon 6 dokumentet buruese nga tĂ« cilat mund tĂ« tĂ«rheqĂ« informacion.

  • 3. MĂ«nyra e PĂ«rgjigjes: UdhĂ«zon AI-nĂ« tĂ« japĂ« pĂ«rgjigje koncize, profesionale dhe me citime tĂ« sakta.

  • 4. Formatimi: KĂ«rkon pĂ«rdorimin e HTML pĂ«r strukturim tĂ« qartĂ« tĂ« pĂ«rgjigjes.

  • 5. Kufizimet: Vendos limite nĂ« gjatĂ«sinĂ« e pĂ«rgjigjes dhe kĂ«rkon ton jopolitik.

  • 6. Prioriteti: PĂ«rcakton renditjen e dokumenteve sipas rĂ«ndĂ«sisĂ«.

⚙️ Konfigurimi: System Prompt ruhet në config/chat.php dhe mund të modifikohet për të përmirësuar sjelljen e chatbot-it.

5. Performanca dhe Optimizimi
~2-5s

Koha mesatare e përgjigjes

95%+

Saktësia e përgjigjeve

7 ditë

Cache i përgjigjeve

6. Siguria dhe Privatësia

Enkriptim i plotë: Të gjitha të dhënat transmetohen me HTTPS dhe ruhen të enkriptuara.

  • Session TTL: 60 minuta (pastrohen automatikisht)

  • Data minimization: Ruhen vetĂ«m tĂ« dhĂ«nat e nevojshme

  • GDPR compliant: Respekton tĂ« drejtĂ«n e fshirjes sĂ« tĂ« dhĂ«nave

  • No personal data: Nuk ruhen tĂ« dhĂ«na personale tĂ« identifikueshme

7. Limitimet dhe Përmirësimet e Ardhshme
⚠️ Limitimet Aktuale
  • Nuk ka qasje nĂ« informacione nĂ« kohĂ« reale

  • Fokusi vetĂ«m nĂ« Rregulloren e Kuvendit

  • Mund tĂ« ketĂ« gabime nĂ« interpretime komplekse

  • Nuk jep kĂ«shilla ligjore zyrtare

🚀 Përmirësimet e Planifikuara
  • Shtim i dokumenteve tĂ« reja ligjore

  • PĂ«rmirĂ«sim i saktĂ«sisĂ« sĂ« pĂ«rgjigjeve

  • Interface mĂ« interaktiv

  • Integrimi me sisteme tĂ« tjera parlamentare

8. Kontakti Teknik

Për pyetje teknike ose raportim të problemeve: