CSV URL Integrācija

Importējiet dokumentus tieši no publiski pieejamām CSV failēm, izmantojot URL, savā AI asistenta zināšanu bāzē.

---

Ātrā Uzsākšana

Sāciet 3 soļos:

1. Navigējiet: Administrācija → Mani Asistenti → [Asistenta Vārds] → Integrācijas → CSV URL
2. Pievienojiet URL: Ievadiet savu publisko CSV URL un izvēlieties importēšanas veidu (FAQ/Produkta/Standarta)
3. Importējiet: Noklikšķiniet uz "Pievienot URL" un uzraugiet statusu

Ieteikums: Vispirms izmēģiniet ar nelielu CSV failu, lai iepazītos ar procesu.

---

Ko Jūs Varat Darīt

• ✅ Importēt no publiskiem HTTP/HTTPS CSV URL
• ✅ Masveida importēt vairākus URL vienlaikus
• ✅ Automātiski noteikt CSV struktūru (FAQ, Produkts vai Vispārīgs)
• ✅ Piešķirt kategorijas un kartēt pielāgotas kolonnas
• ✅ Sekot importēšanas statusam un vēsturei

---

Prasības

• Administratora piekļuve jūsu AI SmartTalk asistentam
• Publiski pieejami CSV faili (nav nepieciešama autentifikācija)
• Atbilstoša CSV struktūra ar kolonu virsrakstiem
• Ieteicama UTF-8 kodēšana

---

Importēšanas Veidi

1. FAQ Importēšana

Labāk piemērots: Atbalsta dokumentācijai, zināšanu bāzēm

Nepieciešamās kolonnas:

• question
• answer

Piemērs:

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. Produkta Importēšana

Labāk piemērots: E-komercijas katalogiem, krājumiem

Nepieciešamā kolonna:

• idProduct (vai pielāgota kartēta kolonna)

Pēc izvēles:

• name (vai pielāgota kartēta kolonna)

Piemērs:

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

3. Standarta Importēšana

Labāk piemērots: Vispārējam saturam, jauktiem datiem

• Automātiski nosaka FAQ vai Produkta struktūru
• Atgriežas pie vispārīgas dokumentu importēšanas
• Apstrādā dažādus CSV formātus

---

Pakāpeniska rokasgrāmata

1. solis: Piekļuve integrācijai

1. Ielogojieties AI SmartTalk
2. Dodieties uz Administrācija → Mani asistenti → [Jūsu asistents]
3. Noklikšķiniet uz Integrācijas → CSV URL

2. solis: Pievienot CSV URL

Vienots URL:

1. Noklikšķiniet uz Pievienot jaunu CSV URL
2. Ievadiet CSV faila URL
3. Norādiet opciju nosaukumu
4. Izvēlieties importēšanas veidu (FAQ/Produkta/Noklusējuma)
5. Izvēlieties kategoriju (pēc izvēles)
6. Noklikšķiniet uz Pievienot URL

Masveida importēšana:

1. Noklikšķiniet uz Masveida importēt URL
2. Ievadiet URL (katrs jaunā rindā)
3. Konfigurējiet kopīgās iestatījumus
4. Noklikšķiniet uz Importēt visus URL

3. solis: Konfigurēt kolonnu kartēšanu (tikai produktiem)

Kartējiet savas CSV kolonnas uz gaidītajām laukiem:

• ID produkta kolonna: Noklusējuma idProduct → Kartēt uz product_id, sku, utt.
• Nosaukuma kolonna: Noklusējuma name → Kartēt uz product_name, title, utt.

4. solis: Uzraudzīt importēšanu

Izsekojiet statusam importēšanas vēsturē:

• Gaidīšana: Gaida apstrādi
• Importēts: Veiksmīgi pabeigts
• Kļūda: Neizdevās (skatīt detaļas)

5. solis: Atkal importēt (atjaunināt datus)

1. Atrodiet URL vēsturē
2. Noklikšķiniet uz Atkal importēt
3. Apstipriniet darbību
4. Uzraudziet atjaunināto statusu

6. solis: Pārbaudīt importēšanu

1. Pārbaudiet zināšanu bāzi jaunajiem dokumentiem
2. Testējiet čatbotu ar jautājumiem par importēto saturu

---

CSV prasības

Derīgi 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 nav atbalstīts)
❌ https://private.site.com/auth-data.csv (Nepieciešama autentifikācija)
❌ file:///local/data.csv (Vietējie faili nav atbalstīti)

Failu prasības

• Piekļuve: Publiski pieejams caur HTTP/HTTPS
• Galvenes: Pirmajā rindā jābūt kolonnas nosaukumiem
• Atdalītāji: Komats (,) vai semikols (;)
• Kodējums: Ieteicams UTF-8
• Izmērs: Maksimāli 10MB uz failu

---

Problēmu novēršana

Biežākās kļūdas

Kļūda	Risinājums
URL nav pieejams	Pārliecinieties, ka URL ir publisks un derīgs
Nederīgs formāts	Pārbaudiet atdalītāju un galvenes
Trūkstošas kolonnas	Pārliecinieties, ka nepieciešamās kolonnas pastāv (jautājums/atbilde vai idProduct)
Liela faila laika izsīkums	Sadaliet failu vai samaziniet izmēru zem 10MB

Risināšanas soļi

1. Pārbaudiet URL pārlūkprogrammā
2. Validējiet CSV struktūru un kodējumu
3. Pārskatiet kļūdu ziņojumus importēšanas vēsturē
4. Testējiet ar mazāku paraugu failu
5. Sazinieties ar atbalsta dienestu, ja problēma saglabājas

---

Labākās prakses

URL pārvaldība

• Izmantojiet stabilas, pastāvīgas URL
• Testējiet URL katru mēnesi pieejamībai
• Izmantojiet CDN labākai veiktspējai
• Iekļaujiet versiju failu nosaukumos: products-v2024.csv

Datu organizācija

• Izmantojiet skaidras kategoriju nosaukumus
• Uzturiet konsekventus CSV formātus
• Notīriet datus pirms importēšanas (noņemiet tukšās rindas)
• Saglabājiet failus zem 10MB

Veiktspēja

• Sākumā testējiet ar maziem paraugiem
• Apstrādājiet lielus importus ārpus darba stundām
• Izmantojiet masveida importu vairākiem saistītiem URL
• Regulāri uzraugiet importa panākumu līmeni

---

Drošība

• ✅ HTTPS šifrēti pārraides
• ✅ URL validācija
• ✅ Atļauju balstīta piekļuves kontrole
• ✅ Pagaidu failu apstrāde (nav pastāvīgas glabāšanas)
• ✅ Automātiska veco datu tīrīšana
• ✅ Audita žurnāli visām aktivitātēm

---

Pēc importa

Kad dati ir importēti:

1. Tie kļūst meklējami zināšanu bāzē
2. Tie nekavējoties nodrošina čatbota atbildes
3. Tie parādās organizēti pa kategorijām
4. Tos var pārbaudīt Zināšanu bāzes sadaļā

Pārbaudiet savu importu:

• Pārbaudiet Zināšanu bāzi jaunajiem dokumentiem
• Testējiet čatbotu ar jautājumiem par importēto saturu
• Pārskatiet kategorijas un organizāciju

---

Atbalsts

Nepieciešama palīdzība?

• 📧 E-pasts: contact@aismarttalk.tech
• 📚 Dokumentācija: https://docs.aismarttalk.tech/

---

Kopsavilkums

Tagad jūs varat:

• ✅ Importēt CSV datus no publiskiem URL
• ✅ Apstrādāt FAQ, produktu un vispārīgus datu tipus
• ✅ Masveida importēt vairākus avotus
• ✅ Kartēt pielāgotas kolonnas produktiem
• ✅ Uzraudzīt un pārvaldīt importus
• ✅ Atjaunināt datus, veicot atkārtotu importēšanu

Nākamie soļi:

1. Testējiet ar paraugu CSV
2. Importējiet savus ražošanas datus
3. Iestatiet kategorijas
4. Plānojiet regulāras atkārtotas importēšanas
5. Uzraugiet veiktspēju

Jautājumi? Sazinieties ar mūsu atbalsta komandu jebkurā laikā.