Zeni Chatbot - Οδηγίες API - XML γνωσιακής βάσης

Προδιαγραφές XML feed για έξυπνη δρομολόγηση γνώσης βάσει συλλογών.

Τα XML feeds υποστηρίζουν δυναμικό περιεχόμενο που συγχρονίζεται αυτόματα με τις βάσεις δεδομένων σου. Κάθε feed μπορεί να αντιστοιχιστεί σε μια συλλογή δεδομένων με συγκεκριμένες λέξεις-κλειδιά και μοτίβα URL για έξυπνη δρομολόγηση. Το chatbot επιλέγει αυτόματα το πιο σχετικό περιεχόμενο με βάση το εκάστοτε πλαίσιο.

Απαιτούμενη Δομή

Τοποθέτησε όλες τις εγγραφές μέσα σε <items> και χρησιμοποίησε ένα <item> ανά καταχώρηση:

<items>
    <item>
        <id>123</id>
        <title>Παράδειγμα τίτλου</title>
        <description>Μεγάλο σώμα περιεχομένου σε απλό κείμενο που χρησιμοποιείται για απαντήσεις.</description>
        <category>Προαιρετική κατηγορία</category>
        <price>Προαιρετική αριθμητική τιμή</price>
        <modified>2025-12-31 23:59:59</modified>
        <keywords>comma,separated,keywords</keywords>
        <url>https://chat.sbzsystems.com/item/123</url>
    </item>
</items>

<items>

<item>

<title>Παράδειγμα τίτλου</title>

<description>Μεγάλο σώμα περιεχομένου σε απλό κείμενο που χρησιμοποιείται για απαντήσεις.</description>

<category>Προαιρετική κατηγορία</category>

<price>Προαιρετική αριθμητική τιμή</price>

<keywords>comma,separated,keywords</keywords>

<url>https://chat.sbzsystems.com/item/123</url>

</item>

</items>

Προδιαγραφές Πεδίων

id: Μοναδικό, σταθερό αναγνωριστικό (αλφαριθμητικό ή αριθμός). Χρησιμοποιείται για παρακολούθηση ενημερώσεων και αποφυγή διπλοεγγραφών.
title: Σύντομος τίτλος που εμφανίζεται στα αποτελέσματα αναζήτησης και στις παραπομπές.
description: Κύριο σώμα περιεχομένου (μόνο απλό κείμενο, χωρίς HTML). Αυτή είναι η βασική πηγή γνώσης για τις απαντήσεις.
category: Προαιρετική ομαδοποίηση για φιλτράρισμα (π.χ. “electronics”, “support”, “billing”).
price: Προαιρετική αριθμητική τιμή για στοιχεία που σχετίζονται με προϊόντα.
modified: Χρονική σήμανση σε μορφή YYYY-MM-DD HH:MM:SS. Επιτρέπει σταδιακό συγχρονισμό με ?modified=YYYYMMDDHHMMSS.
keywords: Λέξεις-κλειδιά δρομολόγησης χωρισμένες με κόμματα που βοηθούν το σύστημα να αντιστοιχίζει ερωτήσεις στη σωστή συλλογή.
url: Δημόσιο URL που εμφανίζεται όταν γίνεται παραπομπή σε αυτή την πηγή στις συνομιλίες.

Οδηγίες Υλοποίησης

Πρωτόκολλο: Εξυπηρέτηση μέσω HTTPS με Content-Type: application/xml.
Αντιστοίχιση συλλογής: Κάθε XML feed συνδέεται με μια συλλογή δεδομένων στην καρτέλα “Knowledge XMLs” της κονσόλας διαχείρισης.
Σταδιακός συγχρονισμός: Πρόσθεσε ?modified=YYYYMMDDHHMMSS για να ληφθούν μόνο τα items που άλλαξαν μετά από τη συγκεκριμένη χρονική σήμανση.
Κωδικοποίηση: Απαιτείται UTF-8. Κάνε σωστό escaping στους ειδικούς χαρακτήρες XML και κράτησε το περιεχόμενο του description σε απλό κείμενο.
Πλήθος εγγραφών: Ενημέρωση αριθμού εγγραφών count στο <items> βοηθά στην παρακολούθηση προόδου: <items count=”123″>.
Βελτιστοποίηση δρομολόγησης: Τα items με λέξεις-κλειδιά που ταιριάζουν προτεραιοποιούνται όταν η αντίστοιχη συλλογή είναι ενεργή.

Ελάχιστο Παράδειγμα Feed

<items count="2">
    <item>
        <id>1</id>
        <title>Πολιτική αποστολής</title>
        <description>Αποστέλλουμε παγκοσμίως εντός 5 εργάσιμων ημερών.</description>
        <modified>2025-11-01 10:00:00</modified>
        <keywords>shipping,delivery,policy</keywords>
        <url>https://chat.sbzsystems.com/policies/shipping</url>
    </item>
    <item>
        <id>2</id>
        <title>Προθεσμία επιστροφών</title>
        <description>Οι επιστροφές γίνονται δεκτές εντός 30 ημερών με απόδειξη.</description>
        <modified>2025-11-01 10:05:00</modified>
        <url>https://chat.sbzsystems.com/policies/returns</url>
    </item>
</items>

<item>

<title>Πολιτική αποστολής</title>

<description>Αποστέλλουμε παγκοσμίως εντός 5 εργάσιμων ημερών.</description>

<keywords>shipping,delivery,policy</keywords>

<url>https://chat.sbzsystems.com/policies/shipping</url>

</item>

<item>

<title>Προθεσμία επιστροφών</title>

<description>Οι επιστροφές γίνονται δεκτές εντός 30 ημερών με απόδειξη.</description>

<url>https://chat.sbzsystems.com/policies/returns</url>

</item>

</items>

Εξαγωγείς από Πλατφόρμες

Στην κονσόλα διαχείρισης διατίθενται έτοιμα scripts exporter για σύνδεση με δημοφιλείς πλατφόρμες όπως WordPress, OpenCart, WHMCS αλλά και custom βάσεις δεδομένων. Αυτά δημιουργούν σωστά μορφοποιημένα XML feeds που συγχρονίζονται αυτόματα με το υπάρχον περιεχόμενό σου. Κάθε exporter μπορεί να ρυθμιστεί ώστε να στοχεύει συγκεκριμένες συλλογές δεδομένων για οργανωμένη ανάπτυξη σε πολλαπλά sites.