Docusaurus

Synchronizuj swoją stronę dokumentacyjną Docusaurus z bazą wiedzy AI SmartTalk. Twój AI nauczy się z każdej strony w Twojej mapie witryny — idealne dla botów wsparcia, które odpowiadają na pytania techniczne.

---

Przegląd

Integracja Docusaurus umożliwia Ci:

• Importowanie wszystkich stron z Twojej mapy witryny automatycznie
• Utrzymywanie synchronizacji dokumentów podczas publikowania aktualizacji
• Odpowiadanie na pytania dotyczące Twojej dokumentacji w sposób konwersacyjny
• Redukcję obciążenia wsparcia poprzez pozwolenie AI na obsługę powszechnych pytań

Ciekawostka: Dokumentacja AI SmartTalk korzysta z Docusaurus, a ta integracja napędza naszego chatbota wsparcia!

---

Wymagania wstępne

Zanim zaczniesz, upewnij się, że masz:

• Aktywne konto AI SmartTalk
• Stronę Docusaurus z ważnym sitemap.xml
• Twoja strona musi być publicznie dostępna (lub zapewniać uwierzytelnienie)

---

Instrukcja krok po kroku

Krok 1: Zlokalizuj swoją mapę witryny

Docusaurus automatycznie generuje mapę witryny. Znajdź ją pod adresem:

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

Sprawdź, czy ładuje się w przeglądarce i zawiera strony dokumentacji.

Krok 2: Dodaj integrację Docusaurus

1. Zaloguj się na swoje konto AI SmartTalk
2. Przejdź do Ustawienia → Integracje
3. Znajdź Docusaurus i kliknij Połącz
4. Wprowadź adres URL swojej mapy witryny
5. Kliknij Waliduj

Krok 3: Skonfiguruj ustawienia importu

Po walidacji skonfiguruj swój import:

Ustawienie	Opis
URL mapy witryny	Pełny adres URL do Twojego sitemap.xml
Wzory do uwzględnienia	Synchronizuj tylko strony pasujące do wzorów (opcjonalne)
Wzory do wykluczenia	Pomiń konkretne strony lub sekcje (opcjonalne)

Krok 4: Rozpocznij import

1. Kliknij Importuj strony
2. AI SmartTalk przeszukuje każdy adres URL w Twojej mapie witryny
3. Treść jest wyodrębniana i dodawana do Twojej bazy wiedzy
4. Poczekaj na zakończenie importu (postęp pokazany)

Krok 5: Zweryfikuj import

1. Przejdź do Wiedza w AI SmartTalk
2. Twoje strony dokumentacji powinny się pojawić
3. Przetestuj swojego AI, zadając pytania dotyczące Twoich dokumentów

---

Co jest synchronizowane

Treść	Jak jest przetwarzana
Tytuł strony	Używany jako identyfikator dokumentu
Treść strony	Pełny tekst wyodrębniony z HTML
Nagłówki	Zachowane dla struktury
Bloki kodu	Włączone w oryginalnej formie
Tabele	Przekształcone do czytelnego formatu
URL	Adres URL strony przechowywany dla odniesienia

Wyodrębnianie treści

AI SmartTalk wyodrębnia główny obszar treści i ignoruje:

• Menu nawigacyjne
• Paski boczne
• Stopki
• Skrypty i style

---

Zachowanie synchronizacji

Ręczny import

Kliknij Importuj w ustawieniach integracji, aby:

• Pobrać najnowszą mapę witryny
• Dodać nowe strony
• Zaktualizować zmienione strony
• Usunąć usunięte strony

Utrzymywanie dokumentów na bieżąco

Aby dokumentacja była zawsze aktualna:

1. Ręczne odświeżenie: Kliknij Importuj po opublikowaniu aktualizacji
2. Zaplanowana synchronizacja: Użyj SmartFlow do automatyzacji importów

Zaplanowany import SmartFlow

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

---

Wzory URL

Wzory do uwzględnienia

Synchronizuj tylko konkretne sekcje:

Wzór	Efekt
/docs/api/*	Tylko dokumentacja API
/docs/guides/*	Tylko sekcja przewodników
/blog/*	Tylko posty na blogu

Wzory do wykluczenia

Pomiń określone strony:

Wzór	Efekt
/docs/internal/*	Pomiń dokumenty wewnętrzne
/changelog	Pomiń stronę changeloga
*/draft-*	Pomiń strony robocze

---

Przykłady użycia

Bot wsparcia technicznego

Synchronizuj swoją dokumentację produktową:

• "Jak zainstalować SDK?"
• "Jakie są limity API?"
• "Pokaż mi przykład uwierzytelnienia"

Dokumentacja dla programistów

Synchronizuj odniesienia API i przewodniki:

• "Jakie parametry akceptuje punkt końcowy /users?"
• "Jak obsługiwać webhooki?"
• "Jaka jest różnica między API v1 a v2?"

Wewnętrzna baza wiedzy

Synchronizuj firmowe wiki i procedury:

• "Jaki jest proces składania wniosku o urlop?"
• "Jak skonfigurować moje środowisko deweloperskie?"
• "Gdzie znajdę wytyczne dotyczące marki?"

---

Rozwiązywanie problemów

Problemy z mapą witryny

Problem	Rozwiązanie
"Nieprawidłowa mapa witryny"	Sprawdź, czy adres URL zwraca ważny XML
"Nie znaleziono stron"	Sprawdź, czy mapa witryny zawiera wpisy <url>
"Dostęp zabroniony"	Upewnij się, że mapa witryny jest publicznie dostępna

Problemy z importem

Problem	Rozwiązanie
Brakujące strony	Sprawdź wzory do uwzględnienia/wykluczenia
Import utknął	Duże strony zajmują czas; poczekaj lub importuj w partiach
Stara treść	Ponownie zaimportuj, aby pobrać najnowsze wersje

Jakość treści

Problem	Rozwiązanie
Wyodrębniona niewłaściwa treść	Zgłoś problem — może być potrzebne dostosowane wyodrębnianie
Brakujące bloki kodu	Upewnij się, że kod jest w standardowych tagach <pre><code>
Zniekształcony tekst	Sprawdź kodowanie strony (zalecane UTF-8)

---

Zarządzanie integracją

Akcja	Jak
Ponowny import wszystkich	Kliknij Importuj w ustawieniach integracji
Zmień mapę witryny	Zaktualizuj adres URL i ponownie zaimportuj
Usuń treść	Odłącz integrację lub usuń z Wiedzy
Odłącz	Ustawienia → Integracje → Docusaurus → Odłącz

---

Najlepsze praktyki

1. Jakość treści: Dobrze napisane dokumenty = lepsze odpowiedzi AI
2. Jasna struktura: Używaj nagłówków, list i tabel
3. Opisowe tytuły: Tytuły stron pomagają AI zrozumieć kontekst
4. Regularne synchronizacje: Utrzymuj AI na bieżąco z najnowszą dokumentacją
5. Dokładne testowanie: Zadawaj powszechne pytania, aby zweryfikować dokładność AI

---

Wskazówki dotyczące konfiguracji Docusaurus

Optymalizacja pod kątem wyodrębniania AI

W swoim docusaurus.config.js:

module.exports = {
  // Upewnij się, że mapa witryny jest generowana
  plugins: ['@docusaurus/plugin-sitemap'],
  
  // Używaj opisowych tytułów stron
  title: 'Dokumentacja Twojego Produktu',
  
  // Dodaj metadane
  themeConfig: {
    metadata: [{
      name: 'description',
      content: 'Dokumentacja dla Twojego Produktu'
    }],
  },
};

Wyklucz strony z mapy witryny

Aby zapobiec synchronizacji niektórych stron:

// W frontmatter strony
---
title: Strona wewnętrzna
sitemap:
  exclude: true
---

---

Powiązana dokumentacja

• Przegląd integracji
• Zarządzanie bazą wiedzy
• Integracja z RSS Feed — Dla treści bloga/aktualności
• Zaplanowane wyzwalacze SmartFlow — Automatyzuj importy