CSV URL Integrācija

Importējiet dokumentus tieši no publiski pieejamiem CSV failiem, 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 nosaukums] → Integrācijas → CSV URL
2. Pievienojiet URL: Ievadiet savu publisko CSV URL un izvēlieties importēšanas veidu (FAQ/Produkta/Noklusējuma)
3. Importējiet: Noklikšķiniet uz "Pievienot URL" un uzraugiet statusu

Padoms: Vispirms izmēģiniet ar mazu 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
• ✅ Izsekot importēšanas statusu un vēsturi

---

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
• Ieteicams UTF-8 kodējums

---

Importēšanas veidi

1. FAQ Importēšana

Vislabā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

Vislabāk piemērots: E-komercijas katalogiem, inventāram

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

Vislabāk piemērots: Vispārējai 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

---

Solis pa Solim

1. solis: Piekļuve integrācijai

1. Pierakstieties 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īgas iestatījumus
4. Noklikšķiniet uz Importēt visus URL

3. solis: Konfigurēt kolonu kartēšanu (Tikai produktiem)

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

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

4. solis: Uzraudzīt importēšanu

Izsekojiet statusam importēšanas vēsturē:

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

5. solis: Atkārtota importēšana (Datu atjaunināšana)

1. Atrodiet URL vēsturē
2. Noklikšķiniet uz Atkārtota importēšana
3. Apstipriniet darbību
4. Uzraugiet atjaunināto statusu

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

1. Pārbaudiet zināšanu bāzi par jauniem 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 netiek atbalstīts)
❌ https://private.site.com/auth-data.csv (Nepieciešama autentifikācija)
❌ file:///local/data.csv (Vietējie faili netiek atbalstīti)

Failu prasības

• Piekļuve: Publiski pieejams caur HTTP/HTTPS
• Virsraksti: Pirmajā rindā jābūt kolonu 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 virsrakstus
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ūkā
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

• Vispirms testējiet ar maziem paraugiem
• Apstrādājiet lielas importa operācijas ārpus darba stundām
• Izmantojiet masveida importēšanu vairākiem saistītiem URL
• Regulāri uzraugiet importa panākumu līmeni

---

Drošība

• ✅ HTTPS šifrēti pārsūtījumi
• ✅ 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 importēšanas

Kad dati ir importēti, tie:

1. Kļūst meklējami zināšanu bāzē
2. Nekavējoties nodrošina atbildes čatbotam
3. Parādās organizēti pa kategorijām
4. Var tikt pārbaudīti 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ā.