Integracija CSV URL

Uvozite dokumente neposredno iz javno dostopnih CSV datotek prek URL-ja v bazo znanja vašega AI asistenta.

---

Hiter začetek

Začnite v 3 korakih:

1. Navigirajte: Administracija → Moji asistenti → [Ime asistenta] → Integracije → CSV URL
2. Dodajte URL: Vnesite svoj javni CSV URL in izberite vrsto uvoza (FAQ/Izdelek/Privzeto)
3. Uvozite: Kliknite "Dodaj URL" in spremljajte stanje

Nasvet: Najprej preizkusite z majhno CSV datoteko, da se seznanite s postopkom.

---

Kaj lahko storite

• ✅ Uvozite iz javnih HTTP/HTTPS CSV URL-jev
• ✅ Uvozite več URL-jev hkrati
• ✅ Samodejno zazna strukturo CSV (FAQ, Izdelek ali Splošno)
• ✅ Dodelite kategorije in preslikajte prilagojene stolpce
• ✅ Spremljajte stanje in zgodovino uvoza

---

Predpogoji

• Administratorski dostop do vašega AI SmartTalk asistenta
• Javno dostopne CSV datoteke (avtentikacija ni potrebna)
• Pravilna struktura CSV s stolpci z naslovi
• Priporočena kodiranje UTF-8

---

Vrste uvoza

1. Uvoz FAQ

Najboljše za: Dokumentacijo za podporo, baze znanja

Zahtevani stolpci:

• question
• answer

Primer:

question,answer
"Kako lahko ponastavim geslo?","Kliknite 'Pozabljeno geslo' in sledite navodilom."
"Kakšni so vaši delovni čas?","Ponedeljek - Petek, 9:00 - 18:00."

2. Uvoz izdelkov

Najboljše za: E-trgovinske kataloge, zaloge

Zahtevani stolpec:

• idProduct (ali prilagojen preslikan stolpec)

Neobvezno:

• name (ali prilagojen preslikan stolpec)

Primer:

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

3. Privzeti uvoz

Najboljše za: Splošno vsebino, mešane podatke

• Samodejno zazna strukturo FAQ ali Izdelek
• Preklopi na splošni uvoz dokumentov
• Obvladuje različne formate CSV

---

Korak-po-koraku Vodnik

Korak 1: Dostop do Integracije

1. Prijavite se v AI SmartTalk
2. Pojdite na Upravljanje → Moji Asistent → [Vaš Asistent]
3. Kliknite Integracije → CSV URL

Korak 2: Dodaj CSV URL

Enotni URL:

1. Kliknite Dodaj nov CSV URL
2. Vnesite URL CSV datoteke
3. Dajte neobvezno ime
4. Izberite vrsto uvoza (FAQ/Izdelek/Privzeto)
5. Izberite kategorijo (neobvezno)
6. Kliknite Dodaj URL

Masovni uvoz:

1. Kliknite Masovni uvoz URL-jev
2. Vnesite URL-je (enega na vrstico)
3. Konfigurirajte skupne nastavitve
4. Kliknite Uvozi vse URL-je

Korak 3: Konfigurirajte Preslikavo Stolpcev (Samo Izdelek)

Preslikajte svoje CSV stolpce na pričakovane podatke:

• ID Stolpec Izdelka: Privzeto idProduct → Preslikajte na product_id, sku, itd.
• Ime Stolpec: Privzeto name → Preslikajte na product_name, title, itd.

Korak 4: Spremljajte Uvoz

Spremljajte stanje v zgodovini uvoza:

• Čaka: Čaka na obdelavo
• Uvoženo: Uspešno zaključeno
• Napaka: Ni uspelo (ogled podrobnosti)

Korak 5: Ponovni uvoz (Posodobitev Podatkov)

1. Poiščite URL v zgodovini
2. Kliknite Ponovni uvoz
3. Potrdite dejanje
4. Spremljajte posodobljeno stanje

Korak 6: Preverite Uvoz

1. Preverite Bazo znanja za nove dokumente
2. Preizkusite chatbot z vprašanji o uvoženem vsebini

---

Zahteve za CSV

Veljavni URL-ji

✅ 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 ni podprt)
❌ https://private.site.com/auth-data.csv (Zahteva se avtentikacija)
❌ file:///local/data.csv (Lokalne datoteke niso podprte)

Zahteve za Datoteke

• Dostop: Javno dostopne preko HTTP/HTTPS
• Glave: Prvi vrstica mora vsebovati imena stolpcev
• Ločila: Zarez (,) ali podpičje (;)
• Kodiranje: Priporočeno UTF-8
• Velikost: Največ 10MB na datoteko

---

Odpravljanje Težav

Pogoste Napake

Napaka	Rešitev
URL Ni Dostopen	Preverite, ali je URL javno dostopen in veljaven
Neveljavna Oblika	Preverite ločila in glave
Manjkajoči Stolpci	Prepričajte se, da zahtevani stolpci obstajajo (vprašanje/odgovor ali idProduct)
Časovna Omejitev Velike Datoteke	Razdelite datoteko ali zmanjšajte velikost pod 10MB

Koraki za Reševanje

1. Preizkusite URL v brskalniku
2. Potrdite strukturo in kodiranje CSV
3. Preglejte sporočila o napakah v zgodovini uvoza
4. Preizkusite z manjšim vzorcem datoteke
5. Kontaktirajte podporo, če težava ostaja

---

Najboljše prakse

Upravljanje URL-jev

• Uporabite stabilne, trajne URL-je
• Testirajte URL-je mesečno za dostopnost
• Uporabite CDN za boljšo zmogljivost
• V imena datotek vključite različico: products-v2024.csv

Organizacija podatkov

• Uporabite jasna imena kategorij
• Ohranite dosledne CSV formate
• Očistite podatke pred uvozom (odstranite prazne vrstice)
• Ohranite datoteke pod 10MB

Zmogljivost

• Najprej testirajte z majhnimi vzorci
• Procesirajte velike uvoze med urami z manj obremenitvijo
• Uporabite množični uvoz za več povezanih URL-jev
• Redno spremljajte stopnjo uspešnosti uvoza

---

Varnost

• ✅ HTTPS šifrirani prenosi
• ✅ Validacija URL-jev
• ✅ Nadzor dostopa na osnovi dovoljenj
• ✅ Obdelava začasnih datotek (brez trajnega shranjevanja)
• ✅ Samodejno čiščenje starih podatkov
• ✅ Revizijski dnevniki za vse aktivnosti

---

Po uvozu

Ko so vaši podatki uvoženi:

1. Postanejo iskalni v bazi znanja
2. Takoj napajajo odgovore chatbota
3. Pojavijo se organizirani po kategorijah
4. Lahko jih preverite v razdelku Baza znanja

Preverite svoj uvoz:

• Preverite Bazo znanja za nove dokumente
• Testirajte chatbota z vprašanji o uvoženem vsebini
• Preglejte kategorije in organizacijo

---

Podpora

Potrebujete pomoč?

• 📧 E-pošta: contact@aismarttalk.tech
• 📚 Dokumentacija: https://docs.aismarttalk.tech/

---

Povzetek

Zdaj lahko:

• ✅ Uvozite CSV podatke iz javnih URL-jev
• ✅ Obvladate FAQ, podatke o izdelkih in splošne tipe podatkov
• ✅ Množno uvozite več virov
• ✅ Zmapirate prilagojene stolpce za izdelke
• ✅ Spremljate in upravljate uvoze
• ✅ Posodobite podatke preko ponovnih uvozov

Naslednji koraki:

1. Testirajte z vzorčno CSV datoteko
2. Uvozite svoje proizvodne podatke
3. Nastavite kategorije
4. Načrtujte redne ponovne uvoze
5. Spremljajte zmogljivost

Vprašanja? Kontaktirajte našo podporo kadarkoli.