Docusaurus

Synkronisera din Docusaurus-dokumentationswebbplats med AI SmartTalks kunskapsbas. Din AI kommer att lära sig från varje sida i din webbplatskarta—perfekt för supportrobotar som svarar på tekniska frågor.

---

Översikt

Docusaurus-integrationen möjliggör att du kan:

• Importera alla sidor från din webbplatskarta automatiskt
• Hålla dokument synkroniserade när du publicerar uppdateringar
• Svara på frågor om din dokumentation konversativt
• Minska supportbelastningen genom att låta AI hantera vanliga frågor

Rolig fakta: AI SmartTalks egen dokumentation använder Docusaurus, och denna integration driver vår supportchattbot!

---

Förutsättningar

Innan du börjar, se till att du har:

• Ett aktivt AI SmartTalk-konto
• En Docusaurus-webbplats med en giltig sitemap.xml
• Din webbplats måste vara offentligt tillgänglig (eller tillhandahålla autentisering)

---

Steg-för-steg-installation

Steg 1: Lokalisera din webbplatskarta

Docusaurus genererar automatiskt en webbplatskarta. Hitta den på:

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

Verifiera att den laddas i din webbläsare och innehåller dina dokumentationssidor.

Steg 2: Lägg till Docusaurus-integrationen

1. Logga in på ditt AI SmartTalk-konto
2. Navigera till Inställningar → Integrationer
3. Hitta Docusaurus och klicka på Anslut
4. Ange din webbplatskarts-URL
5. Klicka på Validera

Steg 3: Konfigurera importinställningar

Efter validering, konfigurera din import:

Inställning	Beskrivning
Webbplatskarts-URL	Fullständig URL till din sitemap.xml
Inkludera mönster	Endast synkronisera sidor som matchar mönster (valfritt)
Exkludera mönster	Hoppa över specifika sidor eller sektioner (valfritt)

Steg 4: Starta importen

1. Klicka på Importera sidor
2. AI SmartTalk genomsöker varje URL i din webbplatskarta
3. Innehållet extraheras och läggs till i din kunskapsbas
4. Vänta på att importen ska slutföras (framsteg visas)

Steg 5: Verifiera importen

1. Gå till Kunskap i AI SmartTalk
2. Dina dokumentationssidor bör visas
3. Testa din AI genom att ställa frågor om dina dokument

---

Vad som synkroniseras

Innehåll	Hur det bearbetas
Sidtitel	Används som dokumentidentifierare
Sidinnehåll	Fullständig text extraherad från HTML
Rubriker	Bevaras för struktur
Kodblock	Inkluderas som de är
Tabeller	Konverteras till läsbart format
URLs	Sidans URL lagras för referens

Innehållsextraktion

AI SmartTalk extraherar huvudområdena för innehåll och ignorerar:

• Navigationsmenyer
• Sidofält
• Sidfötter
• Skript och stilar

---

Synkroniseringsbeteende

Manuell import

Klicka på Importera i integrationsinställningarna för att:

• Hämta den senaste webbplatskartan
• Lägga till nya sidor
• Uppdatera ändrade sidor
• Ta bort raderade sidor

Hålla dokumentationen aktuell

För alltid aktuell dokumentation:

1. Manuell uppdatering: Klicka på Importera efter publicering av uppdateringar
2. Schemalagd synkronisering: Använd SmartFlow för att automatisera importer

SmartFlow Schemalagd Import

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

---

URL-mönster

Inkludera mönster

Synkronisera endast specifika sektioner:

Mönster	Effekt
/docs/api/*	Endast API-dokumentation
/docs/guides/*	Endast guideavsnitt
/blog/*	Endast blogginlägg

Exkludera mönster

Hoppa över vissa sidor:

Mönster	Effekt
/docs/internal/*	Hoppa över interna dokument
/changelog	Hoppa över changelog-sidan
*/draft-*	Hoppa över utkastssidor

---

Användningsfall

Teknisk supportbot

Synkronisera din produktdokumentation:

• "Hur installerar jag SDK:n?"
• "Vad är API:s hastighetsbegränsningar?"
• "Visa mig ett exempel på autentisering"

Utvecklardokumentation

Synkronisera API-referenser och guider:

• "Vilka parametrar accepterar /users-endpointet?"
• "Hur hanterar jag webhooks?"
• "Vad är skillnaden mellan v1 och v2 API?"

Intern kunskapsbas

Synkronisera företags-wikier och procedurer:

• "Vad är processen för att begära PTO?"
• "Hur sätter jag upp min utvecklingsmiljö?"
• "Var hittar jag varumärkesriktlinjerna?"

---

Felsökning

Webbplatskartsproblem

Problem	Lösning
"Ogiltig webbplatskarta"	Verifiera att URL:en returnerar giltig XML
"Inga sidor hittades"	Kontrollera att webbplatskartan innehåller <url>-poster
"Åtkomst nekad"	Se till att webbplatskartan är offentligt tillgänglig

Importproblem

Problem	Lösning
Sidor saknas	Kontrollera inkluderings-/exkluderingsmönster
Import fast	Stora webbplatser tar tid; vänta eller importera i omgångar
Gammalt innehåll	Återimportera för att hämta de senaste versionerna

Innehållskvalitet

Problem	Lösning
Felaktigt innehåll extraherat	Rapportera problemet—kan behöva anpassad extraktion
Saknade kodblock	Verifiera att koden är i standard <pre><code>-taggar
Otydlig text	Kontrollera sidkodning (UTF-8 rekommenderas)

---

Hantera integrationen

Åtgärd	Hur
Återimportera allt	Klicka på Importera i integrationsinställningarna
Ändra webbplatskarta	Uppdatera URL och återimportera
Ta bort innehåll	Koppla bort integrationen eller ta bort från Knowledge
Koppla bort	Inställningar → Integrationer → Docusaurus → Koppla bort

---

Bästa Praxis

1. Kvalitetsinnehåll: Välskrivna dokument = bättre AI-svar
2. Tydlig struktur: Använd rubriker, listor och tabeller
3. Beskrivande titlar: Sidtitlar hjälper AI att förstå sammanhang
4. Regelbundna synkroniseringar: Håll AI uppdaterad med den senaste dokumentationen
5. Testa noggrant: Ställ vanliga frågor för att verifiera AI:s noggrannhet

---

Docusaurus Konfigurationstips

Optimera för AI-extraktion

I din docusaurus.config.js:

module.exports = {
  // Ensure sitemap is generated
  plugins: ['@docusaurus/plugin-sitemap'],
  
  // Use descriptive page titles
  title: 'Your Product Docs',
  
  // Include metadata
  themeConfig: {
    metadata: [{
      name: 'description',
      content: 'Documentation for Your Product'
    }],
  },
};

Exkludera sidor från sitemap

För att förhindra att vissa sidor synkroniseras:

// In page frontmatter
---
title: Internal Page
sitemap:
  exclude: true
---

---

Relaterad Dokumentation

• Integrationsöversikt
• Kunskapsbashantering
• RSS-flödesintegration — För blogg-/nyhetsinnehåll
• SmartFlow Schemalagda Utlösare — Automatisera importer