CSV URL Integrácia

Importujte dokumenty priamo z verejne prístupných CSV súborov prostredníctvom URL do databázy znalostí vášho AI asistenta.

---

Rýchly štart

Začnite v 3 krokoch:

1. Navigujte: Administrácia → Moji asistenti → [Názov asistenta] → Integrácie → CSV URL
2. Pridajte URL: Zadajte svoju verejnú CSV URL a vyberte typ importu (FAQ/Produkt/Predvolené)
3. Importujte: Kliknite na "Pridať URL" a sledujte stav

Tip: Najprv otestujte s malým CSV súborom, aby ste sa oboznámili s procesom.

---

Čo môžete robiť

• ✅ Importovať z verejných HTTP/HTTPS CSV URL
• ✅ Hromadne importovať viacero URL naraz
• ✅ Automaticky detekovať štruktúru CSV (FAQ, Produkt alebo Generické)
• ✅ Priradiť kategórie a mapovať vlastné stĺpce
• ✅ Sledovať stav a históriu importu

---

Požiadavky

• Administrátorský prístup k vášmu AI SmartTalk asistentovi
• Verejne prístupné CSV súbory (nie je potrebná autentifikácia)
• Správna štruktúra CSV so záhlavičkami stĺpcov
• Odporúčané kódovanie UTF-8

---

Typy importu

1. FAQ Import

Najlepšie pre: Podpornú dokumentáciu, databázy znalostí

Povinné stĺpce:

• question
• answer

Príklad:

question,answer
"How do I reset my password?","Click 'Forgot Password' and follow instructions."
"What are your hours?","Monday-Friday, 9 AM - 6 PM."

2. Produkt Import

Najlepšie pre: E-commerce katalógy, inventár

Povinný stĺpec:

• idProduct (alebo vlastný mapovaný stĺpec)

Voliteľné:

• name (alebo vlastný mapovaný stĺpec)

Príklad:

idProduct,name,description,price
"PROD001","Premium Widget","High-quality widget","99.99"
"PROD002","Standard Widget","Basic widget","49.99"

3. Predvolené Import

Najlepšie pre: Všeobecný obsah, zmiešané dáta

• Automaticky detekuje štruktúru FAQ alebo Produkt
• Prejde na generický import dokumentu
• Spracováva rôzne formáty CSV

---

Krok za krokom sprievodca

Krok 1: Prístup k integrácii

1. Prihláste sa do AI SmartTalk
2. Prejdite na Administrácia → Moji asistenti → [Váš asistent]
3. Kliknite na Integrácie → CSV URL

Krok 2: Pridanie CSV URL

Jednotlivé URL:

1. Kliknite na Pridať novú CSV URL
2. Zadajte URL CSV súboru
3. Poskytnite voliteľný názov
4. Vyberte typ importu (FAQ/Produkt/Predvolený)
5. Vyberte kategóriu (voliteľné)
6. Kliknite na Pridať URL

Hromadný import:

1. Kliknite na Hromadný import URL
2. Zadajte URL (jedno na riadok)
3. Nakonfigurujte zdieľané nastavenia
4. Kliknite na Importovať všetky URL

Krok 3: Konfigurácia mapovania stĺpcov (iba produkt)

Mapujte svoje CSV stĺpce na očakávané polia:

• Stĺpec ID produktu: Predvolené idProduct → Mapovať na product_id, sku, atď.
• Stĺpec názvu: Predvolené name → Mapovať na product_name, title, atď.

Krok 4: Monitorovanie importu

Sledujte stav v histórii importu:

• Čaká: Čaká na spracovanie
• Importované: Úspešne dokončené
• Chyba: Zlyhalo (pozrite si podrobnosti)

Krok 5: Opätovný import (aktualizácia údajov)

1. Nájdite URL v histórii
2. Kliknite na Opätovný import
3. Potvrďte akciu
4. Sledujte aktualizovaný stav

Krok 6: Overenie importu

1. Skontrolujte znalostnú bázu pre nové dokumenty
2. Otestujte chatbot s otázkami o importovanom obsahu

---

Požiadavky na CSV

Platné 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 nie je podporované)
❌ https://private.site.com/auth-data.csv (Vyžaduje sa autentifikácia)
❌ file:///local/data.csv (Lokálne súbory nie sú podporované)

Požiadavky na súbory

• Prístup: Verejne prístupné cez HTTP/HTTPS
• Hlavicky: Prvý riadok musí obsahovať názvy stĺpcov
• Oddelovače: Čiarka (,) alebo bodkočiarka (;)
• Kódovanie: Odporúča sa UTF-8
• Veľkosť: Maximálne 10MB na súbor

---

Riešenie problémov

Bežné chyby

Chyba	Riešenie
URL nie je prístupné	Overte, či je URL verejné a platné
Neplatný formát	Skontrolujte oddelovač a hlavičky
Chýbajúce stĺpce	Uistite sa, že požadované stĺpce existujú (otázka/odpoveď alebo idProduct)
Časový limit veľkého súboru	Rozdeľte súbor alebo znížte veľkosť pod 10MB

Kroky na vyriešenie

1. Otestujte URL v prehliadači
2. Overte štruktúru CSV a kódovanie
3. Prejdite si chybové správy v histórii importu
4. Otestujte s menším vzorovým súborom
5. Kontaktujte podporu, ak problém pretrváva

---

Najlepšie Praktiky

Správa URL

• Používajte stabilné, trvalé URL
• Testujte URL mesačne na prístupnosť
• Používajte CDN pre lepší výkon
• Zahrňte verziu do názvov súborov: products-v2024.csv

Organizácia Dát

• Používajte jasné názvy kategórií
• Udržujte konzistentné formáty CSV
• Vyčistite dáta pred importom (odstráňte prázdne riadky)
• Udržujte súbory pod 10MB

Výkon

• Najprv testujte s malými vzorkami
• Spracovávajte veľké importy počas mimošpičkových hodín
• Používajte hromadný import pre viacero súvisiacich URL
• Pravidelne monitorujte úspešnosť importu

---

Bezpečnosť

• ✅ HTTPS šifrované prenosy
• ✅ Validácia URL
• ✅ Kontrola prístupu na základe oprávnení
• ✅ Spracovanie dočasných súborov (žiadne trvalé úložisko)
• ✅ Automatické čistenie starých dát
• ✅ Auditné záznamy pre všetky aktivity

---

Po Importe

Po importe vaše dáta:

1. Stávajú sa vyhľadávateľnými v znalostnej báze
2. Okamžite napájajú odpovede chatbota
3. Objavujú sa organizované podľa kategórií
4. Môžu byť overené v sekcii Znalostná Báza

Overte svoj import:

• Skontrolujte Znalostnú Bázu pre nové dokumenty
• Otestujte chatbota s otázkami o importe obsahu
• Prejdite si kategórie a organizáciu

---

Podpora

Potrebujete pomoc?

• 📧 Email: contact@aismarttalk.tech
• 📚 Dokumentácia: https://docs.aismarttalk.tech/

---

Zhrnutie

Teraz môžete:

• ✅ Importovať CSV dáta z verejných URL
• ✅ Spracovávať typy dát FAQ, Produkt a generické
• ✅ Hromadne importovať viacero zdrojov
• ✅ Mapovať vlastné stĺpce pre produkty
• ✅ Monitorovať a spravovať importy
• ✅ Aktualizovať dáta prostredníctvom opätovných importov

Ďalšie kroky:

1. Otestujte s ukážkovým CSV
2. Importujte svoje produkčné dáta
3. Nastavte kategórie
4. Naplánujte pravidelné opätovné importy
5. Monitorujte výkon

Otázky? Kontaktujte náš podporný tím kedykoľvek.