CSV URL Integracija

Uvezite dokumente direktno iz javno dostupnih CSV datoteka putem URL-a u bazu znanja vašeg AI asistenta.

---

Brzi Početak

Započnite u 3 koraka:

1. Navigirajte: Administracija → Moji Asistenti → [Ime Asistenta] → Integracije → CSV URL
2. Dodajte URL: Unesite svoj javni CSV URL i odaberite tip uvoza (FAQ/Proizvod/Podrazumijevano)
3. Uvezite: Kliknite "Dodaj URL" i pratite status

Savjet: Prvo testirajte s malom CSV datotekom kako biste se upoznali s procesom.

---

Šta Možete Uraditi

• ✅ Uvezite iz javnih HTTP/HTTPS CSV URL-ova
• ✅ Masovno uvezite više URL-ova odjednom
• ✅ Automatski otkrijte CSV strukturu (FAQ, Proizvod ili Generički)
• ✅ Dodijelite kategorije i mapirajte prilagođene kolone
• ✅ Pratite status i historiju uvoza

---

Preduslovi

• Administratorski pristup vašem AI SmartTalk asistentu
• Javne CSV datoteke (bez autentifikacije)
• Pravilna CSV struktura s naslovima kolona
• Preporučena UTF-8 kodiranje

---

Tipovi Uvoza

1. FAQ Uvoz

Najbolje za: Dokumentaciju za podršku, baze znanja

Obavezne kolone:

• question
• answer

Primjer:

question,answer
"Kako da resetujem svoju lozinku?","Kliknite 'Zaboravljena lozinka' i slijedite upute."
"Koje su vaše radne sate?","Ponedjeljak-Petak, 9 AM - 6 PM."

2. Uvoz Proizvoda

Najbolje za: E-trgovinske kataloge, inventar

Obavezna kolona:

• idProduct (ili prilagođena mapirana kolona)

Opcionalno:

• name (ili prilagođena mapirana kolona)

Primjer:

idProduct,name,description,price
"PROD001","Premium Widget","Visokokvalitetni widget","99.99"
"PROD002","Standard Widget","Osnovni widget","49.99"

3. Podrazumijevani Uvoz

Najbolje za: Opšti sadržaj, mješoviti podaci

• Automatski otkriva FAQ ili strukturu Proizvoda
• Vraća se na generički uvoz dokumenata
• Rukuje raznim CSV formatima

---

Vodič korak po korak

Korak 1: Pristup Integraciji

1. Prijavite se u AI SmartTalk
2. Idite na Administracija → Moji asistenti → [Vaš asistent]
3. Kliknite na Integracije → CSV URL

Korak 2: Dodajte CSV URL

Jedan URL:

1. Kliknite na Dodaj novi CSV URL
2. Unesite URL CSV datoteke
3. Pružite opcionalno ime
4. Odaberite tip uvoza (FAQ/Proizvod/Podrazumijevano)
5. Odaberite kategoriju (opcionalno)
6. Kliknite na Dodaj URL

Masovni uvoz:

1. Kliknite na Masovni uvoz URL-ova
2. Unesite URL-ove (jedan po liniji)
3. Konfigurirajte zajedničke postavke
4. Kliknite na Uvezi sve URL-ove

Korak 3: Konfigurirajte Mapiranje Kolona (Samo Proizvod)

Mapirajte svoje CSV kolone na očekivana polja:

• ID Proizvod Kolona: Podrazumijevano idProduct → Mapirajte na product_id, sku, itd.
• Ime Kolona: Podrazumijevano name → Mapirajte na product_name, title, itd.

Korak 4: Pratite Uvoz

Pratite status u Historiji Uvoza:

• Na čekanju: Čeka na obradu
• Uvezeno: Uspješno završeno
• Greška: Neuspješno (pogledajte detalje)

Korak 5: Ponovni uvoz (Ažuriranje podataka)

1. Pronađite URL u historiji
2. Kliknite na Ponovni uvoz
3. Potvrdite akciju
4. Pratite ažurirani status

Korak 6: Verifikujte Uvoz

1. Provjerite Bazu Znanja za nove dokumente
2. Testirajte chatbot sa pitanjima o uvezenom sadržaju

---

CSV Zahtjevi

Važeći URL-ovi

✅ https://example.com/data/products.csv
✅ https://cdn.company.com/catalog.csv
✅ https://raw.githubusercontent.com/user/repo/main/data.csv

❌ ftp://files.company.com/data.csv (FTP nije podržan)
❌ https://private.site.com/auth-data.csv (Potrebna autentifikacija)
❌ file:///local/data.csv (Lokalne datoteke nisu podržane)

Zahtjevi za datoteke

• Pristup: Javno dostupno putem HTTP/HTTPS
• Zaglavlja: Prvi red mora sadržavati nazive kolona
• Delimitatori: Zarez (,) ili tačka sa zarezom (;)
• Kodiranje: Preporučuje se UTF-8
• Veličina: Maksimalno 10MB po datoteci

---

Rješavanje problema

Česte greške

Greška	Rješenje
URL nije dostupan	Provjerite da li je URL javan i važeći
Neispravan format	Provjerite delimitator i zaglavlja
Nedostaju kolone	Osigurajte da potrebne kolone postoje (pitanje/odgovor ili idProduct)
Timeout velike datoteke	Podijelite datoteku ili smanjite veličinu ispod 10MB

Koraci za rješavanje

1. Testirajte URL u pretraživaču
2. Validirajte CSV strukturu i kodiranje
3. Pregledajte poruke greške u historiji uvoza
4. Testirajte sa manjom uzorkom datoteke
5. Kontaktirajte podršku ako problem i dalje postoji

---

Najbolje Prakse

Upravljanje URL-ovima

• Koristite stabilne, trajne URL-ove
• Testirajte URL-ove mjesečno za pristupačnost
• Koristite CDN za bolju izvedbu
• Uključite verziju u nazive datoteka: products-v2024.csv

Organizacija Podataka

• Koristite jasne nazive kategorija
• Održavajte dosljedne CSV formate
• Očistite podatke prije uvoza (uklonite prazne redove)
• Držite datoteke ispod 10MB

Izvedba

• Prvo testirajte s malim uzorcima
• Procesuirajte velike uvoze tokom vanpikovnih sati
• Koristite masovni uvoz za više povezanih URL-ova
• Redovno pratite stopu uspješnosti uvoza

---

Sigurnost

• ✅ HTTPS enkriptovani prijenosi
• ✅ Validacija URL-a
• ✅ Kontrola pristupa zasnovana na dozvolama
• ✅ Obrada privremenih datoteka (bez trajnog skladištenja)
• ✅ Automatsko čišćenje starih podataka
• ✅ Revizijski logovi za sve aktivnosti

---

Nakon Uvoza

Jednom kada su podaci uvezeni:

1. Postaju pretraživi u bazi znanja
2. Odmah pokreću odgovore chatbota
3. Pojavljuju se organizovani po kategorijama
4. Mogu se verifikovati u odjeljku Baze Znanja

Verifikujte svoj uvoz:

• Provjerite Bazu Znanja za nove dokumente
• Testirajte chatbota s pitanjima o uvezenom sadržaju
• Pregledajte kategorije i organizaciju

---

Podrška

Treba vam pomoć?

• 📧 Email: contact@aismarttalk.tech
• 📚 Dokumentacija: https://docs.aismarttalk.tech/

---

Sažetak

Sada možete:

• ✅ Uvesti CSV podatke sa javnih URL-ova
• ✅ Rukovati FAQ, proizvodnim i generičkim tipovima podataka
• ✅ Masovno uvesti više izvora
• ✅ Mapirati prilagođene kolone za proizvode
• ✅ Pratiti i upravljati uvozima
• ✅ Ažurirati podatke putem ponovnog uvoza

Sljedeći koraci:

1. Testirajte s uzorkom CSV-a
2. Uvezite svoje proizvodne podatke
3. Postavite kategorije
4. Planirajte redovne ponovne uvoze
5. Pratite izvedbu

Imate pitanja? Kontaktirajte naš tim za podršku u bilo kojem trenutku.