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. Navigacija: Administracija → Moji Asistenti → [Ime Asistenta] → Integracije → CSV URL
2. Dodajte URL: Unesite svoj javni CSV URL i odaberite tip uvoza (FAQ/Proizvod/Podrazumevano)
3. Uvoz: Kliknite na "Dodaj URL" i pratite status

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

---

Šta Možete Uraditi

• ✅ Uvezite sa javnih HTTP/HTTPS CSV URL-ova
• ✅ Uvezite više URL-ova odjednom
• ✅ Automatski detektuje CSV strukturu (FAQ, Proizvod ili Opšte)
• ✅ Dodelite kategorije i mapirajte prilagođene kolone
• ✅ Pratite status i istoriju uvoza

---

Preduslovi

• Administratorski pristup vašem AI SmartTalk asistentu
• Javno dostupne CSV datoteke (bez autentifikacije)
• Pravilna CSV struktura sa zaglavljima kolona
• Preporučena UTF-8 enkodiranje

---

Tipovi Uvoza

1. FAQ Uvoz

Najbolje za: Dokumentaciju za podršku, baze znanja

Obavezne kolone:

• question
• answer

Primer:

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

2. Proizvod Uvoz

Najbolje za: E-trgovinske kataloge, inventar

Obavezna kolona:

• idProduct (ili prilagođena mapirana kolona)

Opcionalno:

• name (ili prilagođena mapirana kolona)

Primer:

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

3. Podrazumevani Uvoz

Najbolje za: Opšti sadržaj, mešani podaci

• Automatski detektuje FAQ ili Proizvod strukturu
• Vraća se na generički uvoz dokumenata
• Obrađuje različite CSV formate

---

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 opcioni naziv
4. Izaberite tip uvoza (FAQ/Proizvod/Podrazumevano)
5. Izaberite kategoriju (opciono)
6. Kliknite na Dodaj URL

Masovni Uvoz:

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

Korak 3: Konfigurišite Mapiranje Kolona (Samo Proizvod)

Mapirajte svoje CSV kolone na očekivana polja:

• ID Proizvoda Kolona: Podrazumevano idProduct → Mapirajte na product_id, sku, itd.
• Naziv Kolona: Podrazumevano name → Mapirajte na product_name, title, itd.

Korak 4: Pratite Uvoz

Pratite status u Istoriji Uvoza:

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

Korak 5: Ponovni uvoz (Ažuriranje podataka)

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

Korak 6: Verifikujte Uvoz

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

---

CSV Zahtevi

Validni 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)

Zahtevi za datoteke

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

---

Rešavanje problema

Uobičajene Greške

Greška	Rešenje
URL nije dostupan	Proverite da li je URL javan i validan
Neispravan format	Proverite delimi i zaglavlja
Nedostaju kolone	Osigurajte da potrebne kolone postoje (pitanje/odgovor ili idProduct)
Vreme isteka velike datoteke	Podelite datoteku ili smanjite veličinu ispod 10MB

Koraci za rešavanje

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

---

Najbolje Prakse

Upravljanje URL-ovima

• Koristite stabilne, trajne URL-ove
• Testirajte URL-ove mesečno na dostupnost
• Koristite CDN za bolju performansu
• Uključite verziju u nazive datoteka: products-v2024.csv

Organizacija Podataka

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

Performanse

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

---

Bezbednost

• ✅ HTTPS enkriptovani prenosi
• ✅ Validacija URL-a
• ✅ Kontrola pristupa zasnovana na dozvolama
• ✅ Privremeno procesuiranje datoteka (bez trajnog skladištenja)
• ✅ Automatsko čišćenje starih podataka
• ✅ Revizijski dnevnici 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 sekciji Baze Znanja

Verifikujte svoj uvoz:

• Proverite Bazu Znanja za nove dokumente
• Testirajte chatbota sa 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 kroz ponovne uvoze

Sledeći koraci:

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

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