CSV URL -integraatio

Tuo asiakirjat suoraan julkisesti saatavilla olevista CSV-tiedostoista URL-osoitteen kautta AI-avustajasi tietopohjaan.

---

Nopeasti alkuun

Aloita 3 vaiheessa:

1. Siirry: Hallinta → Minun avustajat → [Avustajan nimi] → Integraatiot → CSV URL
2. Lisää URL: Syötä julkinen CSV-URL-osoitteesi ja valitse tuontityyppi (UKK/Tuote/Oletus)
3. Tuo: Napsauta "Lisää URL" ja seuraa tilaa

Vinkki: Testaa ensin pienellä CSV-tiedostolla tottuaksesi prosessiin.

---

Mitä voit tehdä

• ✅ Tuo julkisista HTTP/HTTPS CSV URL-osoitteista
• ✅ Tuo useita URL-osoitteita kerralla
• ✅ Tunnista CSV-rakenne automaattisesti (UKK, Tuote tai Yleinen)
• ✅ Määritä kategoriat ja kartoita mukautetut sarakkeet
• ✅ Seuraa tuontitilaa ja historiaa

---

Esivaatimukset

• Ylläpitäjäoikeudet AI SmartTalk -avustajallesi
• Julkisesti saatavilla olevat CSV-tiedostot (ei vaadi todennusta)
• Oikea CSV-rakenne sarakeotsikoilla
• UTF-8-koodaus suositeltavaa

---

Tuontityypit

1. UKK-tuonti

Paras: Tukidokumentaatio, tietopankit

Vaaditut sarakkeet:

• question
• answer

Esimerkki:

question,answer
"Kuinka voin palauttaa salasanani?","Napsauta 'Unohditko salasanan' ja seuraa ohjeita."
"Mitkä ovat aukioloaikasi?","Maanantaista perjantaihin, klo 9-18."

2. Tuotetuonti

Paras: Verkkokauppakatalogit, varasto

Vaadittu sarake:

• idProduct (tai mukautettu kartoitettu sarake)

Valinnainen:

• name (tai mukautettu kartoitettu sarake)

Esimerkki:

idProduct,name,description,price
"PROD001","Premium Widget","Korkealaatuinen widget","99.99"
"PROD002","Standard Widget","Perus widget","49.99"

3. Oletustuonti

Paras: Yleinen sisältö, sekoitettu data

• Tunnistaa automaattisesti UKK- tai Tuoterakenteen
• Palautuu yleiseen asiakirjatuontiin
• Käsittelee erilaisia CSV-muotoja

---

Vaiheittainen opas

Vaihe 1: Pääsy Integraatioon

1. Kirjaudu sisään AI SmartTalkiin
2. Siirry kohtaan Hallinta → Omat avustajat → [Oma avustajasi]
3. Napsauta Integraatiot → CSV URL

Vaihe 2: Lisää CSV URL

Yksi URL:

1. Napsauta Lisää uusi CSV URL
2. Syötä CSV-tiedoston URL
3. Anna valinnainen nimi
4. Valitse tuontityyppi (FAQ/Tuote/Oletus)
5. Valitse kategoria (valinnainen)
6. Napsauta Lisää URL

Massatuonti:

1. Napsauta Massatuonti URL-osoitteet
2. Syötä URL-osoitteet (yksi per rivi)
3. Määritä jaetut asetukset
4. Napsauta Tuo kaikki URL-osoitteet

Vaihe 3: Määritä Sarakekartoitus (Tuote vain)

Kartoituksen CSV-sarakkeet odotettuihin kenttiin:

• ID Tuotesarake: Oletus idProduct → Kartoitus product_id, sku jne.
• Nimi Sarake: Oletus name → Kartoitus product_name, title jne.

Vaihe 4: Seuraa Tuontia

Seuraa tilannetta Tuontihistoriassa:

• Odottaa: Odottaa käsittelyä
• Tuotu: Onnistuneesti suoritettu
• Virhe: Epäonnistunut (katso yksityiskohdat)

Vaihe 5: Uudelleen tuonti (Päivitä tiedot)

1. Etsi URL historiasta
2. Napsauta Uudelleen tuo
3. Vahvista toiminto
4. Seuraa päivitettyä tilaa

Vaihe 6: Vahvista Tuonti

1. Tarkista Tietopankki uusista asiakirjoista
2. Testaa chatbotia kysymyksillä tuodusta sisällöstä

---

CSV-vaatimukset

Voimassa olevat URL-osoitteet

✅ 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 tuettu)
❌ https://private.site.com/auth-data.csv (Todennus vaaditaan)
❌ file:///local/data.csv (Paikallisia tiedostoja ei tuettu)

Tiedostovaatimukset

• Pääsy: Julkisesti saatavilla HTTP/HTTPS:n kautta
• Otsikot: Ensimmäisellä rivillä on oltava sarakkeiden nimet
• Erotinmerkit: Pilkku (,) tai puolipiste (;)
• Koodaus: UTF-8 suositellaan
• Koko: Enintään 10MB per tiedosto

---

Vianetsintä

Yleiset virheet

Virhe	Ratkaisu
URL ei saavutettavissa	Varmista, että URL on julkinen ja voimassa
Virheellinen muoto	Tarkista erotinmerkit ja otsikot
Puuttuvat sarakkeet	Varmista, että vaaditut sarakkeet ovat olemassa (kysymys/vastaus tai idProduct)
Suuri tiedosto aikakatkaisu	Jaa tiedosto tai vähennä kokoa alle 10MB

Ratkaisuvaiheet

1. Testaa URL selaimessa
2. Vahvista CSV-rakenne ja koodaus
3. Tarkista virheilmoitukset tuontihistoriassa
4. Testaa pienemmällä näytetiedostolla
5. Ota yhteyttä tukeen, jos ongelma jatkuu

---

Parhaat käytännöt

URL-hallinta

• Käytä vakaita, pysyviä URL-osoitteita
• Testaa URL-osoitteet kuukausittain saavutettavuuden varmistamiseksi
• Käytä CDN:ää paremman suorituskyvyn saavuttamiseksi
• Sisällytä versio tiedostonimiin: products-v2024.csv

Datan organisointi

• Käytä selkeitä kategorianimiä
• Säilytä johdonmukaiset CSV-muodot
• Siivoa data ennen tuontia (poista tyhjät rivit)
• Pidä tiedostot alle 10MB

Suorituskyky

• Testaa ensin pienillä näytteillä
• Käsittele suuria tuonteja ruuhka-aikojen ulkopuolella
• Käytä massatuontia useille liittyville URL-osoitteille
• Seuraa tuonnin onnistumisprosenttia säännöllisesti

---

Tietoturva

• ✅ HTTPS-salaus siirroissa
• ✅ URL-osoitteiden validointi
• ✅ Oikeuksiin perustuva pääsynhallinta
• ✅ Väliaikainen tiedostojen käsittely (ei pysyvää tallennusta)
• ✅ Vanhan datan automaattinen puhdistus
• ✅ Auditointilokit kaikista toiminnoista

---

Tuonnin jälkeen

Kun data on tuotu:

1. Siitä tulee haettavaa tietopankissa
2. Se aktivoi chatbotin vastaukset välittömästi
3. Se näkyy järjestettynä kategorioittain
4. Sen voi tarkistaa Tietopankki-osiossa

Vahvista tuontisi:

• Tarkista Tietopankista uudet asiakirjat
• Testaa chatbotia kysymyksillä tuodusta sisällöstä
• Tarkista kategoriat ja organisointi

---

Tuki

Tarvitsetko apua?

• 📧 Sähköposti: contact@aismarttalk.tech
• 📚 Asiakirjat: https://docs.aismarttalk.tech/

---

Yhteenveto

Voit nyt:

• ✅ Tuoda CSV-dataa julkisista URL-osoitteista
• ✅ Käsitellä FAQ-, tuote- ja yleisiä datatyyppejä
• ✅ Tehdä massatuontia useista lähteistä
• ✅ Määrittää mukautettuja sarakkeita tuotteille
• ✅ Seurata ja hallita tuontia
• ✅ Päivittää dataa uudelleen tuomalla

Seuraavat vaiheet:

1. Testaa näytteellä CSV:stä
2. Tuo tuotantodataa
3. Määritä kategoriat
4. Aikatauluta säännölliset uudelleen tuonnit
5. Seuraa suorituskykyä

Kysymyksiä? Ota yhteyttä tukitiimiimme milloin tahansa.