Docusaurus

Sincronizați site-ul dvs. de documentație Docusaurus în baza de cunoștințe AI SmartTalk. AI-ul dvs. va învăța din fiecare pagină din harta site-ului dvs. — perfect pentru boți de suport care răspund la întrebări tehnice.

---

Prezentare generală

Integrarea Docusaurus vă permite să:

• Importați toate paginile din harta site-ului dvs. automat
• Mențineți documentele sincronizate atunci când publicați actualizări
• Răspundeți la întrebări despre documentația dvs. într-un mod conversațional
• Reduceți sarcina de suport lăsând AI-ul să se ocupe de întrebările comune

Fapt amuzant: Documentația proprie a AI SmartTalk folosește Docusaurus, iar această integrare susține chatbot-ul nostru de suport!

---

Cerințe preliminare

Înainte de a începe, asigurați-vă că aveți:

• Un cont activ AI SmartTalk
• Un site Docusaurus cu un sitemap.xml valid
• Site-ul dvs. trebuie să fie accesibil public (sau să oferiți autentificare)

---

Configurare Pas cu Pas

Pasul 1: Localizați Harta Site-ului

Docusaurus generează automat o hartă a site-ului. O găsiți la:

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

Verificați că se încarcă în browserul dvs. și conține paginile de documentație.

Pasul 2: Adăugați Integrarea Docusaurus

1. Conectați-vă la contul dvs. AI SmartTalk
2. Navigați la Setări → Integrări
3. Găsiți Docusaurus și faceți clic pe Conectare
4. Introduceți URL-ul hărții site-ului dvs.
5. Faceți clic pe Validare

Pasul 3: Configurați Setările de Import

După validare, configurați importul:

Setare	Descriere
URL Harta Site-ului	URL complet către sitemap.xml
Modele de includere	Sincronizați doar paginile care se potrivesc cu modelele (opțional)
Modele de excludere	Săriți paginile sau secțiunile specifice (opțional)

Pasul 4: Începeți Importul

1. Faceți clic pe Importați Pagini
2. AI SmartTalk va explora fiecare URL din harta site-ului dvs.
3. Conținutul este extras și adăugat în baza dvs. de cunoștințe
4. Așteptați finalizarea importului (progresul va fi afișat)

Pasul 5: Verificați Importul

1. Accesați Cunoștințe în AI SmartTalk
2. Pagina dvs. de documentație ar trebui să apară
3. Testați AI-ul dvs. punând întrebări despre documentele dvs.

---

Ce se Sincronizează

Conținut	Cum este Procesat
Titlul paginii	Folosit ca identificator al documentului
Conținutul paginii	Textul complet extras din HTML
Titluri	Păstrate pentru structură
Blocuri de cod	Incluse așa cum sunt
Tabele	Convertite într-un format lizibil
URL-uri	URL-ul paginii stocat pentru referință

Extracția Conținutului

AI SmartTalk extrage zona principală de conținut și ignoră:

• Meniuri de navigare
• Bare laterale
• Subsoluri
• Scripturi și stiluri

---

Comportamentul de Sincronizare

Import Manual

Faceți clic pe Importați în setările integrării pentru a:

• Obține harta site-ului cea mai recentă
• Adăuga pagini noi
• Actualiza paginile modificate
• Îndepărta paginile șterse

Menținerea Documentelor Actualizate

Pentru documentație întotdeauna actualizată:

1. Reîmprospătare manuală: Faceți clic pe Import după publicarea actualizărilor
2. Sincronizare programată: Utilizați SmartFlow pentru a automatiza importurile

Import Programat SmartFlow

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

---

Modele URL

Modele de Includere

Sincronizați doar secțiuni specifice:

Model	Efect
/docs/api/*	Numai documentația API
/docs/guides/*	Numai secțiunea ghidurilor
/blog/*	Numai postările de blog

Modele de Excludere

Săriți anumite pagini:

Model	Efect
/docs/internal/*	Săriți documentele interne
/changelog	Săriți pagina de modificări
*/draft-*	Săriți paginile în draft

---

Cazuri de Utilizare

Bot de Suport Tehnic

Sincronizați documentația produsului dvs.:

• "Cum instalez SDK-ul?"
• "Care sunt limitele de rată ale API-ului?"
• "Arată-mi un exemplu de autentificare"

Documentație pentru Dezvoltatori

Sincronizați referințele API și ghidurile:

• "Ce parametri acceptă endpoint-ul /users?"
• "Cum gestionez webhook-urile?"
• "Care este diferența dintre API v1 și v2?"

Baza de Cunoștințe Interne

Sincronizați wiki-urile și procedurile companiei:

• "Care este procesul pentru solicitarea PTO?"
• "Cum îmi configurez mediul de dezvoltare?"
• "Unde găsesc liniile directoare ale brandului?"

---

Depanare

Probleme cu Harta Site-ului

Problemă	Soluție
"Harta site-ului invalidă"	Verificați că URL-ul returnează XML valid
"Nicio pagină găsită"	Verificați că harta site-ului conține intrări <url>
"Acces interzis"	Asigurați-vă că harta site-ului este accesibilă public

Probleme cu Importul

Problemă	Soluție
Pagini lipsă	Verificați modelele de includere/excludere
Import blocat	Site-urile mari necesită timp; așteptați sau importați în loturi
Conținut vechi	Re-importați pentru a obține cele mai recente versiuni

Calitatea Conținutului

Problemă	Soluție
Conținut greșit extras	Raportați problema — poate necesita extracție personalizată
Blocuri de cod lipsă	Verificați că codul este în etichetele standard <pre><code>
Text distorsionat	Verificați codificarea paginii (UTF-8 recomandat)

---

Gestionarea Integrării

Acțiune	Cum
Re-importați tot	Faceți clic pe Import în setările integrării
Schimbați harta site-ului	Actualizați URL-ul și re-importați
Îndepărtați conținutul	Deconectați integrarea sau ștergeți din Cunoștințe
Deconectați	Setări → Integrări → Docusaurus → Deconectare

---

Cele Mai Bune Practici

1. Conținut de calitate: Documente bine scrise = răspunsuri mai bune de la AI
2. Structură clară: Utilizați titluri, liste și tabele
3. Titluri descriptive: Titlurile paginilor ajută AI-ul să înțeleagă contextul
4. Sincronizări regulate: Mențineți AI-ul actualizat cu cea mai recentă documentație
5. Testați temeinic: Puneți întrebări comune pentru a verifica acuratețea AI-ului

---

Sfaturi pentru Configurarea Docusaurus

Optimizați pentru Extracția AI

În fișierul dvs. docusaurus.config.js:

module.exports = {
  // Asigurați-vă că harta site-ului este generată
  plugins: ['@docusaurus/plugin-sitemap'],
  
  // Utilizați titluri descriptive pentru pagini
  title: 'Documentația Produsului Dvs.',
  
  // Includeți metadate
  themeConfig: {
    metadata: [{
      name: 'description',
      content: 'Documentația pentru Produsul Dvs.'
    }],
  },
};

Excludeți Pagini din Harta Site-ului

Pentru a preveni sincronizarea anumitor pagini:

// În frontmatter-ul paginii
---
title: Pagina Internă
sitemap:
  exclude: true
---

---

Documentație Asemănătoare

• Prezentare Generală a Integrărilor
• Gestionarea Bazei de Cunoștințe
• Integrarea RSS Feed — Pentru conținut de blog/știri
• Declanșatoare Programate SmartFlow — Automatizați importurile