Docusaurus

Συγχρονίστε τον ιστότοπο τεκμηρίωσης Docusaurus σας με τη βάση γνώσεων του AI SmartTalk. Το AI σας θα μάθει από κάθε σελίδα στον χάρτη ιστότοπού σας—ιδανικό για ρομπότ υποστήριξης που απαντούν σε τεχνικές ερωτήσεις.

---

Επισκόπηση

Η ενσωμάτωση Docusaurus σας επιτρέπει να:

• Εισάγετε αυτόματα όλες τις σελίδες από τον χάρτη ιστότοπού σας
• Διατηρείτε συγχρονισμένα τα έγγραφα όταν δημοσιεύετε ενημερώσεις
• Απαντάτε σε ερωτήσεις σχετικά με την τεκμηρίωσή σας με συνομιλησιακό τρόπο
• Μειώνετε το φορτίο υποστήριξης επιτρέποντας στο AI να χειρίζεται κοινές ερωτήσεις

Διασκεδαστικό γεγονός: Η δική μας τεκμηρίωση του AI SmartTalk χρησιμοποιεί το Docusaurus, και αυτή η ενσωμάτωση τροφοδοτεί το ρομπότ υποστήριξής μας!

---

Προαπαιτούμενα

Πριν ξεκινήσετε, βεβαιωθείτε ότι έχετε:

• Έναν ενεργό λογαριασμό AI SmartTalk
• Έναν ιστότοπο Docusaurus με έγκυρο sitemap.xml
• Ο ιστότοπός σας πρέπει να είναι δημόσια προσβάσιμος (ή να παρέχει αυθεντικοποίηση)

---

Βήμα-Βήμα Ρύθμιση

Βήμα 1: Εντοπίστε τον Χάρτη Ιστότοπού σας

Το Docusaurus δημιουργεί αυτόματα έναν χάρτη ιστότοπου. Βρείτε τον στη διεύθυνση:

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

Επιβεβαιώστε ότι φορτώνει στον περιηγητή σας και περιέχει τις σελίδες τεκμηρίωσής σας.

Βήμα 2: Προσθέστε την Ενσωμάτωση Docusaurus

1. Συνδεθείτε στον λογαριασμό σας AI SmartTalk
2. Μεταβείτε στις Ρυθμίσεις → Ενσωματώσεις
3. Βρείτε το Docusaurus και κάντε κλικ στο Σύνδεση
4. Εισάγετε τη διεύθυνση URL του χάρτη ιστότοπού σας
5. Κάντε κλικ στο Επικύρωση

Βήμα 3: Ρυθμίστε τις Ρυθμίσεις Εισαγωγής

Μετά την επικύρωση, ρυθμίστε την εισαγωγή σας:

Ρύθμιση	Περιγραφή
Διεύθυνση URL Χάρτη Ιστότοπου	Πλήρης διεύθυνση URL στο sitemap.xml σας
Πρότυπα Συμπερίληψης	Συγχρονίστε μόνο σελίδες που ταιριάζουν με πρότυπα (προαιρετικό)
Πρότυπα Εξαίρεσης	Παράλειψη συγκεκριμένων σελίδων ή τμημάτων (προαιρετικό)

Βήμα 4: Ξεκινήστε την Εισαγωγή

1. Κάντε κλικ στο Εισαγωγή Σελίδων
2. Το AI SmartTalk εξερευνά κάθε διεύθυνση URL στον χάρτη ιστότοπού σας
3. Το περιεχόμενο εξάγεται και προστίθεται στη βάση γνώσεών σας
4. Περιμένετε να ολοκληρωθεί η εισαγωγή (η πρόοδος εμφανίζεται)

Βήμα 5: Επιβεβαιώστε την Εισαγωγή

1. Μεταβείτε στο Γνώση στο AI SmartTalk
2. Οι σελίδες τεκμηρίωσής σας θα πρέπει να εμφανίζονται
3. Δοκιμάστε το AI σας κάνοντας ερωτήσεις σχετικά με τα έγγραφά σας

---

Τι Συγχρονίζεται

Περιεχόμενο	Πώς Επεξεργάζεται
Τίτλος Σελίδας	Χρησιμοποιείται ως αναγνωριστικό εγγράφου
Περιεχόμενο Σελίδας	Πλήρης κείμενο που εξάγεται από HTML
Επικεφαλίδες	Διατηρούνται για τη δομή
Κωδικοί	Συμπεριλαμβάνονται όπως είναι
Πίνακες	Μετατρέπονται σε αναγνώσιμο μορφότυπο
Διευθύνσεις URL	Η διεύθυνση URL της σελίδας αποθηκεύεται για αναφορά

Εξαγωγή Περιεχομένου

Το AI SmartTalk εξάγει την κύρια περιοχή περιεχομένου και αγνοεί:

• Μενού πλοήγησης
• Πλευρικές μπάρες
• Υποσέλιδα
• Σενάρια και στυλ

---

Συμπεριφορά Συγχρονισμού

Χειροκίνητη Εισαγωγή

Κάντε κλικ στο Εισαγωγή στις ρυθμίσεις ενσωμάτωσης για να:

• Λάβετε τον τελευταίο χάρτη ιστότοπου
• Προσθέσετε νέες σελίδες
• Ενημερώσετε τις αλλαγμένες σελίδες
• Αφαιρέσετε τις διαγραμμένες σελίδες

Διατήρηση Εγγράφων Φρέσκων

Για πάντα ενημερωμένη τεκμηρίωση:

1. Χειροκίνητη ανανέωση: Κάντε κλικ στην Εισαγωγή μετά τη δημοσίευση ενημερώσεων
2. Προγραμματισμένος συγχρονισμός: Χρησιμοποιήστε το SmartFlow για να αυτοματοποιήσετε τις εισαγωγές

Προγραμματισμένη Εισαγωγή SmartFlow

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

---

Πρότυπα Διευθύνσεων URL

Πρότυπα Συμπερίληψης

Συγχρονίστε μόνο συγκεκριμένα τμήματα:

Πρότυπο	Επίδραση
/docs/api/*	Μόνο τεκμηρίωση API
/docs/guides/*	Μόνο τμήμα οδηγιών
/blog/*	Μόνο αναρτήσεις ιστολογίου

Πρότυπα Εξαίρεσης

Παραλείψτε ορισμένες σελίδες:

Πρότυπο	Επίδραση
/docs/internal/*	Παράλειψη εσωτερικών εγγράφων
/changelog	Παράλειψη σελίδας changelog
*/draft-*	Παράλειψη σελίδων προσχεδίων

---

Χρήσεις

Ρομπότ Τεχνικής Υποστήριξης

Συγχρονίστε την τεκμηρίωση προϊόντος σας:

• "Πώς να εγκαταστήσω το SDK;"
• "Ποιες είναι οι περιορισμοί ρυθμίσεων API;"
• "Δείξτε μου ένα παράδειγμα αυθεντικοποίησης"

Τεκμηρίωση Προγραμματιστή

Συγχρονίστε αναφορές και οδηγούς API:

• "Ποιες παράμετροι δέχεται το endpoint /users;"
• "Πώς να χειριστώ webhooks;"
• "Ποια είναι η διαφορά μεταξύ v1 και v2 API;"

Εσωτερική Βάση Γνώσεων

Συγχρονίστε εταιρικά wikis και διαδικασίες:

• "Πια είναι η διαδικασία για να ζητήσω PTO;"
• "Πώς να ρυθμίσω το περιβάλλον ανάπτυξής μου;"
• "Πού μπορώ να βρω τις κατευθυντήριες γραμμές της μάρκας;"

---

Αντιμετώπιση Προβλημάτων

Ζητήματα Χάρτη Ιστότοπου

Ζήτημα	Λύση
"Μη έγκυρος χάρτης ιστότοπου"	Επιβεβαιώστε ότι η διεύθυνση URL επιστρέφει έγκυρο XML
"Καμία σελίδα δεν βρέθηκε"	Ελέγξτε αν ο χάρτης ιστότοπου περιέχει καταχωρήσεις <url>
"Απαγόρευση πρόσβασης"	Βεβαιωθείτε ότι ο χάρτης ιστότοπου είναι δημόσια προσβάσιμος

Ζητήματα Εισαγωγής

Ζήτημα	Λύση
Σελίδες που λείπουν	Ελέγξτε τα πρότυπα συμπερίληψης/εξαίρεσης
Εισαγωγή κολλημένη	Μεγάλες τοποθεσίες χρειάζονται χρόνο; περιμένετε ή εισάγετε σε παρτίδες
Παλιό περιεχόμενο	Επαναφέρετε για να αποκτήσετε τις τελευταίες εκδόσεις

Ποιότητα Περιεχομένου

Ζήτημα	Λύση
Λάθος περιεχόμενο εξαγόμενο	Αναφέρετε το ζήτημα—μπορεί να χρειαστεί προσαρμοσμένη εξαγωγή
Λείπουν κωδικοί	Επιβεβαιώστε ότι ο κωδικός είναι σε τυπικές ετικέτες <pre><code>
Ακατάληπτο κείμενο	Ελέγξτε την κωδικοποίηση της σελίδας (συνιστάται UTF-8)

---

Διαχείριση της Ενσωμάτωσης

Δράση	Πώς
Επαναφορά όλων	Κάντε κλικ στο Εισαγωγή στις ρυθμίσεις ενσωμάτωσης
Αλλαγή χάρτη ιστότοπου	Ενημερώστε τη διεύθυνση URL και επαναφέρετε
Αφαίρεση περιεχομένου	Αποσυνδέστε την ενσωμάτωση ή διαγράψτε από τη Γνώση
Αποσύνδεση	Ρυθμίσεις → Ενσωματώσεις → Docusaurus → Αποσύνδεση

---

Καλές Πρακτικές

1. Ποιότητα περιεχομένου: Καλά γραμμένα έγγραφα = καλύτερες απαντήσεις AI
2. Καθαρή δομή: Χρησιμοποιήστε επικεφαλίδες, λίστες και πίνακες
3. Περιγραφικοί τίτλοι: Οι τίτλοι σελίδων βοηθούν το AI να κατανοήσει το πλαίσιο
4. Τακτικοί συγχρονισμοί: Διατηρήστε το AI ενημερωμένο με την τελευταία τεκμηρίωση
5. Δοκιμάστε διεξοδικά: Κάντε κοινές ερωτήσεις για να επιβεβαιώσετε την ακρίβεια του AI

---

Συμβουλές Ρύθμισης Docusaurus

Βελτιστοποίηση για Εξαγωγή AI

Στο docusaurus.config.js σας:

module.exports = {
  // Βεβαιωθείτε ότι ο χάρτης ιστότοπου δημιουργείται
  plugins: ['@docusaurus/plugin-sitemap'],
  
  // Χρησιμοποιήστε περιγραφικούς τίτλους σελίδων
  title: 'Τα Έγγραφα του Προϊόντος σας',
  
  // Συμπεριλάβετε μεταδεδομένα
  themeConfig: {
    metadata: [{
      name: 'description',
      content: 'Τεκμηρίωση για το Προϊόν σας'
    }],
  },
};

Εξαίρεση Σελίδων από τον Χάρτη Ιστότοπου

Για να αποτρέψετε ορισμένες σελίδες από το να συγχρονιστούν:

// Στο frontmatter της σελίδας
---
title: Εσωτερική Σελίδα
sitemap:
  exclude: true
---

---

Σχετική Τεκμηρίωση

• Επισκόπηση Ενσωματώσεων
• Διαχείριση Βάσης Γνώσεων
• Ενσωμάτωση RSS Feed — Για περιεχόμενο ιστολογίου/ειδήσεων
• Προγραμματισμένοι Ενεργοποιητές SmartFlow — Αυτοματοποιήστε τις εισαγωγές