CSV URL Integratsioon

Importige dokumente otse avalikult ligipääsetavatest CSV-failidest URL-i kaudu oma AI assistendi teadmiste baasi.

---

Kiire Algus

Alustage 3 sammuga:

1. Navigeerige: Administratsioon → Minu Assistendid → [Assistendi Nimi] → Integratsioonid → CSV URL
2. Lisage URL: Sisestage oma avalik CSV URL ja valige importimise tüüp (KKK/Toode/Vaikimisi)
3. Importige: Klõpsake "Lisa URL" ja jälgige staatust

Nipp: Testige esmalt väikese CSV failiga, et tutvuda protsessiga.

---

Mida Saate Teha

• ✅ Importige avalikest HTTP/HTTPS CSV URL-idest
• ✅ Korraga importige mitu URL-i
• ✅ Automaatne CSV struktuuri tuvastamine (KKK, Toode või Üldine)
• ✅ Määrake kategooriad ja kaardistage kohandatud veerud
• ✅ Jälgige importimise staatust ja ajalugu

---

Eeltingud

• Admini juurdepääs teie AI SmartTalk assistendile
• Avalikult ligipääsetavad CSV-failid (autentimist ei nõuta)
• Õige CSV struktuur veergude pealkirjadega
• Soovitatav UTF-8 kodeering

Import Tüübid

1. KKK Import

Parim: Toetuse dokumentatsioon, teadmistebaasid

Nõutavad veerud:

• question
• answer

Näide:

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. Toote Import

Parim: E-kaubanduse kataloogid, inventuur

Nõutav veerg:

• idProduct (või kohandatud kaardistatud veerg)

Valikuline:

• name (või kohandatud kaardistatud veerg)

Näide:

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

3. Vaikimisi Import

Parim: Üldine sisu, segatud andmed

• Automaatne KKK või Toote struktuuri tuvastamine
• Tagasi kukkumine üldisele dokumendi importimisele
• Käsitleb erinevaid CSV formaate

---

Sammutusjuhend

Samm 1: Integreerimise juurde pääsemine

1. Logige sisse AI SmartTalki
2. Minge Haldus → Minu assistendid → [Teie assistent]
3. Klõpsake Integreerimised → CSV URL

Samm 2: CSV URL-i lisamine

Üksik URL:

1. Klõpsake Lisa uus CSV URL
2. Sisestage CSV faili URL
3. Esitage valikuline nimi
4. Valige impordi tüüp (KKK/Toode/Vaikimisi)
5. Valige kategooria (valikuline)
6. Klõpsake Lisa URL

Kopeerimise import:

1. Klõpsake Kopeerimise import URL-id
2. Sisestage URL-id (üks rida)
3. Konfigureerige jagatud seaded
4. Klõpsake Impordi kõik URL-id

Samm 3: Veergude kaardistamine (ainult toote jaoks)

Kaardistage oma CSV veerud oodatud väljadele:

• ID toote veerg: Vaikimisi idProduct → Kaardistage product_id, sku jne.
• Nime veerg: Vaikimisi name → Kaardistage product_name, title jne.

Samm 4: Jälgige Impordi

Jälgige staatust Impordi Ajaloo:

• Ootel: Ootab töötlemist
• Imporditud: Edukalt lõpetatud
• Viga: Ebaõnnestus (vaata üksikasju)

Samm 5: Taasimpordi (Uuenda Andmeid)

1. Leidke URL ajaloost
2. Klõpsake Taasimpordi
3. Kinnitage tegevus
4. Jälgige uuendatud staatust

Samm 6: Kontrollige Impordi

1. Kontrollige Teadmiste Baasi uute dokumentide osas
2. Testige vestlusrobotit imporditud sisu kohta küsimustega

---

CSV Nõuded

Kehtivad URL-id

✅ 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 ei ole toetatud)
❌ https://private.site.com/auth-data.csv (Nõutav autentimine)
❌ file:///local/data.csv (Kohalikud failid ei ole toetatud)

Faili Nõuded

• Juurdepääs: Avalikult ligipääsetav HTTP/HTTPS kaudu
• Pealkirjad: Esimene rida peab sisaldama veergude nimesid
• Eraldajad: Komma (,) või semikoolon (;)
• Kodeering: Soovitatav on UTF-8
• Suurus: Maksimaalne 10MB faili kohta

---

Tõrkeotsing

Levinud Vead

Viga	Lahendus
URL Ei Ole Saadaval	Kontrollige, et URL oleks avalik ja kehtiv
Kehtetu Vorming	Kontrollige eraldajat ja päiseid
Puuduvad Veerud	Veenduge, et vajalikud veerud eksisteerivad (küsimus/vastus või idProduct)
Suur Faili Aegumine	Jagage fail või vähendage suurus alla 10MB

Lahendamise Sammud

1. Testige URL-i brauseris
2. Kinnitage CSV struktuur ja kodeering
3. Vaadake impordi ajaloos veateateid
4. Testige väiksema näidist failiga
5. Võtke ühendust toega, kui probleem püsib

Parimad Tavad

URL-i Haldamine

• Kasutage stabiilseid, püsivaid URL-e
• Testige URL-e igakuiselt ligipääsetavuse osas
• Kasutage CDN-i parema jõudluse saavutamiseks
• Lisage failinimedesse versioon: products-v2024.csv

Andmete Organiseerimine

• Kasutage selgeid kategoorianimesid
• Säilitage järjepidevad CSV formaadid
• Puhastage andmed enne importimist (eemaldage tühjad read)
• Hoidke failid alla 10MB

Jõudlus

• Testige esmalt väikeste proovide abil
• Töötlege suuri importimisi tipptundide vältimiseks
• Kasutage hulgi importimist mitme seotud URL-i jaoks
• Jälgige regulaarselt importimise edukuse määra

---

Turvalisus

• ✅ HTTPS krüpteeritud edastused
• ✅ URL-i valideerimine
• ✅ Luba-põhine juurdepääsu kontroll
• ✅ Ajutine failide töötlemine (ilma püsiva salvestamiseta)
• ✅ Automaatne vanade andmete puhastamine
• ✅ Auditilogid kõigi tegevuste jaoks

---

Pärast importimist

Pärast importimist on teie andmed:

1. Otsitavad teadmistebaasis
2. Toetavad vestlusroboti vastuseid kohe
3. Kuuluvad kategooriate kaupa
4. Saavad kinnitatud teadmistebaasi osas

Kinnitage oma import:

• Kontrollige teadmistebaasi uute dokumentide jaoks
• Testige vestlusrobotit imporditud sisu kohta küsimustega
• Vaadake kategooriaid ja korraldust

---

Tugi

Vajate abi?

• 📧 E-post: contact@aismarttalk.tech
• 📚 Dokumendid: https://docs.aismarttalk.tech/

---

Kokkuvõte

Nüüd saate:

• ✅ Importida CSV andmeid avalikest URL-idest
• ✅ Hallata KKK, toote ja üldisi andmetüüpe
• ✅ Korraga importida mitmeid allikaid
• ✅ Kaardistada kohandatud veerge toodete jaoks
• ✅ Jälgida ja hallata importimist
• ✅ Uuendada andmeid uuesti importimise kaudu

Järgmised sammud:

1. Testige näidis CSV-ga
2. Importige oma tootmisandmed
3. Seadke kategooriad
4. Planeerige regulaarsed uuesti importimised
5. Jälgige jõudlust

Küsimused? Võtke meie tugimeeskonnaga igal ajal ühendust.