CSV URL Integrace

Importujte dokumenty přímo z veřejně přístupných CSV souborů prostřednictvím URL do znalostní báze vašeho AI asistenta.

---

Rychlý začátek

Začněte ve 3 krocích:

1. Navigujte: Administrace → Moji asistenti → [Název asistenta] → Integrace → CSV URL
2. Přidejte URL: Zadejte svou veřejnou CSV URL a vyberte typ importu (FAQ/Produkt/Obecný)
3. Importujte: Klikněte na "Přidat URL" a sledujte stav

Tip: Nejprve otestujte s malým CSV souborem, abyste se seznámili s procesem.

---

Co můžete dělat

• ✅ Importovat z veřejných HTTP/HTTPS CSV URL
• ✅ Hromadně importovat více URL najednou
• ✅ Automaticky detekovat strukturu CSV (FAQ, Produkt nebo Obecný)
• ✅ Přiřazovat kategorie a mapovat vlastní sloupce
• ✅ Sledovat stav a historii importu

---

Požadavky

• Administrátorský přístup k vašemu AI SmartTalk asistentovi
• Veřejně přístupné CSV soubory (není vyžadováno ověření)
• Správná struktura CSV se záhlavími sloupců
• Doporučeno kódování UTF-8

---

Typy importu

1. Import FAQ

Nejlepší pro: Podpůrnou dokumentaci, znalostní báze

Požadované sloupce:

• question
• answer

Příklad:

question,answer
"Jak mohu resetovat své heslo?","Klikněte na 'Zapomněli jste heslo' a řiďte se pokyny."
"Jaké jsou vaše pracovní hodiny?","Pondělí-Pátek, 9:00 - 18:00."

2. Import Produktu

Nejlepší pro: E-commerce katalogy, inventář

Požadovaný sloupec:

• idProduct (nebo vlastní mapovaný sloupec)

Volitelné:

• name (nebo vlastní mapovaný sloupec)

Příklad:

idProduct,name,description,price
"PROD001","Prémiový Widget","Vysoce kvalitní widget","99.99"
"PROD002","Standardní Widget","Základní widget","49.99"

3. Obecný Import

Nejlepší pro: Obecný obsah, smíšená data

• Automaticky detekuje strukturu FAQ nebo Produkt
• Přepne na obecný import dokumentů
• Zpracovává různé formáty CSV

---

Krok za Krokem Průvodce

Krok 1: Přístup k Integraci

1. Přihlaste se do AI SmartTalk
2. Přejděte na Administrace → Moji asistenti → [Váš asistent]
3. Klikněte na Integrace → CSV URL

Krok 2: Přidání CSV URL

Jednotlivé URL:

1. Klikněte na Přidat nové CSV URL
2. Zadejte URL souboru CSV
3. Uveďte volitelný název
4. Vyberte typ importu (FAQ/Produkt/Default)
5. Zvolte kategorii (volitelné)
6. Klikněte na Přidat URL

Hromadný import:

1. Klikněte na Hromadný import URL
2. Zadejte URL (jedno na řádek)
3. Nakonfigurujte sdílená nastavení
4. Klikněte na Importovat všechna URL

Krok 3: Konfigurace mapování sloupců (pouze produkt)

Mapujte své sloupce CSV na očekávaná pole:

• Sloupec ID produktu: Výchozí idProduct → Mapovat na product_id, sku, atd.
• Sloupec názvu: Výchozí name → Mapovat na product_name, title, atd.

Krok 4: Monitorování importu

Sledujte stav v historii importu:

• Čekající: Čeká na zpracování
• Importováno: Úspěšně dokončeno
• Chyba: Neúspěšně (zobrazit detaily)

Krok 5: Znovu importovat (aktualizace dat)

1. Najděte URL v historii
2. Klikněte na Znovu importovat
3. Potvrďte akci
4. Sledujte aktualizovaný stav

Krok 6: Ověření importu

1. Zkontrolujte znalostní bázi na nové dokumenty
2. Otestujte chatbot s otázkami o importovaném obsahu

---

Požadavky 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 není podporováno)
❌ https://private.site.com/auth-data.csv (Vyžaduje se autentizace)
❌ file:///local/data.csv (Místní soubory nejsou podporovány)

Požadavky na soubory

• Přístup: Veřejně přístupné přes HTTP/HTTPS
• Hlavičky: První řádek musí obsahovat názvy sloupců
• Oddělovače: Čárka (,) nebo středník (;)
• Kódování: Doporučeno UTF-8
• Velikost: Maximálně 10MB na soubor

---

Řešení problémů

Běžné chyby

Chyba	Řešení
URL není přístupné	Ověřte, že URL je veřejné a platné
Neplatný formát	Zkontrolujte oddělovač a hlavičky
Chybějící sloupce	Ujistěte se, že požadované sloupce existují (otázka/odpověď nebo idProduct)
Časový limit velkého souboru	Rozdělte soubor nebo zmenšete velikost pod 10MB

Krok za krokem k vyřešení

1. Otestujte URL v prohlížeči
2. Ověřte strukturu CSV a kódování
3. Zkontrolujte chybová hlášení v historii importu
4. Otestujte s menším vzorovým souborem
5. Kontaktujte podporu, pokud problém přetrvává

---

Best Practices

URL Management

• Používejte stabilní, trvalé URL
• Testujte URL měsíčně na přístupnost
• Používejte CDN pro lepší výkon
• Zahrňte verzi do názvů souborů: products-v2024.csv

Data Organization

• Používejte jasné názvy kategorií
• Udržujte konzistentní formáty CSV
• Upravte data před importem (odstraňte prázdné řádky)
• Udržujte soubory pod 10MB

Performance

• Nejprve testujte s malými vzorky
• Zpracovávejte velké importy během mimošpičkových hodin
• Používejte hromadný import pro více souvisejících URL
• Pravidelně sledujte úspěšnost importu

---

Security

• ✅ HTTPS šifrované přenosy
• ✅ Ověření URL
• ✅ Řízení přístupu na základě oprávnění
• ✅ Zpracování dočasných souborů (bez trvalého úložiště)
• ✅ Automatické čištění starých dat
• ✅ Auditní protokoly pro všechny aktivity

---

After Import

Jakmile jsou data importována:

1. Stávají se vyhledatelnými v znalostní bázi
2. Okamžitě napájí odpovědi chatbota
3. Objevují se organizovaná podle kategorií
4. Mohou být ověřena v sekci Znalostní báze

Ověřte svůj import:

• Zkontrolujte Znalostní bázi na nové dokumenty
• Otestujte chatbota s otázkami o importovaném obsahu
• Přezkoumejte kategorie a organizaci

---

Support

Potřebujete pomoc?

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

---

Summary

Nyní můžete:

• ✅ Importovat CSV data z veřejných URL
• ✅ Zpracovávat typy dat FAQ, Produkt a obecné
• ✅ Hromadně importovat více zdrojů
• ✅ Mapovat vlastní sloupce pro produkty
• ✅ Sledovat a spravovat importy
• ✅ Aktualizovat data prostřednictvím opětovných importů

Další kroky:

1. Otestujte s ukázkovým CSV
2. Importujte svá produkční data
3. Nastavte kategorie
4. Naplánujte pravidelné opětovné importy
5. Sledujte výkon

Otázky? Kontaktujte náš tým podpory kdykoli.