Einrichtung aus Ihrer Website

Unter Einrichtung nennen Sie die Adresse Ihrer Website. XICBOT liest die Seiten und schlägt daraus einen Assistenten vor: Name, Rolle, Tonfall, erster Satz, Fragen mit Antworten und Themen, zu denen er schweigt. Zu den Aussagen über Ihren Betrieb nennt der Vorschlag die Seite, auf der sie steht. Nichts davon gilt, bevor Sie es mit Assistenten anlegen angenommen haben.

Wo Sie die Einrichtung finden

Die Einrichtung liegt unter app.xicbot.de/einrichtung. In der Bereichsspalte steht sie als Einrichtung in der Gruppe Arbeit, zwischen Übersicht und Assistenten. Der Hilfeverweis dieses Bereichs führt auf diese Seite.

Oben auf der Seite zeigt der Einrichtungsweg die vier Schritte Anlegen, Wissen verbinden, Probieren und Einbinden; die Einrichtung ist der Schritt Anlegen. Die Schritte sind Verweise: Anlegen führt zum Formular für einen neuen Assistenten unter Assistenten, Wissen verbinden zu Wissen. Solange es im Konto keinen Assistenten gibt, steht Einbinden ohne Verweis und mit dem Zusatz „nach Schritt 1“ da. Solange nach dem Übernehmen „Der Assistent ist angelegt.“ zu sehen ist, führen Probieren und Einbinden zum neuen Assistenten. Ein Durchgang legt beim Lesen die Wissensquelle an, das Übernehmen den Assistenten. Wie es danach weitergeht, beschreiben Probieren und abnehmen und Widget einbauen.

Wer die Einrichtung nutzen darf

Mit der Rolle Lesen steht über dem Formular: „Mit der Rolle Lesen lässt sich hier nur ansehen. Ändern kann, wer mindestens die Rolle Bearbeiten hat.“ Außerdem müssen die E-Mail-Adresse bestätigt und das Konto aktiv sein. Sonst meldet die Seite „Dieser Bereich bleibt gesperrt, bis die E-Mail-Adresse bestätigt ist.“ oder „Dieses Konto ist gesperrt. Bitte schreiben Sie an mail@xicbot.de.“ Rollen vergeben Sie unter Team und Rollen, die Bestätigung beschreibt Anmelden und Zugang.

Adresse der Website eingeben

Die Seite zeigt das Feld Adresse Ihrer Website, wenn es noch keinen Durchgang gibt oder der jüngste übernommen oder verworfen ist, nach Neuen Durchgang beginnen und nach Verwerfen. Darunter steht: „Grundlage ist ausschließlich Ihre Website. Was dort nicht steht, steht auch nicht im Vorschlag.“ Darunter wählen Sie unter Sprache des Assistenten Deutsch oder English; vorgewählt ist die Sprache der Oberfläche. Der Satz darunter lautet „In dieser Sprache entstehen Vorschlag, Begrüßung und Notfallantwort.“

1. 1

   Schritt 1

   Adresse eintragen

   Tragen Sie die volle Adresse ein, etwa https://www.example.com. Sie muss aus dem Internet erreichbar sein. Eine Adresse in einem internen Netz nimmt der Start zwar an, der Durchgang endet dann aber mit leer und dem Kurzzeichen url_not_allowed.

2. 2

   Schritt 2

   Lesen starten

   Wählen Sie Website lesen. Der Knopf ist gesperrt, solange das Feld leer ist; während des Starts zeigt er „Wird geladen …“.

3. 3

   Schritt 3

   Warten

   Die Seite zeigt zuerst „Die Website wird gelesen. Das dauert je nach Umfang einige Minuten.“ und danach „Der Vorschlag entsteht.“, darunter die Adresse. Sie fragt alle acht Sekunden nach dem Stand. Sie können die Seite verlassen: Beim nächsten Öffnen zeigt sie den Durchgang wieder an.

4. 4

   Schritt 4

   Vorschlag prüfen

   Steht der Vorschlag bereit, erscheint das Formular unter Vorschlag. Wie Sie es durchgehen, steht weiter unten.

Das Feld prüft schon vor dem Absenden: Es verlangt eine Adresse samt Schema, eine Eingabe wie example.com lässt der Browser nicht absenden, und mehr als 255 Zeichen nimmt es nicht an. Eine Adresse mit einem anderen Schema als http oder https, etwa ftp://example.com, lehnt der Server ab. Dann steht unter dem Feld „Adresse Ihrer Website ist keine gültige Adresse.“ und oben auf der Seite „Das hat nicht geklappt. Bitte prüfen Sie Ihre Eingaben.“

Was beim Lesen geschieht

Der Durchgang läuft im Hintergrund. Er legt unter Wissen eine Quelle vom Typ Website an, benannt nach dem Hostnamen der Adresse, und liest die Website in diese Quelle. Jeder Durchgang legt eine eigene, neue Quelle an, auch wenn es für dieselbe Adresse schon eine gibt. Die Quelle gehört Ihrem Konto, nicht dem Durchgang: Sie bleibt stehen, auch wenn Sie den Vorschlag nicht übernehmen. Den Suchindex der Quelle baut danach ein eigener Hintergrundauftrag auf; der Vorschlag braucht ihn nicht, er arbeitet mit dem gelesenen Text. Mehr dazu unter Wissen und Hintergrundaufträge.

• Reihenfolge: zuerst die eingegebene Adresse, dann die Adressen aus der Sitemap, zuletzt die Verweise auf den gelesenen Seiten. Eine Verweistiefe gibt es nicht: Das Lesen endet, wenn 25 Seiten mit Text beisammen sind oder keine Adresse mehr wartet.
• Sitemap: gelesen aus den Sitemap-Zeilen der robots.txt, sonst unter /sitemap.xml; höchstens 6 Sitemap-Dateien zu je 5 MB, Sitemap-Verzeichnisse werden verfolgt. Gepackte Dateien werden entpackt, wenn der Server sie als XML, als reinen Text oder ohne Inhaltstyp ausliefert. Nach der Datei, mit der 100 Adressen beisammen sind, liest der Abrufer keine weitere Sitemap.
• Dieselbe Website: gelesen wird nur unter demselben Schema, Hostnamen und Port wie die Startadresse. Leitet die eingegebene Adresse von http:// auf https:// oder auf die Fassung mit oder ohne www weiter, wird das Ziel zur Startadresse. Führt eine Weiterleitung auf eine andere Website, wird die Seite nicht gelesen.
• Gleiche Adressen: Adressen, die sich nur durch einen Schrägstrich am Ende oder durch index.html, index.htm oder index.php unterscheiden, gelten als dieselbe Seite. Der Teil hinter ? zählt mit.
• Warteschlange: neue Adressen kommen hinzu, solange weniger als 100 auf das Lesen warten.
• Je Seite: höchstens 3 MB, 20 Sekunden Wartezeit und 5 Weiterleitungen. Gelesen werden HTML und reiner Text; Verweise auf Dateien wie PDF, Bilder, Videos, Stylesheets oder Skripte werden übersprungen, ebenso mailto:-, tel:-, javascript:- und data:-Verweise. Bei Verweisen mit # zählt nur der Teil davor, /seite#abschnitt ist also /seite; ein reiner Anker wie #oben wird übersprungen. Vom Text einer Seite werden höchstens 2 000 000 Zeichen gespeichert, Seiten mit gleichem Text nur einmal.
• Zählung: zu den 25 Seiten zählen nur Seiten, auf denen Text gefunden wurde. Bleiben am Ende Verweise offen, die weder gelesen noch gesperrt sind, steht an der Quelle unter Wissen: „Nur die ersten 25 Seiten dieser Website wurden gelesen. Beim Abbruch waren noch N Verweise offen.“ N zählt diese Verweise, nicht die fehlenden Seiten.

Wie robots.txt ausgewertet wird

User-agent: XICBOT-Wissensbegeher
Disallow: /intern/
Allow: /intern/preise.html

Das Beispiel sperrt den Bereich /intern/ für den Abrufer, lässt aber die eine Seite darin zu, weil ihr Muster länger ist. Unter Wissen können Sie der Quelle später Ausgeschlossene Pfade hinzufügen; sie gelten zusätzlich zur robots.txt und vor ihr. Eine Quelle, die die Einrichtung neu anlegt, hat noch keine.

Seiten, die gelesen, aber nicht aufgenommen werden

Eine Seite wird gelesen, aber ohne Abschnitte gespeichert, wenn ein Meta-Element robots oder xicbot-wissensbegeher den Wert noindex oder none trägt, zum Beispiel <meta name="xicbot-wissensbegeher" content="noindex">. Dasselbe gilt für eine Seite, deren Veröffentlichungsdatum in der Zukunft liegt: maßgeblich ist article:published_time, sonst datePublished aus einem JSON-LD-Block. Ein Datum, das sich nicht lesen lässt, zählt als keines. Solche Seiten gehen nicht in den Vorschlag ein.

Wie der Vorschlag entsteht

Grundlage ist der Text der aufgenommenen Seiten in der Reihenfolge, in der sie gelesen wurden, zusammen höchstens 40 000 Zeichen; was darüber hinausgeht, wird abgeschnitten. Kommen weniger als 400 Zeichen zusammen, entsteht kein Vorschlag. Ein Sprachmodell schreibt daraus den Vorschlag. Es ist angewiesen, nur zu sagen, was auf den gelieferten Seiten steht, zu jeder Aussage über den Betrieb die Seite als Fundstelle zu nennen, in der gewählten Sprache zu schreiben, Deutsch mit echten Umlauten, und nichts zu versprechen: keine Preise, Fristen, Garantien, Zertifizierungen oder Spitzenstellungen. Verlangt sind ein Name aus höchstens drei Wörtern, ein erster Satz mit höchstens 140 Zeichen, fünf bis zehn Fragen, drei bis acht Lücken und höchstens 8 Themen zum Schweigen zu je höchstens 120 Zeichen. Diese Angaben sind Anweisungen an das Modell; was danach tatsächlich geprüft wird, steht im nächsten Abschnitt.

Was vor der Anzeige geprüft wird

Als Zusage gilt eine feste Liste von Wörtern und Wendungen, etwa zu Garantien, Gratisleistungen, Fristen, Zertifizierungen und Spitzenstellungen. Verglichen wird ohne Rücksicht auf Groß- und Kleinschreibung; Umlaute und ß zählen wie ihre Umschreibung, Rückerstattung und Rueckerstattung sind also dasselbe Wort. Die meisten Einträge greifen auch innerhalb längerer Wörter, etwa in kostenlose oder Zufriedenheitsgarantie. beste zählt nur am Wortende, also in bester oder allerbeste, nicht in Bestellung oder bestehen; binnen zählt nur als ganzes Wort, nicht in Binnenmarkt. Bei einem Durchgang in Englisch gilt zusätzlich eine englische Liste, etwa mit guarantee, warranty, free, cheapest, best, within, at the latest, refund, certified und market leader; free, best und within zählen dort nur als ganze Wörter. Zu entfernten Zeilen steht der Hinweis Zusage „…“ mit dem gefundenen Eintrag, gleiche Hinweise nur einmal. Die Hinweise stehen über dem Formular nach Aus dem Vorschlag entfernt und einem Doppelpunkt, getrennt durch Semikolons; ihr Wortlaut folgt der Sprache der Oberfläche. Ältere Durchgänge zeigen ihre gespeicherte Liste unverändert. Der Rohtext des Modells wird nicht ausgegeben, auch nicht über die Schnittstelle.

Vorschlag prüfen und übernehmen

Unter der Überschrift Vorschlag stehen die gelesene Adresse, die Sprache des Vorschlags als „Sprache: Deutsch“ oder „Sprache: Englisch“ und der Satz „Jede Zeile lässt sich ändern oder abwählen. Angenommen wird nur, was Sie stehen lassen.“ Der Vorschlag wird in die Felder gelegt; was Sie dort ändern, ist die Fassung, die zählt. Zu Was Ihr Betrieb macht, Wen der Assistent vertritt und jeder Frage steht die Fundstelle als Verweis auf die Seite Ihrer Website. Er öffnet in einem neuen Tab, damit Ihre Durchsicht stehen bleibt. Laden Sie die Seite neu oder kehren Sie mit Zurück zu ihr zurück, stehen Ihre Änderungen wieder in den Feldern, solange der Durchgang auf Ihre Entscheidung wartet. Enthält der geprüfte Vorschlag keine Rolle, bleibt das Feld Wen der Assistent vertritt leer, und darunter steht „Ohne belegte Fundstelle - nicht übernommen“, auch wenn das Modell gar keine Rolle vorgeschlagen hat. Was Sie selbst in das Feld schreiben, wird trotzdem übernommen.

Unter Fragen und Antworten und unter Themen, zu denen er schweigt steht „Angehakte Zeilen werden übernommen.“ Bildschirmleser nennen jedes Kästchen mit seiner Frage oder seinem Thema und dem Zusatz „(übernehmen)“, dazu ob es angehakt ist; das Antwortfeld trägt die Frage als Namen. Mit Assistenten anlegen schicken Sie Ihre Fassung ab; der Knopf ist gesperrt, solange Name des Assistenten leer ist oder mehr Themen angehakt sind, als die Tabuliste fasst. Danach meldet die Seite „Der Assistent ist angelegt.“ und bietet Assistenten öffnen und Neuen Durchgang beginnen an; darunter stehen die Lücken des Vorschlags, siehe Lücken auf Ihrer Website. Meldung und Knöpfe bleiben stehen, bis Sie unter Frühere Durchgänge einen Durchgang wählen oder Neuen Durchgang beginnen drücken. Den neuen Assistenten finden Sie dann unter Assistenten.

Lücken auf Ihrer Website

Über den Knöpfen am Ende des Formulars listet der Abschnitt Lücken auf Ihrer Website Punkte, zu denen der Assistent auf Ihrer Website nichts findet, mit dem Hinweis: „Das ist der wertvollste Teil: Zu diesen Punkten findet der Assistent auf Ihrer Website nichts. Ergänzen Sie sie auf Ihrer Website und lesen Sie die Quelle danach unter Wissen neu ein, sonst bleibt er Ihren Besuchern die Antwort schuldig.“ Darunter führt Website-Quelle unter Wissen neu einlesen zur Seite Wissen. Die Lücken werden nicht übernommen. Nach dem Übernehmen bleibt der Abschnitt als Offene Lücken aus der Einrichtung stehen, direkt nach dem Anlegen und wenn Sie den Durchgang später unter Frühere Durchgänge öffnen; solange der Assistent besteht, führt dann zusätzlich Angaben am Assistenten pflegen zu ihm. Ergänzen Sie die fehlenden Angaben auf Ihrer Website und wählen Sie danach bei der Quelle unter Wissen den Knopf Neu einlesen, siehe Wissen.

Was beim Übernehmen angelegt wird

Assistenten anlegen legt in einem Schritt einen Assistenten und seine erste Fassung an. Gilt, was Sie abgeschickt haben, nicht was im Vorschlag stand. Scheitert ein Teil, wird nichts angelegt. Der Assistent steht danach unter Assistenten und lässt sich dort wie jeder andere bearbeiten.

Im Chatfenster auf Ihrer Website antwortet der Assistent erst, wenn Sie ihn unter Assistenten auf aktiv setzen. Prüfen Sie vorher die Antworten im Probierdialog, wie unter Probieren und abnehmen beschrieben.

Zustände eines Durchgangs

Hinter dem Doppelpunkt steht der Grund. Der Server hält ihn als Kurzzeichen fest, die Seite zeigt ihn in der Sprache der Oberfläche; die Tabellen unten nennen Kurzzeichen und Anzeige. Ältere Durchgänge tragen noch einen deutschen Satz als Grund, der unverändert erscheint. Endet ein Durchgang mit leer oder fehler, beginnen Sie mit Neuen Durchgang beginnen von vorn. Verwerfen zeigt ebenfalls das leere Feld und sorgt zusätzlich dafür, dass der Durchgang beim nächsten Öffnen der Seite nicht wieder erscheint.

Meldungen und ihre Ursachen

Wenn die Website sich nicht lesen lässt

Lässt sich die Website nicht lesen, endet der Durchgang mit „Kein Vorschlag: Die Website ließ sich nicht lesen.“ und dahinter der Meldung zum Kurzzeichen aus der folgenden Tabelle; einem Kurzzeichen ohne eigene Meldung folgt „Die Aufnahme ist gescheitert.“ Dieselbe Quelle steht unter Wissen mit der zugehörigen Meldung. Bricht das Lesen mit einem unerwarteten Fehler ab, endet der Durchgang dagegen mit „Der Durchgang ist gescheitert: Die Website ließ sich nicht lesen.“ ohne weitere Meldung. Der Grund bezieht sich auf die eingegebene Adresse; eine einzelne defekte Unterseite bricht den Durchgang nicht ab.

Wenn kein Vorschlag entsteht

Meldungen beim Starten und Übernehmen

Die Tarifgrenzen greifen, sobald der Bestand die Grenze erreicht hat, nicht erst beim Überschreiten. Welche Grenzen Ihr Tarif setzt und wie sie gezählt werden, beschreibt Pakete und Kontingente.

Frühere Durchgänge

Gibt es einen Durchgang, der gerade nicht angezeigt wird, listet der Abschnitt Frühere Durchgänge die 20 neuesten, den neuesten zuerst, mit Adresse, Beginn („begonnen am …“) und Stand als Abzeichen: Liest, Schlägt vor, Wartet auf Entscheidung, Übernommen, Kein Vorschlag, Gescheitert oder Verworfen. Bildschirmleser nennen Beginn und Stand mit der Adresse; der angezeigte Durchgang ist für sie als aktuell gekennzeichnet. Ein Klick auf die Adresse öffnet den Durchgang mit seinem Stand und Vorschlag. Beim Öffnen der Seite wird nur der jüngste Durchgang angezeigt, und nur, solange er weder übernommen noch verworfen ist, auch wenn er mit leer oder fehler endete; sonst steht das leere Feld Adresse Ihrer Website da. Neuen Durchgang beginnen führt zurück zu diesem Feld; der Knopf steht bei leer, fehler und uebernommen bereit und auch unter einem Vorschlag, der auf Ihre Entscheidung wartet. Dort ist er gesperrt, solange die Übernahme läuft, und für die Rolle Lesen. Ein solcher Vorschlag bleibt erhalten und lässt sich unter Frühere Durchgänge wieder öffnen; einen neuen Start sperrt er nicht. Bei leer, fehler und unter einem Vorschlag bietet die Seite ab der Rolle Bearbeiten zusätzlich Verwerfen an. Danach steht das leere Feld mit „Der Durchgang ist verworfen. Er steht weiter unter „Frühere Durchgänge“ und lässt sich dort wieder öffnen.“, und beim Öffnen der Seite erscheint der Durchgang für niemanden im Team mehr von selbst. Gelöscht wird dabei nichts: Ein verworfener Vorschlag lässt sich unter Frühere Durchgänge öffnen und weiter übernehmen. Ein Durchgang lässt sich einzeln nicht löschen.

Was gespeichert bleibt

Zu jedem Durchgang bleiben Adresse, Sprache, Zustand, geprüfter Vorschlag, Ihre abgeschickte Fassung, Hinweis sowie Beginn, Ende und der Zeitpunkt des Verwerfens gespeichert. Löschen Sie die Wissensquelle oder den Assistenten, bleibt der Durchgang erhalten und verliert nur den Bezug. Mit dem Konto werden auch alle Durchgänge gelöscht. Der Datenexport des Inhabers enthält die Durchgänge. Einzelheiten stehen unter Aufbewahrung und Löschung und Datenschutz und Recht.

Schnittstelle

Die Seite arbeitet mit fünf Endpunkten. Sie verlangen eine angemeldete Sitzung, ein aktives Konto und eine bestätigte E-Mail-Adresse. Allgemeines zu Anmeldung und Grenzen steht unter API: Wissen und Assistenten und API-Grenzen.

Häufige Fragen