CSV URL Integráció

Dokumentumok közvetlen importálása nyilvánosan elérhető CSV fájlokból URL-en keresztül az AI asszisztens tudásbázisába.

---

Gyors Kezdés

Kezdje el 3 lépésben:

1. Navigáljon: Adminisztráció → Az én asszisztenseim → [Asszisztens neve] → Integrációk → CSV URL
2. URL hozzáadása: Adja meg a nyilvános CSV URL-jét, és válassza ki az importálási típust (GYIK/Termék/Alapértelmezett)
3. Importálás: Kattintson az "URL hozzáadása" gombra, és kövesse nyomon az állapotot

Tipp: Először teszteljen egy kis CSV fájllal, hogy megismerkedjen a folyamattal.

---

Mit Tehet

• ✅ Importálás nyilvános HTTP/HTTPS CSV URL-ekből
• ✅ Több URL egyidejű tömeges importálása
• ✅ CSV struktúra automatikus észlelése (GYIK, Termék vagy Általános)
• ✅ Kategóriák hozzárendelése és egyedi oszlopok térképezése
• ✅ Importálási állapot és előzmények nyomon követése

---

Előfeltételek

• Adminisztrátori hozzáférés az AI SmartTalk asszisztenshez
• Nyilvánosan elérhető CSV fájlok (nincs szükség hitelesítésre)
• Megfelelő CSV struktúra oszlopfejlécekkel
• UTF-8 kódolás ajánlott

---

Import Típusok

1. GYIK Import

Legjobb: Támogatási dokumentációk, tudásbázisok

Szükséges oszlopok:

• question
• answer

Példa:

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. Termék Import

Legjobb: E-kereskedelmi katalógusok, készlet

Szükséges oszlop:

• idProduct (vagy egyedi térképezett oszlop)

Opcionális:

• name (vagy egyedi térképezett oszlop)

Példa:

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

3. Alapértelmezett Import

Legjobb: Általános tartalom, vegyes adatok

• Automatikusan észleli a GYIK vagy Termék struktúrát
• Átáll az általános dokumentum importálásra
• Különböző CSV formátumokat kezel

---

Lépésről lépésre útmutató

1. lépés: Integráció elérése

1. Jelentkezzen be az AI SmartTalk-ba
2. Menjen a Adminisztráció → Saját asszisztenseim → [Az Ön asszisztense]
3. Kattintson az Integrációk → CSV URL lehetőségre

2. lépés: CSV URL hozzáadása

Egyedi URL:

1. Kattintson az Új CSV URL hozzáadása gombra
2. Adja meg a CSV fájl URL-jét
3. Adjon meg opcionális nevet
4. Válassza ki az importálás típusát (GYIK/Termék/Alapértelmezett)
5. Válassza ki a kategóriát (opcionális)
6. Kattintson az URL hozzáadása gombra

Tömeges importálás:

1. Kattintson a Tömeges URL importálás gombra
2. Adja meg az URL-eket (soronként egyet)
3. Konfigurálja a megosztott beállításokat
4. Kattintson az Összes URL importálása gombra

3. lépés: Oszlopok térképezése (Csak termékek)

Térképezze a CSV oszlopait a várt mezőkre:

• ID Termék oszlop: Alapértelmezett idProduct → Térképezze a product_id, sku stb. mezőkre
• Név oszlop: Alapértelmezett name → Térképezze a product_name, title stb. mezőkre

4. lépés: Importálás nyomon követése

Kövesse nyomon az állapotot az Importálási előzményekben:

• Függőben: Feldolgozásra vár
• Importálva: Sikeresen befejezve
• Hiba: Sikertelen (részletek megtekintése)

5. lépés: Újraimportálás (Adatok frissítése)

1. Keresse meg az URL-t az előzményekben
2. Kattintson az Újraimportálás gombra
3. Erősítse meg a műveletet
4. Kövesse nyomon a frissített állapotot

6. lépés: Importálás ellenőrzése

1. Ellenőrizze a Tudásbázist az új dokumentumokért
2. Tesztelje a chatbotot a importált tartalommal kapcsolatos kérdésekkel

---

CSV követelmények

Érvényes URL-ek

✅ 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 nem támogatott)
❌ https://private.site.com/auth-data.csv (Hitelesítés szükséges)
❌ file:///local/data.csv (Helyi fájlok nem támogatottak)

Fájl követelmények

• Hozzáférés: Nyilvánosan elérhető HTTP/HTTPS-en keresztül
• Fejlécek: Az első sorban szerepelnie kell az oszlopneveknek
• Elválasztók: Vessző (,) vagy pontosvessző (;)
• Kódolás: UTF-8 ajánlott
• Méret: Maximális 10MB fájlonként

---

Hibaelhárítás

Gyakori hibák

Hiba	Megoldás
URL nem elérhető	Ellenőrizze, hogy az URL nyilvános és érvényes
Érvénytelen formátum	Ellenőrizze az elválasztót és a fejléceket
Hiányzó oszlopok	Győződjön meg arról, hogy a szükséges oszlopok léteznek (kérdés/válasz vagy idProduct)
Nagy fájl időtúllépés	Ossza fel a fájlt vagy csökkentse a méretet 10MB alá

Megoldási lépések

1. Tesztelje az URL-t a böngészőben
2. Érvényesítse a CSV struktúráját és kódolását
3. Tekintse át a hibaüzeneteket az importálási előzményekben
4. Teszteljen egy kisebb minta fájlt
5. Vegye fel a kapcsolatot a támogatással, ha a probléma továbbra is fennáll

---

Legjobb Gyakorlatok

URL Kezelés

• Használjon stabil, állandó URL-eket
• Tesztelje az URL-eket havonta az elérhetőség érdekében
• Használjon CDN-t a jobb teljesítmény érdekében
• Tartalmazza a verziót a fájlnevekben: products-v2024.csv

Adat Szervezés

• Használjon világos kategória neveket
• Tartsa fenn a következetes CSV formátumokat
• Tisztítsa meg az adatokat importálás előtt (távolítsa el az üres sorokat)
• Tartsa a fájlokat 10MB alatt

Teljesítmény

• Először teszteljen kis mintákkal
• Nagy importokat a csúcsidőn kívül dolgozzon fel
• Használjon tömeges importálást több kapcsolódó URL-hez
• Rendszeresen figyelje az importálás sikerességi arányát

---

Biztonság

• ✅ HTTPS titkosított átvitelek
• ✅ URL érvényesítés
• ✅ Engedély alapú hozzáférés-vezérlés
• ✅ Ideiglenes fájlok feldolgozása (nincs állandó tárolás)
• ✅ Régi adatok automatikus törlése
• ✅ Audit naplók minden tevékenységről

---

Importálás Után

Az importálás után az adatai:

1. Kereshetővé válnak a tudásbázisban
2. Azonnal táplálják a chatbot válaszait
3. Kategóriák szerint rendezve jelennek meg
4. Ellenőrizhetők a Tudásbázis szekcióban

Ellenőrizze az importálását:

• Ellenőrizze a Tudásbázist új dokumentumokért
• Tesztelje a chatbotot importált tartalommal kapcsolatos kérdésekkel
• Tekintse át a kategóriákat és a szervezést

---

Támogatás

Segítségre van szüksége?

• 📧 Email: [email protected]
• 📚 Dokumentáció: https://docs.aismarttalk.tech/

---

Összegzés

Mostantól:

• ✅ Importálhat CSV adatokat nyilvános URL-ekről
• ✅ Kezelheti a GYIK, Termék és általános adat típusokat
• ✅ Tömeges importálást végezhet több forrásból
• ✅ Térképezheti a termékek egyedi oszlopait
• ✅ Figyelheti és kezelheti az importokat
• ✅ Frissítheti az adatokat újraimportálással

Következő lépések:

1. Teszteljen egy minta CSV-vel
2. Importálja a termelési adatait
3. Állítson be kategóriákat
4. Ütemezzen rendszeres újraimportálásokat
5. Figyelje a teljesítményt

Kérdései vannak? Bármikor lépjen kapcsolatba a támogatási csapatunkkal.