AI RAG Assistant: konfiguracija korak po korak

Pregled

AI RAG Assistant je eksperimentalni dodatak (proof of concept) koji pokazuje kako sustavi Retrieval-Augmented Generation (RAG) rade unutar nopCommerce okruženja. Namijenjen je prvenstveno učenju, eksperimentiranju i razumijevanju suvremenih AI tijekova. Nije izrađen niti preporučen za produkciju.

Dodatak omogućuje trgovcima i developerima da učitaju do 1000 tokena (oko 4000 znakova) teksta i prate cijeli RAG tijek: pripremu sadržaja, izradu spremišta, indeksiranje, provjeru statusa i razgovor s AI asistentom na temelju obrađenih podataka. Zato je idealan za edukaciju, za istraživanje kako AI koristi strukturirano znanje i za razbijanje predrasuda o „AI halucinacijama”, jer pokazuje da se RAG sustavi strogo oslanjaju na zadani sadržaj.

Glavne komponente

• AI Assistant widget – jednostavno chat sučelje u trgovini u kojem korisnici postavljaju pitanja na temelju indeksiranog sadržaja.
• RAG Configurator – panel za učenje u administraciji koji vodi kroz učitavanje teksta, izradu RAG spremišta, uvoz podataka, provjeru statusa uvoza i brisanje spremišta.

Glavne mogućnosti

• Učitavanje i obrada do 1000 tokena (4000 znakova) teksta.
• Prikaz cijelog RAG životnog ciklusa u pojednostavljenom obliku.
• Edukativni alat za razumijevanje odgovora temeljenih na dokumentima.
• Pokazuje kako priprema podataka utječe na točnost AI odgovora.
• Lagani chat widget za testiranje razgovora temeljenih na RAG-u.
• Praćenje tokena: pregledno sučelje i zapisi za praćenje operacija i potrošnje tokena.

Konfiguracija korak po korak

1. dio: preduvjeti (Google API ključ)

Sustav koristi Google Gemini API. Za rad dodatka treba vam besplatni API ključ.

1. Google račun: trebate važeći Gmail/Google račun.
2. Google AI Studio: otvorite aistudio.google.com/api-keys.
3. Izrada ključa: kliknite „Create API key” (ključ možete izraditi u novom projektu).
4. Kopiranje ključa: kopirajte dobiveni niz; trebat će vam u postavkama dodatka.

2. dio: postavke dodatka

1. Otvorite administraciju nopCommercea.
2. Idite na Configuration > Widgets.
3. Pronađite AI RAG Assistant i kliknite Configure.
4. API ključ: zalijepite Google API ključ u polje Google API Key.
5. Widget zona: odaberite gdje se ikona chata prikazuje u trgovini (npr. body_end_html_tag_before).
6. Kliknite Save.

3. dio: „treniranje” sustava (RAG tijek)

Slijedite korake na zaslonu u panelu postavki. Postupak je namjerno ručni, da biste razumjeli životni ciklus RAG podataka.

• 1. korak: učitavanje sadržaja. Upišite tekst iz kojeg AI uči.
  Napomena: unos je ograničen na 4000 znakova (oko 1000 tokena); dulji tekst automatski se skraćuje.
• 2. korak: izrada RAG spremišta. Kliknite gumb za izradu spremnika (Store) na Googleovim serverima u kojem će podaci biti organizirani.
• 3. korak: uvoz datoteke. Kliknite za uvoz učitanog teksta u izrađeno spremište.
• 4. korak: provjera statusa. Indeksiranje traje. Ovim gumbom provjeravate je li Google završio obradu. Kad je status „Active” ili „Done”, AI je spreman za pitanja.

4. dio: praćenje potrošnje tokena

Jedna od najkorisnijih mogućnosti dodatka je uvid u „cijenu” AI interakcija.

• Gdje: u administraciji otvorite System > Log.
• Što tražiti: svako pitanje korisnika dodatak bilježi u log.
• Detalji: zapis pokazuje koliko je tokena potrošeno za taj upit (ulazni + izlazni tokeni).

Praćenjem logova steći ćete osjećaj koliko podataka troše različite vrste pitanja i odgovora, što je ključno znanje ako planirate komercijalno AI rješenje.

Namjena

Dodatak je napravljen za eksperimentiranje i edukaciju. Vlasnicima trgovina i developerima omogućuje iskustvo s AI sustavima utemeljenima na dokumentima, učenje osnova indeksiranja i praćenje kako se AI odgovori mijenjaju ovisno o zadanom sadržaju.

Podrška

Za pitanja i podršku javite se putem kontakt obrasca ispod.