Docusaurus

Sinchronizuokite savo Docusaurus dokumentacijos svetainę su AI SmartTalk žinių baze. Jūsų AI mokysis iš kiekvienos puslapio jūsų svetainės žemėlapyje—puikiai tinka palaikymo robotams, kurie atsako į techninius klausimus.

---

Apžvalga

Docusaurus integracija leidžia jums:

• Importuoti visus puslapius iš jūsų svetainės žemėlapio automatiškai
• Išlaikyti dokumentus sinchronizuotus kai skelbiami atnaujinimai
• Atsakyti į klausimus apie jūsų dokumentaciją pokalbiu
• Sumažinti palaikymo naštą leidžiant AI spręsti dažnus klausimus

Įdomus faktas: AI SmartTalk dokumentacija naudoja Docusaurus, o ši integracija palaiko mūsų palaikymo chatbot'ą!

---

Reikalavimai

Prieš pradėdami, įsitikinkite, kad turite:

• Aktyvią AI SmartTalk paskyrą
• Docusaurus svetainę su galiojančiu sitemap.xml
• Jūsų svetainė turi būti viešai prieinama (arba suteikti autentifikaciją)

---

Žingsnis po žingsnio nustatymas

1 žingsnis: Raskite savo svetainės žemėlapį

Docusaurus automatiškai generuoja svetainės žemėlapį. Rasite jį adresu:

https://your-docs-site.com/sitemap.xml

Patikrinkite, ar jis įsikrauna jūsų naršyklėje ir ar jame yra jūsų dokumentacijos puslapiai.

2 žingsnis: Pridėkite Docusaurus integraciją

1. Prisijunkite prie savo AI SmartTalk paskyros
2. Eikite į Nustatymai → Integracijos
3. Suraskite Docusaurus ir spustelėkite Prijungti
4. Įveskite savo svetainės žemėlapio URL
5. Spustelėkite Patvirtinti

3 žingsnis: Suconfigure Import Settings

Po patvirtinimo sukonfigūruokite savo importą:

Nustatymas	Aprašymas
Svetainės žemėlapio URL	Pilnas URL į jūsų sitemap.xml
Įtraukti šablonai	Sinchronizuoti tik puslapius, atitinkančius šablonus (pasirinktinai)
Išskirti šablonai	Praleisti konkrečius puslapius ar skyrius (pasirinktinai)

4 žingsnis: Pradėkite importą

1. Spustelėkite Importuoti puslapius
2. AI SmartTalk naršo kiekvieną URL jūsų svetainės žemėlapyje
3. Turinys ištraukiamas ir pridedamas prie jūsų žinių bazės
4. Palaukite, kol importas bus baigtas (progresas rodomas)

5 žingsnis: Patikrinkite importą

1. Eikite į Žinios AI SmartTalk
2. Jūsų dokumentacijos puslapiai turėtų pasirodyti
3. Išbandykite savo AI užduodami klausimus apie savo dokumentus

---

Kas sinchronizuojama

Turinys	Kaip jis apdorojamas
Puslapio pavadinimas	Naudojamas kaip dokumento identifikatorius
Puslapio turinys	Pilnas tekstas ištrauktas iš HTML
Antraštės	Išlaikytos struktūrai
Kodo blokai	Įtraukti kaip yra
Lentelės	Paverstos į skaitomą formatą
URL	Puslapio URL saugomas nuorodai

Turinys Ištraukimas

AI SmartTalk ištraukia pagrindinę turinio sritį ir ignoruoja:

• Navigacijos meniu
• Šonines juostas
• Poras
• Skriptus ir stilius

---

Sinchronizavimo Elgsena

Rankinis Importavimas

Paspauskite Importuoti integracijos nustatymuose, kad:

• Gauti naujausią svetainės žemėlapį
• Pridėti naujas puslapius
• Atnaujinti pakeistus puslapius
• Pašalinti ištrintus puslapius

Dokumentų Atkūrimas

Norint, kad dokumentacija visada būtų naujausia:

1. Rankinis atnaujinimas: Paspauskite Importuoti po atnaujinimų paskelbimo
2. Planuota sinchronizacija: Naudokite SmartFlow automatizuoti importus

SmartFlow Planuotas Importas

Workflow: Docusaurus Auto-Sync
Trigger: Scheduled (Daily at 3:00 AM)
Actions:
  - Sync Connector:
      Type: Docusaurus
      Sitemap: https://docs.example.com/sitemap.xml

---

URL Šablonai

Įtraukti Šablonai

Sinchronizuokite tik specifines dalis:

Šablonas	Efektas
/docs/api/*	Tik API dokumentacija
/docs/guides/*	Tik gidų skyrius
/blog/*	Tik tinklaraščio įrašai

Išskirti Šablonai

Praleiskite tam tikrus puslapius:

Šablonas	Efektas
/docs/internal/*	Praleisti vidinę dokumentaciją
/changelog	Praleisti pakeitimų žurnalo puslapį
*/draft-*	Praleisti juodraščio puslapius

---

Naudojimo Atvejai

Techninės Pagalbos Botas

Sinchronizuokite savo produkto dokumentaciją:

• "Kaip įdiegti SDK?"
• "Kokie yra API greičio limitai?"
• "Parodykite man autentifikacijos pavyzdį"

Kūrėjų Dokumentacija

Sinchronizuokite API nuorodas ir gidus:

• "Kokius parametrus priima /users API?"
• "Kaip tvarkyti webhook'us?"
• "Koks skirtumas tarp v1 ir v2 API?"

Vidinė Žinių Bazė

Sinchronizuokite įmonės vikius ir procedūras:

• "Koks procesas prašyti PTO?"
• "Kaip nustatyti savo kūrimo aplinką?"
• "Kur rasti prekės ženklo gaires?"

---

Problemos Sprendimas

Svetainės Žemėlapio Problemos

Problema	Sprendimas
"Neteisingas svetainės žemėlapis"	Patikrinkite, ar URL grąžina galiojantį XML
"Nerasta puslapių"	Patikrinkite, ar svetainės žemėlapis turi <url> įrašus
"Prieiga atimta"	Užtikrinkite, kad svetainės žemėlapis būtų viešai prieinamas

Importavimo Problemos

Problema	Sprendimas
Puslapiai trūksta	Patikrinkite įtraukti/išskirti šablonus
Importas sustojo	Didelėms svetainėms reikia laiko; palaukite arba importuokite grupėmis
Senas turinys	Pakartotinai importuokite, kad gautumėte naujausias versijas

Turinys

Problema	Sprendimas
Neteisingas turinys išgautas	Praneškite apie problemą—gali prireikti individualaus išgavimo
Trūksta kodo blokų	Patikrinkite, ar kodas yra standartiniuose <pre><code> žymėse
Iškraipytas tekstas	Patikrinkite puslapio kodavimą (rekomenduojama UTF-8)

---

Integracijos Valdymas

Veiksmas	Kaip
Pakartotinai importuoti viską	Paspauskite Importuoti integracijos nustatymuose
Pakeisti svetainės žemėlapį	Atnaulinkite URL ir pakartotinai importuokite
Pašalinti turinį	Atjunkite integraciją arba ištrinkite iš Žinių
Atjungti	Nustatymai → Integracijos → Docusaurus → Atjungti

---

Geriausios Praktikos

1. Kokybiškas turinys: Gerai parašyti dokumentai = geresni AI atsakymai
2. Aiški struktūra: Naudokite antraštes, sąrašus ir lenteles
3. Aprašomieji pavadinimai: Puslapio pavadinimai padeda AI suprasti kontekstą
4. Reguliarūs sinchronizavimai: Laikykite AI atnaujintą su naujausia dokumentacija
5. Išsamiai testuokite: Užduokite dažnai pasitaikančius klausimus, kad patikrintumėte AI tikslumą

---

Docusaurus Konfigūracijos Patarimai

Optimizuokite AI Išgavimui

Jūsų docusaurus.config.js:

module.exports = {
  // Užtikrinkite, kad svetainės žemėlapis būtų sugeneruotas
  plugins: ['@docusaurus/plugin-sitemap'],
  
  // Naudokite aprašomuosius puslapio pavadinimus
  title: 'Jūsų Produkto Dokumentai',
  
  // Įtraukite metaduomenis
  themeConfig: {
    metadata: [{
      name: 'description',
      content: 'Dokumentacija Jūsų Produktui'
    }],
  },
};

Išskirkite Puslapius iš Svetainės Žemėlapio

Norėdami užkirsti kelią tam tikrų puslapių sinchronizavimui:

// Puslapio frontmatter
---
title: Vidinis Puslapis
sitemap:
  exclude: true
---

---

Susijusi Dokumentacija

• Integracijų Apžvalga
• Žinių Bazės Valdymas
• RSS Feedo Integracija — Blogo/naujienų turiniui
• SmartFlow Planuojami Įvykiai — Automatizuokite importus