Docusaurus

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

---

Επισκόπηση

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

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

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

---

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

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

• Έναν ενεργό λογαριασμό 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
Επικεφαλίδες	Διατηρούνται για τη δομή
Κωδικοί	Συμπεριλαμβάνονται όπως είναι
Πίνακες	Μετατρέπονται σε αναγνώσιμο μορφότυπο
URLs	Το 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;"
• "Ποια είναι η διαφορά μεταξύ του API v1 και v2;"

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

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

• "Πια είναι η διαδικασία για να ζητήσω 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 = {
  // 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'
    }],
  },
};

Εξαίρεση Σελίδων από το Sitemap

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

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

---

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

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