CSV URL Integracija

Importuokite dokumentus tiesiogiai iš viešai prieinamų CSV failų per URL į savo AI asistento žinių bazę.

---

Greitas Pradžia

Pradėkite per 3 žingsnius:

1. Naršykite: Administracija → Mano Asistentai → [Asistento Pavadinimas] → Integracijos → CSV URL
2. Pridėti URL: Įveskite savo viešą CSV URL ir pasirinkite importo tipą (FAQ/Produktas/Numatytasis)
3. Importuoti: Paspauskite "Pridėti URL" ir stebėkite būseną

Patarimas: Pirmiausia išbandykite su mažu CSV failu, kad susipažintumėte su procesu.

---

Ką Galite Padaryti

• ✅ Importuoti iš viešų HTTP/HTTPS CSV URL
• ✅ Masinis importas iš kelių URL vienu metu
• ✅ Automatiškai nustatyti CSV struktūrą (FAQ, Produktas arba Bendras)
• ✅ Priskirti kategorijas ir sužymėti pasirinktinius stulpelius
• ✅ Stebėti importo būseną ir istoriją

---

Reikalavimai

• Administratoriaus prieiga prie jūsų AI SmartTalk asistento
• Viešai prieinami CSV failai (autentifikacija nereikalinga)
• Tinkama CSV struktūra su stulpelių antraštėmis
• Rekomenduojama UTF-8 koduotė

---

Importo Tipai

1. FAQ Importas

Geriausia: Pagalbos dokumentacija, žinių bazės

Reikalingi stulpeliai:

• question
• answer

Pavyzdys:

question,answer
"Kaip aš galiu atnaujinti savo slaptažodį?","Paspauskite 'Pamiršote slaptažodį' ir sekite instrukcijas."
"Kokios jūsų darbo valandos?","Pirmadienis - Penktadienis, 9:00 - 18:00."

2. Produkto Importas

Geriausia: E-komercijos katalogai, inventorius

Reikalingas stulpelis:

• idProduct (arba pasirinktinis sužymėtas stulpelis)

Pasirinktinai:

• name (arba pasirinktinis sužymėtas stulpelis)

Pavyzdys:

idProduct,name,description,price
"PROD001","Premium Widget","Aukštos kokybės widget","99.99"
"PROD002","Standard Widget","Pagrindinis widget","49.99"

3. Numatytoji Importas

Geriausia: Bendras turinys, mišrūs duomenys

• Automatiškai nustato FAQ arba Produkto struktūrą
• Grįžta prie bendro dokumento importo
• Apdoroja įvairius CSV formatus

---

Žingsnis po Žingsnio Vadovas

1 Žingsnis: Prieiga prie Integracijos

1. Prisijunkite prie AI SmartTalk
2. Eikite į Administracija → Mano Asistentai → [Jūsų Asistentas]
3. Spustelėkite Integracijos → CSV URL

2 Žingsnis: Pridėti CSV URL

Vienas URL:

1. Spustelėkite Pridėti Naują CSV URL
2. Įveskite CSV failo URL
3. Nurodykite pasirinktą pavadinimą
4. Pasirinkite importo tipą (FAQ/Produktas/Numatytasis)
5. Pasirinkite kategoriją (pasirinktinai)
6. Spustelėkite Pridėti URL

Masinis Importas:

1. Spustelėkite Masinis Importuoti URL
2. Įveskite URL (po vieną kiekvienoje eilutėje)
3. Suconfigure shared settings
4. Spustelėkite Importuoti Visus URL

3 Žingsnis: Suconfigure Stulpelių Žemėlapį (Tik Produktams)

Priskirkite savo CSV stulpelius laukams:

• ID Produkto Stulpelis: Numatyta idProduct → Priskirti product_id, sku ir kt.
• Pavadinimo Stulpelis: Numatyta name → Priskirti product_name, title ir kt.

4 Žingsnis: Stebėti Importą

Sekite būseną Importo Istorijoje:

• Laukiama: Laukiama apdorojimo
• Importuota: Sėkmingai užbaigta
• Klaida: Nepavyko (peržiūrėti detales)

5 Žingsnis: Pakartotinis Importas (Atnaujinti Duomenis)

1. Raskite URL istorijoje
2. Spustelėkite Pakartotinis Importas
3. Patvirtinkite veiksmą
4. Stebėkite atnaujintą būseną

6 Žingsnis: Patvirtinti Importą

1. Patikrinkite Žinių Bazę dėl naujų dokumentų
2. Išbandykite chatbot'ą su klausimais apie importuotą turinį

---

CSV Reikalavimai

Galiojantys URL

✅ 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 nepalaikoma)
❌ https://private.site.com/auth-data.csv (Reikalingas autentifikavimas)
❌ file:///local/data.csv (Vietiniai failai nepalaikomi)

Failo Reikalavimai

• Prieiga: Viešai prieinamas per HTTP/HTTPS
• Antraštės: Pirmoje eilutėje turi būti stulpelių pavadinimai
• Atskyrikliai: Kablelis (,) arba kabliataškis (;)
• Koduotė: Rekomenduojama UTF-8
• Dydis: Maksimalus 10MB vienam failui

---

Problemos Sprendimas

Dažnos Klaidos

Klaida	Sprendimas
URL Neprieinama	Patikrinkite, ar URL yra viešas ir galiojantis
Neteisingas Formatavimas	Patikrinkite atskyriklius ir antraštes
Trūksta Stulpelių	Įsitikinkite, kad reikiami stulpeliai egzistuoja (klausimas/atsakymas arba idProduct)
Didelio Failo Laiko Išnaudojimas	Padalinkite failą arba sumažinkite dydį žemiau 10MB

Sprendimo Veiksmai

1. Išbandykite URL naršyklėje
2. Patikrinkite CSV struktūrą ir koduotę
3. Peržiūrėkite klaidų pranešimus importo istorijoje
4. Išbandykite su mažesniu pavyzdiniu failu
5. Susisiekite su palaikymo tarnyba, jei problema išlieka

---

Geriausios Praktikos

URL Valdymas

• Naudokite stabilias, nuolatines URL
• Testuokite URL kas mėnesį dėl prieinamumo
• Naudokite CDN geresniam našumui
• Įtraukite versiją į failų pavadinimus: products-v2024.csv

Duomenų Organizavimas

• Naudokite aiškius kategorijų pavadinimus
• Išlaikykite nuoseklius CSV formatus
• Išvalykite duomenis prieš importavimą (pašalinkite tuščias eilutes)
• Laikykite failus po 10MB

Našumas

• Pirmiausia testuokite su mažais pavyzdžiais
• Apdorokite didelius importus ne piko valandomis
• Naudokite masinį importą keliems susijusiems URL
• Reguliariai stebėkite importo sėkmės rodiklį

---

Saugumas

• ✅ HTTPS šifruoti perdavimai
• ✅ URL validacija
• ✅ Prieigos kontrolė pagal leidimus
• ✅ Laikinas failų apdorojimas (be nuolatinio saugojimo)
• ✅ Automatinis senų duomenų valymas
• ✅ Audito žurnalai visoms veikloms

---

Po Importo

Importavus, jūsų duomenys:

1. Taps paieškos galimybėmis žinių bazėje
2. Iškart palaikys pokalbių roboto atsakymus
3. Atrodo organizuoti pagal kategorijas
4. Gali būti patvirtinti Žinių Bazės skyriuje

Patvirtinkite savo importą:

• Patikrinkite Žinių Bazę dėl naujų dokumentų
• Išbandykite pokalbių robotą su klausimais apie importuotą turinį
• Peržiūrėkite kategorijas ir organizavimą

---

Pagalba

Reikia pagalbos?

• 📧 El. paštas: contact@aismarttalk.tech
• 📚 Dokumentai: https://docs.aismarttalk.tech/

---

Santrauka

Dabar galite:

• ✅ Importuoti CSV duomenis iš viešų URL
• ✅ Tvarkyti DUK, Produktų ir bendrų duomenų tipus
• ✅ Masiniu būdu importuoti kelis šaltinius
• ✅ Priskirti pasirinktinius stulpelius produktams
• ✅ Stebėti ir valdyti importus
• ✅ Atnaujinti duomenis per pakartotinius importus

Kiti žingsniai:

1. Išbandykite su pavyzdiniu CSV
2. Importuokite savo gamybinius duomenis
3. Nustatykite kategorijas
4. Naplanavę reguliarius pakartotinius importus
5. Stebėkite našumą

Klausimų? Bet kada susisiekite su mūsų palaikymo komanda.