Docusaurus

Sinhronizujte vašu Docusaurus dokumentacionu stranicu u AI SmartTalk-ovu bazu znanja. Vaš AI će učiti sa svake stranice u vašem sitemap-u—savršeno za botove za podršku koji odgovaraju na tehnička pitanja.

---

Pregled

Docusaurus integracija vam omogućava da:

• Uvezete sve stranice iz vašeg sitemap-a automatski
• Održavate dokumente sinhronizovanim kada objavite ažuriranja
• Odgovarate na pitanja o vašoj dokumentaciji razgovorno
• Smanjite opterećenje podrške tako što ćete dozvoliti AI-u da se bavi uobičajenim pitanjima

Zanimljiva činjenica: Dokumentacija AI SmartTalk-a koristi Docusaurus, a ova integracija pokreće naš chatbot za podršku!

---

Preduslovi

Pre nego što počnete, osigurajte da imate:

• Aktivni AI SmartTalk nalog
• Docusaurus sajt sa važećim sitemap.xml
• Vaš sajt mora biti javno dostupan (ili obezbediti autentifikaciju)

---

Postupak postavljanja

Korak 1: Pronađite svoj Sitemap

Docusaurus automatski generiše sitemap. Pronađite ga na:

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

Proverite da li se učitava u vašem pretraživaču i da sadrži stranice vaše dokumentacije.

Korak 2: Dodajte Docusaurus integraciju

1. Prijavite se na svoj AI SmartTalk nalog
2. Idite na Podešavanja → Integracije
3. Pronađite Docusaurus i kliknite na Poveži
4. Unesite URL vašeg sitemap-a
5. Kliknite na Validiraj

Korak 3: Konfigurišite podešavanja uvoza

Nakon validacije, konfigurišite svoj uvoz:

Podešavanje	Opis
Sitemap URL	Pun URL do vašeg sitemap.xml
Uključite obrasce	Samo sinhronizujte stranice koje odgovaraju obrascima (opciono)
Isključite obrasce	Preskočite specifične stranice ili sekcije (opciono)

Korak 4: Pokrenite uvoz

1. Kliknite na Uvezi stranice
2. AI SmartTalk pretražuje svaku URL adresu u vašem sitemap-u
3. Sadržaj se ekstraktuje i dodaje u vašu bazu znanja
4. Sačekajte da se uvoz završi (prikazan napredak)

Korak 5: Proverite uvoz

1. Idite na Znanje u AI SmartTalk
2. Stranice vaše dokumentacije bi trebalo da se pojave
3. Testirajte vaš AI postavljanjem pitanja o vašim dokumentima

---

Šta se sinhronizuje

Sadržaj	Kako se obrađuje
Naslov stranice	Koristi se kao identifikator dokumenta
Sadržaj stranice	Ceo tekst ekstraktovan iz HTML-a
Naslovi	Očuvani za strukturu
Kod blokovi	Uključeni onakvi kakvi jesu
Tabele	Pretvorene u čitljiv format
URL-ovi	URL stranice sačuvan za referencu

Ekstrakcija sadržaja

AI SmartTalk ekstraktuje glavni sadržaj i ignoriše:

• Navigacione menije
• Bočne trake
• Podnožja
• Skripte i stilove

---

Sinhronizacija

Ručni Uvoz

Kliknite na Uvezi u podešavanjima integracije da biste:

• Preuzeli najnoviji sitemap
• Dodali nove stranice
• Ažurirali promenjene stranice
• Uklonili obrisane stranice

Održavanje Dokumentacije Ažurnom

Za uvek aktuelnu dokumentaciju:

1. Ručna osvežavanje: Kliknite na Uvezi nakon objavljivanja ažuriranja
2. Zakazana sinhronizacija: Koristite SmartFlow za automatizaciju uvoza

SmartFlow Zakazani Uvoz

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

---

URL Obrasci

Uključivanje Obrasca

Sinhronizujte samo specifične sekcije:

Obrasci	Efekat
/docs/api/*	Samo API dokumentacija
/docs/guides/*	Samo sekcija vodiča
/blog/*	Samo blog postovi

Isključivanje Obrasca

Preskočite određene stranice:

Obrasci	Efekat
/docs/internal/*	Preskočite interne dokumente
/changelog	Preskočite stranicu sa promenama
*/draft-*	Preskočite nacrte stranica

---

Upotrebe

Tehnička Podrška Bot

Sinhronizujte dokumentaciju vašeg proizvoda:

• "Kako da instaliram SDK?"
• "Koja su ograničenja API poziva?"
• "Pokaži mi primer autentifikacije"

Dokumentacija za Razvojne Programere

Sinhronizujte API reference i vodiče:

• "Koje parametre prihvata /users endpoint?"
• "Kako da obradim webhook-ove?"
• "Koja je razlika između v1 i v2 API?"

Interna Baza Znanja

Sinhronizujte kompanijske wikipedije i procedure:

• "Koji je proces za traženje PTO?"
• "Kako da postavim svoje razvojno okruženje?"
• "Gde mogu pronaći smernice za brend?"

---

Rešavanje Problema

Problemi sa Sitemap-om

Problem	Rešenje
"Neispravan sitemap"	Proverite da li URL vraća validan XML
"Nema pronađenih stranica"	Proverite da li sitemap sadrži <url> unose
"Pristup odbijen"	Osigurajte da je sitemap javno dostupan

Problemi sa Uvozom

Problem	Rešenje
Nedostaju stranice	Proverite obrasce uključivanja/isključivanja
Uvoz zaglavljen	Veliki sajtovi zahtevaju vreme; sačekajte ili uvezite u serijama
Stari sadržaj	Ponovo uvezite da biste preuzeli najnovije verzije

Kvalitet Sadržaja

Problem	Rešenje
Pogrešan sadržaj izvučen	Prijavite problem—možda je potrebna prilagođena ekstrakcija
Nedostaju kod blokovi	Proverite da li je kod u standardnim <pre><code> oznakama
Izmešan tekst	Proverite kodiranje stranice (preporučuje se UTF-8)

---

Upravljanje Integracijom

Akcija	Kako
Ponovo uvezi sve	Kliknite na Uvezi u podešavanjima integracije
Promeni sitemap	Ažurirajte URL i ponovo uvezite
Ukloni sadržaj	Prekinite integraciju ili obrišite iz Baze Znanja
Prekini vezu	Podešavanja → Integracije → Docusaurus → Prekini vezu

---

Najbolje Prakse

1. Kvalitetan sadržaj: Dobro napisani dokumenti = bolji AI odgovori
2. Jasna struktura: Koristite naslove, liste i tabele
3. Opisni naslovi: Naslovi stranica pomažu AI da razume kontekst
4. Redovne sinhronizacije: Održavajte AI ažuriranim sa najnovijom dokumentacijom
5. Temeljno testiranje: Postavljajte uobičajena pitanja da biste proverili tačnost AI

---

Docusaurus Saveti za Konfiguraciju

Optimizujte za AI Ekstrakciju

U vašem docusaurus.config.js:

module.exports = {
  // Osigurajte da se generiše mapa sajta
  plugins: ['@docusaurus/plugin-sitemap'],
  
  // Koristite opisne naslove stranica
  title: 'Dokumentacija za Vaš Proizvod',
  
  // Uključite metapodatke
  themeConfig: {
    metadata: [{
      name: 'description',
      content: 'Dokumentacija za Vaš Proizvod'
    }],
  },
};

Isključite Stranice iz Mape Sajta

Da biste sprečili da se određene stranice sinhronizuju:

// U frontmatter stranice
---
title: Interna Stranica
sitemap:
  exclude: true
---

---

Povezana Dokumentacija

• Pregled Integracija
• Upravljanje Bazom Znanja
• Integracija RSS Feeda — Za blog/novinske sadržaje
• SmartFlow Zakazani Okidači — Automatizujte uvoze