Wissen pflegen
Quellen anlegen, Websites auffrischen, Fassungen zurückholen, Frage-Antwort-Paare und Prüfsatz pflegen: jedes Feld im Bereich Wissen mit Grenzen und Meldungen.
In einfacher Sprache
Unter Wissen legen Sie fest, woraus Ihre Assistenten antworten. Das können Texte, Dateien, Websites oder Fragen mit Antworten sein. Diese Seite beschreibt jedes Feld in diesem Bereich. Sie nennt die Grenzen und die Meldungen. Sie sagt auch, was beim Speichern, Neu einlesen und Löschen geschieht. Sie können alte Fassungen einer Quelle zurückholen. Wie aus Quellen Antworten werden, steht auf einer eigenen Seite.
Alle Themen der Dokumentation
Unter Wissen legen Sie fest, woraus Ihre Assistenten antworten: eingefügte Texte, hochgeladene Dateien, Websites und gepflegte Frage-Antwort-Paare. Diese Seite beschreibt jedes Feld des Bereichs mit Grenzen, Vorgaben und Meldungen und sagt, was Speichern, Neu einlesen, Zurückholen und Löschen bewirken. Wie aus Quellen Abschnitte und aus Abschnitten belegte Antworten werden, erklärt Wissensaufbau und Antworten.
Wo Sie den Bereich finden
Sie finden den Bereich im Menü unter Arbeit › Wissen (app.xicbot.de/wissen). Im Einrichtungsweg eines Assistenten führt der Schritt Wissen verbinden zwischen Anlegen und Probieren hierher. Die Seite beginnt mit dem Satz Hinterlegen Sie Texte, Dateien oder eine Website. Der Assistent antwortet nur aus diesen Quellen und nennt zu jeder Aussage die Stelle.
- Neue Quelle und Antwort prüfen stehen oben nebeneinander: links legen Sie eine Quelle an, rechts stellen Sie dem Bestand eine Frage.
- Darunter folgen Frage-Antwort-Paare, Prüfsatz mit Gewichtung, Fragen mit Notfallantwort und zuletzt die Liste Ihre Quellen.
- In der Randspalte steht Ihre Quellen als Sprungliste: je Quelle die Bezeichnung und darunter die Adresse, bei Dateien der Dateiname, sonst die Art. Das Feld In der Liste suchen filtert nach Bezeichnung und Adresse beziehungsweise Dateiname; passt nichts, erscheint Kein Eintrag passt zu diesem Suchwort. Ein Klick öffnet die Quelle in der Liste.
Arten von Quellen
Das Feld Art der Quelle bietet vier Arten. Die Hilfe darunter lautet Text fügen Sie direkt ein, eine Datei laden Sie hoch, eine Website wird ab der Startadresse abgerufen. Bei „Fragen und Antworten“ pflegen Sie die Paare unten einzeln; diese Sammlung gibt es je Konto einmal. Die Art steht mit dem Anlegen fest und lässt sich später nicht mehr ändern. Besteht die Sammlung Fragen und Antworten schon, ist diese Art im Feld gesperrt, und darunter steht, in welche Sammlung neue Paare gehen, mit einem Verweis auf Frage-Antwort-Paare.
| Art | So kommt der Inhalt hinein | Nach dem Anlegen |
|---|---|---|
| Text | Sie fügen den Text in Inhalt ein. | Wird noch in der Anfrage gelesen und in Abschnitte zerlegt. Die Quelle steht danach auf aufgenommen oder nicht aufgenommen. |
| Datei | Sie laden eine Datei hoch. Welche Formate gelesen werden, steht unter Dateiformate. | Wie beim Text: sofort gelesen und zerlegt. |
| Website | Der Dienst ruft die Seiten ab der Startadresse selbst ab, bis zu 25 Seiten je Lauf. | Läuft im Hintergrund: erst neu, dann wird aufgenommen, am Ende aufgenommen oder nicht aufgenommen. |
| Fragen und Antworten | Beim Anlegen gibt es keinen Inhalt. Die Paare pflegen Sie im Abschnitt Frage-Antwort-Paare. Eine Sammlung je Konto; eine zweite lässt sich nicht anlegen. | Steht sofort auf aufgenommen. |
Ein Text oder eine Datei hat keinen Ursprung, den der Dienst später noch einmal lesen könnte. Um einen solchen Inhalt zu erneuern, legen Sie eine neue Quelle an und löschen danach die alte.
Quelle anlegen
| Feld | Pflicht | Grenzen und Verhalten |
|---|---|---|
| Art der Quelle | ja | Text, Datei, Website oder Fragen und Antworten. Vorgabe ist Text; je nach Art erscheinen darunter andere Felder. |
| Bezeichnung | ja | Höchstens 200 Zeichen. Hilfe unter dem Feld: Unter dieser Bezeichnung steht die Quelle in der Liste. Höchstens 200 Zeichen. |
| Inhalt | bei Text | Höchstens 1.000.000 Zeichen. |
| Datei auswählen | bei Datei | Knopf Datei wählen, daneben der Dateiname oder Keine Datei gewählt. Höchstens 10 MB. Hinweis unter dem Feld: Text, Markdown, CSV, HTML, JSON, PDF oder Word (.docx, .doc), höchstens 10 MB. |
| Startadresse | bei Website | Vollständige Adresse mit http:// oder https://, höchstens 500 Zeichen; im leeren Feld steht https://. Die Adresse muss ins offene Internet zeigen. |
| Weitere Einstellungen | nein | Aufklappbar bei Text, Datei und Website: Abschnittsgröße und Überlappung, bei Website zusätzlich Ausgeschlossene Pfade und Auffrischung in Tagen, mit denselben Grenzen wie unter Quelle bearbeiten. Darin steht Leer gelassen gilt die Vorgabe. Abschnittsgröße und Überlappung einer Text- oder Dateiquelle legen Sie nur hier beim Aufnehmen fest. Ausgeschlossene Pfade gelten so schon für den ersten Lauf. |
Quelle aufnehmen schickt das Formular ab; solange der Dienst arbeitet, steht auf dem Knopf Wird aufgenommen …. Danach sind die Felder leer, und die neue Quelle steht oben in Ihre Quellen. Lehnt der Dienst die Eingabe ab, erscheint Das hat nicht geklappt. Bitte prüfen Sie Ihre Eingaben. und unter dem betroffenen Feld ein Satz aus Feldname und Regel, etwa Bezeichnung ist zu lang., Datei ist zu groß (höchstens 10 MB). oder Startadresse ist keine gültige Adresse. Weist der Dienst die Startadresse selbst ab, weil sie ein anderes Schema als http oder https hat, nicht ins offene Internet zeigt, ihr Name sich nicht auflösen lässt oder sie sich nicht lesen lässt, steht der Grund am Adressfeld, etwa Nur Adressen mit http:// oder https:// lassen sich abrufen., Dieses Ziel darf nicht abgerufen werden, etwa eine interne Adresse. oder Der Name dieser Adresse lässt sich nicht auflösen. Bitte prüfen Sie die Schreibweise. Als Meldung erscheint dann Bitte prüfen Sie die markierten Felder. Fehlt bei der Art Datei die Datei, steht am Feld Datei ist ein Pflichtfeld. und als Meldung Bitte prüfen Sie die markierten Felder. Lehnt der Dienst eine der Weiteren Einstellungen ab, klappt der Bereich auf, und der Satz steht am Feld.
Dateiformate
Wie eine Datei gelesen wird, entscheidet ihre Endung. Eine Liste erlaubter Endungen gibt es nicht: was keine der folgenden Endungen trägt, wird als Text gelesen. Steht in den ersten 8 KB einer Datei ein Nullbyte, etwa bei einem Bild oder einem Archiv, scheitert die Aufnahme, und an der Quelle steht Diese Datei enthält keinen lesbaren Text, etwa ein Bild oder ein Archiv. Laden Sie Text, Markdown, CSV, HTML, JSON, PDF oder Word hoch. Für pdf, docx, docm, doc und dot gilt diese Prüfung nicht; Text in UTF-16 mit Byte-Order-Mark gilt als Text. Außer bei HTML ist der Dateiname der Titel des Dokuments.
| Endung | Was gelesen wird |
|---|---|
html, htm, xhtml | Der sichtbare Text. Kopfbereich, Skripte, Stile, Navigation, Kopf- und Fußleiste sowie Randspalten (nav, header, footer, aside) fallen weg. Der Titel kommt aus title, fehlt er, aus dem Dateinamen. |
json | Die Werte samt ihren Schlüsseln, ein Eintrag je Zeile. Eine Datei, die kein gültiges JSON ist, ergibt keinen Text. |
pdf | Nur die Textebene. Ein PDF, das nur aus Bildern besteht, etwa ein Scan, ergibt keinen Text. |
docx, docm | Der Text des Word-Dokuments. |
doc, dot | Der Text im älteren Word-Format. |
alle anderen, etwa txt, md, csv | Der Inhalt als Text, der Zeichensatz wird vereinheitlicht. |
Die Liste Ihre Quellen
Die Liste zeigt bis zu 200 Quellen, die neueste zuerst. Jede Zeile nennt Bezeichnung, Art und Zustand, dazu Dokumente und Abschnitte, bei einer Sammlung von Paaren deren Zahl unter Frage-Antwort-Paare. Bei Websites folgen Auffrischung in Tagen, ohne eigene Angabe als Frist des Hauses (7 Tage), und die Adresse; bei Dateien steht der Dateiname dort. Ohne Quelle steht Noch keine Quelle hinterlegt. mit dem Satz Ohne Quelle bleibt die Antwort des Assistenten leer. Fügen Sie oben einen Text, eine Datei oder eine Website hinzu. Scheitert das Laden, erscheint Die Liste konnte nicht geladen werden. mit dem Knopf Erneut laden.
| Zustand | Bedeutung |
|---|---|
| neu | Angelegt, der Hintergrundlauf hat noch nicht begonnen. |
| wird aufgenommen | Die Quelle wird gerade im Hintergrund gelesen und zerlegt. |
| aufgenommen | Der letzte Aufbau ist fertig, die Quelle antwortet. |
| nicht aufgenommen | Der letzte Lauf ist gescheitert. Der Grund steht an der Quelle, siehe unten. |
| nicht mehr aktuell | Eine Website, die zu lange nicht bestätigt wurde. Diesen Zustand setzt der Auffrischlauf im Hintergrund; ihr bisheriger Inhalt antwortet weiter. |
Bei Websites zeigt eine weitere Zeile die Frische: Aktuell oder Veraltet, jeweils mit Zuletzt bestätigt und Datum, oder Noch nie bestätigt. Bestätigt ist eine Website, wenn ein Lauf sie erfolgreich gelesen hat. Veraltet gilt, sobald seit der letzten Bestätigung das Doppelte der Auffrischfrist vergangen ist, mindestens aber 14 Tage.
Hat ein Lauf eine Website nicht ganz gelesen, steht an der Quelle Nur die ersten 25 Seiten dieser Website wurden gelesen. oder, wenn keine Seitengrenze bekannt ist, Diese Website wurde nicht vollständig gelesen. Dahinter folgt die Zahl der offenen Verweise, etwa Beim Abbruch waren noch 12 Verweise offen., oder Wie viele Verweise dabei offen blieben, wurde nicht gemessen.
Wenn eine Aufnahme scheitert
Eine gescheiterte Quelle steht auf nicht aufgenommen; darunter stehen der Grund und Fehlgeschlagen am mit Datum und Uhrzeit. Ihr bisheriger Inhalt bleibt stehen und antwortet weiter, ein gescheiterter Lauf löscht nichts. Eine Website gilt erst als gescheitert, wenn keine Seite Text geliefert hat; als Grund steht dann der, an dem die Startadresse gescheitert ist.
| Meldung | Kennung | Ursache |
|---|---|---|
| Aus dieser Quelle ließ sich kein Text gewinnen. | no_text_extracted | Der Lauf hat keinen einzigen Abschnitt ergeben, etwa bei einer leeren Datei. |
| Diese Quelle enthält nur Entwürfe oder Inhalte mit einem Datum in der Zukunft. | unpublished_only | Alles Gelesene gilt als unveröffentlicht. |
| Unter dieser Adresse war kein Text zu finden. | website_without_text | Keine Seite hat Text geliefert, und für die Startadresse ist kein genauerer Grund bekannt. |
| Diese Adresse ist unbrauchbar. | url_unusable | Die Startadresse hat kein http oder https oder keinen Namen. |
| PDF kann auf diesem Server nicht gelesen werden. | pdf_tool_missing | Der Dienst kann PDF gerade nicht lesen. |
| Dieses PDF enthält nur Bilder, keinen Text – vermutlich ein Scan. … | pdf_without_text_layer | Das PDF hat keine Textebene. |
| Diese Adresse darf nicht abgerufen werden. | url_not_allowed | Die Startadresse zeigt nicht ins offene Internet, oder ihr Name lässt sich beim Lauf nicht auflösen. |
| Die Weiterleitung dieser Adresse führt an ein unzulässiges Ziel. | redirect_not_allowed | Eine Weiterleitung zeigt auf ein Ziel außerhalb des offenen Internets, auf einen Namen, der sich nicht auflösen lässt, oder auf ein anderes Schema als http und https. |
| Diese Adresse leitet im Kreis weiter. | redirect_loop | Mehr als fünf Weiterleitungen hintereinander. |
| Die Weiterleitung führt auf eine andere Website. | redirect_off_origin | Das Ziel einer Weiterleitung liegt nicht unter Schema, Name und Port der Startadresse. Leitet schon die Startadresse auf dieselbe Website weiter, also auf denselben Namen mit oder ohne vorangestelltes www, mit demselben Schema oder von http auf https, gilt dieses Ziel als Startadresse; eine Weiterleitung auf einen anderen Namen, einen anderen Port oder von https zurück auf http bleibt ausgeschlossen. |
| Diese Adresse war nicht erreichbar. | url_unreachable | Keine Verbindung oder keine Antwort innerhalb von 20 Sekunden. |
| Der Server hat die Adresse mit einem Fehler beantwortet. | website_status_error | Die Seite antwortete mit einem Fehlerstatus. |
| Unter dieser Adresse liegt kein Text, sondern ein anderes Format. | website_wrong_type | Die Antwort ist weder HTML noch reiner Text. |
| Diese Adresse ist zu groß, um sie aufzunehmen. | website_too_large | Die Seite ist größer als 3 MB. |
| Diese Datei enthält keinen lesbaren Text, etwa ein Bild oder ein Archiv. Laden Sie Text, Markdown, CSV, HTML, JSON, PDF oder Word hoch. | file_format_unsupported | In den ersten 8 KB der Datei steht ein Nullbyte. Für PDF- und Word-Dateien gilt diese Prüfung nicht. |
| Diese Word-Datei ließ sich nicht öffnen. Speichern Sie sie noch einmal als .docx oder laden Sie sie als PDF hoch. | docx_unreadable | Eine Datei mit der Endung docx oder docm ist keine gültige Word-Datei oder lässt sich nicht öffnen. |
| Diese Datei ließ sich nicht als Word-Datei im älteren Format (.doc) lesen. Speichern Sie sie als .docx oder PDF und laden Sie sie erneut hoch. | doc_unreadable | Eine Datei mit der Endung doc oder dot ist keine Word-Datei im älteren Format. Eine umbenannte docx-Datei wird als solche gelesen. |
| Diese Word-Datei im älteren Format (.doc) lässt sich auf diesem Server nicht lesen. Speichern Sie sie als .docx oder PDF und laden Sie sie erneut hoch. | doc_format_unsupported | Das ältere Word-Format kann der Dienst gerade nicht lesen, oder das Lesen ergab keinen Text. |
| Word-Dateien (.docx) können auf diesem Server derzeit nicht gelesen werden. Laden Sie den Inhalt als PDF oder Textdatei hoch. | zip_reader_missing | Der Dienst kann docx und docm gerade nicht lesen. |
| Die robots.txt der Website war wegen eines Serverfehlers nicht erreichbar. Bis sie wieder antwortet, liest der Dienst keine Seite dieser Website. | robots_unreachable | Die robots.txt antwortete mit Status 500 oder höher. Der bisherige Inhalt bleibt stehen. |
| Die Aufnahme ist gescheitert. | ingest_failed | Jeder andere Grund. |
Quelle bearbeiten
Bearbeiten an einer Quelle klappt ihr Formular in der Liste auf, Schließen klappt es wieder zu. Speichern übernimmt die Angaben, meldet Gespeichert. und liest die Quelle dabei nicht neu. Lässt sich der Eintrag ins Protokoll nicht schreiben, bleibt die Änderung aus, und die Seite meldet Nicht gespeichert: Der Eintrag ins Protokoll kam nicht zustande. Bitte versuchen Sie es erneut.
| Feld | Pflicht | Grenzen und Verhalten |
|---|---|---|
| Bezeichnung | ja | Höchstens 200 Zeichen. |
| Auffrischung in Tagen | nein | Nur bei Websites, 1 bis 365 Tage. Leer heißt Frist des Hauses (7 Tage). Darunter steht Leer lassen: es gilt die Frist des Hauses. Nur für Websitequellen - Text und hochgeladene Dateien haben keinen Ursprung, der sich ändern könnte. Bei anderen Arten steht statt des Felds Eine Auffrischfrist gibt es nur für Websitequellen. |
| Abschnittsgröße | nein | Nur bei Websites änderbar, 200 bis 4000 Zeichen. Leer heißt Vorgabe: 800 Zeichen, bei Dateien 1400; Platzhalter und Hinweis unter den Feldern nennen die Vorgabe der jeweiligen Art. Bei Text- und Dateiquellen sind beide Felder gesperrt, darunter steht Die Abschnittsgröße einer Text- oder Dateiquelle wird beim Aufnehmen festgelegt und lässt sich danach nicht mehr ändern. Festgelegt wird sie beim Anlegen unter Weitere Einstellungen. Bei Fragen und Antworten fehlen beide Felder. |
| Überlappung | nein | Nur bei Websites änderbar, 0 bis 4000 Zeichen. Leer heißt Vorgabe: 120 Zeichen, bei Dateien 200. Wirksam ist höchstens die Hälfte der Abschnittsgröße. |
| Ausgeschlossene Pfade | nein | Nur bei Websites. Höchstens 50 Muster mit je 300 Zeichen, Regeln siehe unten. Bei anderen Arten steht Ausgeschlossene Pfade gibt es nur für Websitequellen. |
Ausgeschlossene Pfade
Der Hinweis am Feld lautet Ein Muster je Zeile, * als Platzhalter, höchstens 50 Muster mit je 300 Zeichen. Gilt zusätzlich zur robots.txt der Quelle. Die Muster stehen über der robots.txt: was ein Muster ausschließt, liest der Dienst auch dann nicht, wenn die robots.txt es erlaubt. Geänderte Muster wirken ab dem nächsten Lauf; beim Anlegen unter Weitere Einstellungen eingetragene gelten schon für den ersten.
- Ein Muster greift am Anfang des Pfads, also ab dem ersten
/nach dem Namen, einschließlich der Abfrage hinter?. Ein Muster, das weder mit/noch mit*beginnt und kein://enthält, trifft deshalb nichts. *steht für beliebig viele Zeichen, ein$am Ende bindet das Muster an das Ende der Adresse.- Enthält ein Muster
://, wird es mit der vollständigen Adresse verglichen. - Beispiele:
/intern/schließt alles unter diesem Verzeichnis aus,*.pdf$jede Adresse, die auf.pdfendet,/suche?jede Suchseite mit Abfrage.
Wie eine Website gelesen wird
Ein Lauf beginnt an der Startadresse, nimmt die Adressen aus der Sitemap der Website hinzu, dann die bereits aufgenommenen Adressen dieser Quelle, und folgt zuletzt den Verweisen auf Seiten derselben Website. Der Lauf endet, wenn keine Adresse mehr offen ist oder 25 Seiten Text geliefert haben; eine Seite, die der Server als unverändert meldet, zählt mit. Verweise werden nur vorgemerkt, solange weniger als 100 Adressen auf ihren Abruf warten; weitere bleiben liegen.
- Aufgenommen werden nur HTML und reiner Text (
text/plain). - Jede Seite hat 20 Sekunden Zeit zu antworten. Bis zu fünf Weiterleitungen werden verfolgt, und nur innerhalb derselben Website.
- Eine Seite darf höchstens 3 MB groß sein. Jedes Dokument, auch aus Text und Dateien, wird nach 2.000.000 Zeichen abgeschnitten.
- Die robots.txt wird beachtet. Ein eigener Abschnitt, dessen Name den Anfang von
XICBOT-Wissensbegeherbildet, etwaXICBOT, gilt statt des allgemeinen Abschnitts für*; passen mehrere, gilt der längste Name. Groß- und Kleinschreibung spielt dabei keine Rolle. Widersprechen sich Regeln, gewinnt die längste, bei gleicher Länge die erlaubende. Antwortet die robots.txt mit einem Serverfehler (Status 500 oder höher), endet der Lauf mit Die robots.txt der Website war wegen eines Serverfehlers nicht erreichbar. Bis sie wieder antwortet, liest der Dienst keine Seite dieser Website., und der bisherige Inhalt bleibt stehen. Kommt gar keine Verbindung zustande, endet er mit Diese Adresse war nicht erreichbar. Antwortet der Server auf die robots.txt mit Status 4xx, etwa weil sie fehlt, gelten keine Regeln. - Seiten mit
noindexodernoneim Robots-Metatag oder in einem Metatag mit dem NamenXICBOT-Wissensbegeherund Seiten mit einem Veröffentlichungsdatum in der Zukunft (article:published_time,datePublished) gelten als unveröffentlicht: Sie werden nicht in Abschnitte zerlegt und fließen in keine Antwort ein. Eine Seite mit künftigem Datum kommt frühestens mit dem ersten Lauf nach diesem Datum hinzu. - Seiten mit gleichem Text werden nur einmal aufgenommen. Eine Seite ohne Titel und eine reine Textseite tragen ihre Adresse als Titel.
Auffrischen und neu einlesen
Websitequellen, deren Frist abgelaufen ist, reiht ein Zeitplan im Hintergrund zum Auffrischen ein: fällig ist eine Quelle, wenn seit ihrer letzten Bestätigung mehr Tage vergangen sind, als Auffrischung in Tagen angibt, ohne eigene Angabe gilt die Frist des Hauses (7 Tage). Mitgenommen werden auch gescheiterte und veraltete Quellen. Eine Quelle, für die schon ein Auftrag offen ist, wird übersprungen. Die Zeitpläne des Dienstes beschreibt Zeitpläne.
Beim Auffrischen wird eine Seite nur neu zerlegt, wenn sie sich geändert hat: meldet der Server sie als unverändert oder ist ihr Text gleich geblieben, bleiben ihre Abschnitte stehen. Ein Lauf, der nichts geändert hat, legt keine neue Fassung an. Seiten, die der Lauf nicht mehr findet, fallen heraus; ein Lauf, der gar nichts findet, löscht nichts.
Neu einlesen im aufgeklappten Formular einer Website reiht sofort einen Lauf ein. Die Quelle steht dann auf wird aufgenommen, und im Formular erscheint Die Quelle wird im Hintergrund aufgenommen. Der Zustand aktualisiert sich von selbst. Mit angehaktem Vollständig neu aufbauen zerlegt der Lauf auch unveränderte Seiten neu, das braucht es nach einer Änderung der Abschnittsgröße. Ist für die Quelle schon ein Einlese- oder Auffrischungsauftrag offen, übernimmt Neu einlesen diesen Auftrag. Ist Vollständig neu aufbauen angehakt, nimmt ein noch wartender Auftrag den Neuaufbau mit; läuft er schon ohne Neuaufbau, lehnt der Dienst ab, und im Formular erscheint Für diese Quelle läuft oder wartet ein Aufbau. Bitte danach erneut versuchen. Solange die Quelle auf wird aufgenommen steht, ist der Knopf gesperrt. Endet der offene Auftrag genau in diesem Moment, reiht Neu einlesen stattdessen einen neuen Lauf mit Neuaufbau ein.
Trifft eine Frage unter Antwort prüfen auf eine veraltete Websitequelle, reiht der Dienst für sie ebenfalls ein Auffrischen ein. Die Antwort selbst kommt noch aus dem bisherigen Stand.
Merkmalsstreuung
Über der Liste steht der Stand der Merkmalsstreuung, etwa Merkmalsstreuung: 180/200 Abschnitte · 20 offen. Die erste Zahl nennt die Abschnitte, die schon im inhaltlichen Teil der Suche stehen. Streuung aufbauen reiht dafür einen Auftrag über den ganzen Bestand ein; während die Anfrage läuft, steht auf dem Knopf wird aufgebaut. Ist schon ein solcher Auftrag offen, wird dieser verwendet.
Fassungen zurückholen
Im aufgeklappten Formular einer Quelle stehen unter Fassungen ihre Aufbaustände. Die Erklärung dazu lautet Jeder Aufbau schreibt eine neue Fassung. Die vorige antwortet vollständig weiter, bis die neue fertig ist. und Vorgehalten werden die letzten 5 Fassungen. Jede Fassung steht mit Nummer, Inhalt und Zeitpunkt da, etwa Fassung 3 mit 12 Dokumente, 140 Abschnitte; die geltende trägt antwortet. Gibt es noch keine, steht Für diese Quelle wurde noch keine Fassung aufgebaut.
Zurückholen an einer älteren Fassung fragt Neuere Fassungen werden dabei verworfen. Zurückholen? mit den Knöpfen Zurückholen und Beenden. Nach der Bestätigung antwortet wieder diese Fassung, die neueren sind gelöscht, und die Seite meldet etwa Fassung 3 antwortet wieder. Verworfen: 2. Eine angezeigte Antwort unter Antwort prüfen wird dabei geleert, weil ihre Belegstellen zu einer verworfenen Fassung gehören können.
| Meldung | Wann |
|---|---|
| Für diese Quelle läuft oder wartet ein Aufbau. Bitte danach erneut versuchen. | Solange für die Quelle eine Aufnahme oder Auffrischung wartet oder läuft, lässt sich keine Fassung zurückholen. |
| Diese Fassung wird nicht mehr vorgehalten. | Die Fassung ist inzwischen aufgeräumt. |
| Diese Fassung antwortet bereits. | Die gewählte Fassung ist schon die geltende. |
| Nicht gespeichert: Der Eintrag ins Protokoll kam nicht zustande. Bitte versuchen Sie es erneut. | Der Eintrag ins Protokoll ließ sich nicht schreiben; alle Fassungen bleiben, wie sie waren. |
Dokumente einer Quelle
Unter den Fassungen steht im aufgeklappten Formular die Liste Dokumente: die Seiten und Dateien der Quelle nach Titel, je mit Adresse, Zeichenzahl und Stand. Darüber steht Die Seiten und Dateien dieser Quelle, nach Titel. Entwürfe und Dokumente mit künftigem Datum stehen hier, fließen aber nicht in Antworten ein. So sehen Sie bei einer Website, welche Seiten aufgenommen sind und wo sich ein ausgeschlossener Pfad lohnt. Die Liste sieht jede Rolle.
| Stand | Bedeutung |
|---|---|
| veröffentlicht | Das Dokument fließt in Antworten ein. |
| Entwurf – fließt nicht in Antworten ein | Das Dokument ist als Entwurf gekennzeichnet. |
| erscheint am … – fließt bis dahin nicht in Antworten ein | Das Dokument trägt ein Datum in der Zukunft. |
- Die Adresse einer Seite ist ein Verweis, der in einem neuen Fenster öffnet. Text- und Dateiquellen haben keine Adresse.
- Gezeigt werden höchstens 200 Dokumente. Hat die Quelle mehr, steht darüber Gezeigt werden die ersten 200 von … Dokumenten.
- Ohne Dokument steht Diese Quelle hat noch kein Dokument. Scheitert das Laden, erscheint Die Liste konnte nicht geladen werden. mit Erneut laden.
- Nach Zurückholen einer Fassung und wenn ein Lauf der Quelle endet, lädt die Liste neu.
Quelle löschen
Löschen an einer Quelle fragt Diese Quelle und alle ihre Abschnitte löschen? mit Löschen und Abbrechen. Nach der Bestätigung meldet die Seite Die Quelle ist gelöscht., und eine angezeigte Antwort unter Antwort prüfen wird geleert.
- Mit der Quelle fallen ihre Dokumente und Abschnitte weg, alle ihre Fassungen, die Frage-Antwort-Paare, die zu ihr gehören, und die Prüfzeilen, die auf eines ihrer Dokumente zeigen.
- Das Löschen wird im Protokoll vermerkt, in einem Zug mit dem Löschen selbst. Lässt sich der Vermerk nicht schreiben, bleibt die Quelle erhalten, und es erscheint Nicht gespeichert: Der Eintrag ins Protokoll kam nicht zustande. Bitte versuchen Sie es erneut.
- Eine eigene Aufbewahrungsfrist je Quelle gibt es nicht. Was sonst wie lange aufbewahrt wird, beschreibt Aufbewahrung und Löschung.
Frage-Antwort-Paare
Ein Paar ist eine fertige Antwort auf eine bestimmte Frage. Über dem Formular steht Passt eine Besucherfrage auf ein Paar oder eine seiner Varianten, wird die gepflegte Antwort wörtlich ausgegeben – ohne Modellaufruf.
| Feld | Pflicht | Grenzen und Verhalten |
|---|---|---|
| Frage | ja | Höchstens 500 Zeichen. Ist das Feld leer, legt Paar anlegen nichts an. |
| Varianten, eine je Zeile | nein | Andere Formulierungen derselben Frage. Unter dem Feld steht Höchstens 20 Varianten mit je 500 Zeichen. Doppelte Zeilen fallen weg. Mehr oder längere meldet das Feld, bevor etwas gespeichert wird. Am Paar stehen sie im selben Feld und lassen sich dort ändern. |
| Antwort | nein | Höchstens 5000 Zeichen. Ist sie leer, steht am Paar Ohne Antwort bleibt das Paar inaktiv. |
| Aktiv | nein | Nur aktive Paare mit Antwort werden verwendet. Ohne Antwort ist das Häkchen gesperrt; ein neues Paar mit Antwort ist sofort aktiv. |
- Paar anlegen legt das Paar in der ältesten Quelle der Art Fragen und Antworten ab. Gibt es keine, entsteht eine neue Sammlung. Eine zweite lässt sich nicht anlegen; Konten, die aus früherer Zeit mehrere haben, behalten sie, und neue Paare gehen in die älteste. Ihre Bezeichnung richtet sich nach der Sprache Ihrer Anmeldung, nicht nach der gerade gewählten Sprache der Oberfläche: bei Englisch Questions and answers, sonst Fragen und Antworten. Eine schon vorhandene Sammlung behält ihre Bezeichnung; ändern lässt sie sich über Bearbeiten unter Bezeichnung. Die neue Sammlung zählt gegen die Grenze Ihres Tarifs für Quellen: Ist sie erreicht, entsteht kein Paar, und die Seite meldet etwa Die Grenze des Tarifs … ist erreicht: … von …. Die Übersicht steht unter Abrechnung. Die Sammlung entsteht nur zusammen mit ihrem Eintrag Wissensquelle angelegt im Protokoll.
- An einem bestehenden Paar ändern Sie Frage, Antwort, Varianten, eine je Zeile und Aktiv und übernehmen sie mit Speichern; eine eigene Meldung gibt es dafür nicht.
- Löschen fragt Dieses Frage-Antwort-Paar löschen? mit Löschen und Abbrechen. Ohne Paar steht dort Noch keine Paare angelegt.
- Anlegen, Speichern und Löschen eines Paars gelten nur zusammen mit ihrem Eintrag ins Protokoll. Lässt sich der Eintrag nicht schreiben, entsteht kein neues Paar, ein bestehendes bleibt, wie es war, und die Seite meldet Nicht gespeichert: Der Eintrag ins Protokoll kam nicht zustande. Bitte versuchen Sie es erneut.
- Verglichen werden die ersten 300 aktiven Paare mit Antwort in der Reihenfolge der Liste, zuerst über die Wörter, danach über die Merkmalsstreuung. Gibt es mehr aktive Paare mit Antwort, warnt der Abschnitt: Beim Beantworten werden nur die ersten 300 aktiven Paare mit Antwort in der Reihenfolge der Liste verglichen. Die übrigen … greifen nicht. Passt ein Paar, ist seine Antwort wörtlich die Antwort, und unter Antwort prüfen steht dazu Diese Antwort stammt aus einem gepflegten Paar.
Antwort prüfen
Hier stellen Sie dem Bestand eine Frage, wie ein Besucher sie stellen würde. Der Hinweis lautet Stellen Sie eine Frage. Ohne Beleg aus einer Quelle gibt es keine Antwort. Das Feld Ihre Frage ist Pflicht und nimmt höchstens 2000 Zeichen. Frage stellen schickt sie ab, währenddessen steht dort Wird beantwortet …. Geantwortet wird in der Sprache der Frage, auf Deutsch oder Englisch; lässt sich die Frage nicht sicher zuordnen oder steht sie in einer anderen Sprache, gilt die Sprache der Oberfläche.
Das Ergebnis steht unter Antwort oder, wenn die Quellen nichts hergeben, unter Keine Antwort aus den Quellen. Darunter folgen die Belegstellen; weitere blendet weitere anzeigen ein. Bleibt die Antwort aus, steht dort einer dieser Sätze:
| Satz | Wann |
|---|---|
| Bitte stellen Sie eine Frage. | Die Frage ist leer. |
| Dazu steht nichts in der hinterlegten Wissensbasis. | Die Suche findet nichts, die Treffer decken die Frage nicht, oder es ließe sich keine belegte Antwort bilden. |
| Die Antwort ist gerade nicht möglich. Bitte versuchen Sie es später erneut. | Der Dienst kann im Moment keine Antwort erzeugen. |
Antwort prüfen steht jeder Rolle offen und legt nichts an. Den ganzen Assistenten mit Rolle, Ton und Übergaberegel probieren Sie im Probierdialog aus, siehe Probieren und abnehmen.
Prüfsatz
Die Seite beschreibt ihn so: Der Prüfsatz misst, ob die Suche das richtige Dokument findet. Jede Zeile nennt eine Frage und das Dokument, das sie treffen soll; gemessen wird der Platz unter den ersten 10 Treffern. Der Lauf fragt kein Modell, sondern nur die eigene Suche.
| Feld | Pflicht | Grenzen und Verhalten |
|---|---|---|
| Frage | ja | Höchstens 500 Zeichen. |
| Erwartetes Dokument | ja | Auswahl aus den veröffentlichten Dokumenten, bis zu 500. Gibt es keines, steht Es gibt noch kein veröffentlichtes Dokument, auf das eine Prüfzeile zeigen könnte. |
- Prüfzeile anlegen fügt die Zeile hinzu. Der Prüfsatz fasst höchstens 100 Zeilen; ist er voll, ist der Knopf gesperrt, und eine Anlage über die Schnittstelle scheitert mit Der Prüfsatz ist voll. Löschen Sie eine Zeile, bevor Sie eine neue anlegen.
- Jede Zeile zeigt Erwartet mit dem Dokument und dahinter Platz 3, nicht gefunden oder vor der ersten Messung nie gemessen.
- Messen sucht jede Frage einmal, währenddessen steht auf dem Knopf Wird gemessen …. Oben stehen danach Trefferqualität, der Mittelwert aus 1 geteilt durch den Platz über alle Zeilen, wobei eine nicht gefundene Zeile 0 zählt, und Gefunden als gefundene von allen Zeilen, etwa 8 / 10. Vor der ersten Messung steht dort Nicht gemessen.
- Zusätzlich misst ein Zeitplan im Hintergrund den Prüfsatz von selbst, jeweils nach dem Auffrischlauf, der die fälligen Websitequellen zum Einlesen vormerkt. Ohne Prüfzeilen misst er nichts.
- Löschen an einer Zeile fragt Diese Prüfzeile löschen?. Ohne Zeilen steht Noch keine Prüfzeile angelegt.
- Anlegen und Löschen einer Prüfzeile gelten nur zusammen mit ihrem Eintrag ins Protokoll. Lässt sich der Eintrag nicht schreiben, bleibt der Prüfsatz unverändert, und die Seite meldet Nicht gespeichert: Der Eintrag ins Protokoll kam nicht zustande. Bitte versuchen Sie es erneut.
Gewichtung
Die Gewichtung stellt ein, wie die Suche Treffer bewertet. Die Erklärung dazu lautet Der Titelfaktor bestimmt, wie stark ein Treffer in der Überschrift eines Abschnitts zählt, das Schlüsselwortgewicht, wie stark ein beim Aufbau ermitteltes Schlüsselwort zählt. Leere Felder heißen Vorgabe. Abstimmen misst den Prüfsatz mit jedem Kandidaten durch und ändert nichts, solange Sie nicht übernehmen.
| Feld | Grenzen | Vorgabe und Wirkung |
|---|---|---|
| Titelfaktor | 1 bis 5, in Schritten von 0,1 | Vorgabe 1,8. Bei 1 zählt ein Treffer in der Überschrift nicht mehr als einer im Text. |
| Schlüsselwortgewicht | 0 bis 10, ganze Zahlen | Vorgabe 3; 0 schaltet die Schlüsselwörter ab. Die Schlüsselwörter bildet der Dienst beim Aufbau selbst, bis zu 14 je Abschnitt. Pflegen lassen sie sich nicht. |
- Unter jedem Feld stehen Bereich und Vorgabe. Gewichtung speichern übernimmt beide Werte und meldet Gewichtung gespeichert. Daneben steht, was gilt: Es gilt mit Titelfaktor und Schlüsselwortgewicht.
- Abstimmen braucht mindestens eine Prüfzeile und misst die ältesten 20 Prüfzeilen mit mehreren Kandidaten: zuerst die Titelfaktoren 1,0, 1,4, 1,8, 2,2, 2,6 und 3,0, dann mit dem besten davon die Schlüsselwortgewichte 0, 1, 2, 3, 5 und 8. Jeder Kandidat steht danach mit Trefferqualität und Gefunden in einer Liste, der geltende mit Es gilt, darüber etwa Gemessen an 20 von 35 Prüfzeilen. Das Abstimmen selbst speichert nichts. Während es misst, steht auf dem Knopf Wird gemessen ….
- Bestwert übernehmen ist nur frei, wenn der beste Kandidat die geltende Einstellung echt schlägt; bei Gleichstand bleibt der Knopf gesperrt, und über der Liste steht Kein Kandidat ist besser als die geltende Einstellung. Der Knopf misst noch einmal gegen den heutigen Bestand und speichert den Bestwert nur, wenn er dabei weiter vorn liegt; dann meldet die Seite Bestwert übernommen. Währenddessen steht auf dem Knopf Wird gespeichert ….
- Gewichtung speichern und Bestwert übernehmen ändern die Gewichte nur zusammen mit einem Eintrag ins Protokoll. Lässt sich der Eintrag nicht schreiben, bleiben die bisherigen Werte, und die Seite meldet Nicht gespeichert: Der Eintrag ins Protokoll kam nicht zustande. Bitte versuchen Sie es erneut.
Fragen mit Notfallantwort
Diese Liste zeigt Besucherfragen der letzten 30 Tage, auf die der Assistent nur mit der Notfallantwort reagiert hat, weil die Antworterzeugung ausfiel. Ausgewertet werden die letzten 50 solcher Fälle; die Fragen sind anonymisiert, auf 300 Zeichen gekürzt und zu Gruppen ähnlicher Fragen zusammengefasst. Die Seite sagt dazu Hier stehen Fragen, auf die der Assistent nur die Notfallantwort gab, weil die Antworterzeugung ausfiel. Ähnliche Fragen sind zusammengefasst, oben steht, was am meisten wiegt: betroffene Gespräche, übergebene doppelt. Ein Klick legt daraus ein Paar an – die Antwort tragen Sie darüber ein. Fragen, zu denen nichts Belegtes gefunden wurde, finden Sie in der Auswertung.
- Jede Gruppe nennt, wie oft gefragt wurde, wie viele Gespräche betroffen waren und wie viele davon übergeben wurden, etwa 5 mal gefragt · 3 Gespräche betroffen, 1 davon übergeben, dazu die Varianten der Gruppe.
- Als Paar übernehmen legt ein Paar mit der Frage und den Varianten der Gruppe an, ohne Antwort und damit inaktiv; die Zeile zeigt danach Gespeichert. Die Antwort tragen Sie oben unter Frage-Antwort-Paare nach und haken Aktiv an. Die übernommenen Varianten stehen dort im Feld Varianten, eine je Zeile; kürzen Sie, was nicht zur Frage passt, bevor Sie das Paar aktivieren.
- Ohne Einträge steht In den letzten 30 Tagen hat der Assistent keine Notfallantwort gegeben.
- Die Liste setzt die Gesprächsauswertung im Tarif voraus. Fehlt sie, steht dort Der Tarif … enthält diese Funktion nicht. Die Übersicht steht unter Abrechnung. mit dem Namen Ihres Tarifs.
- Scheitert das Laden, erscheint Die Liste konnte nicht geladen werden. mit dem Knopf Erneut laden. Erkennt der Dienst die Zeitzone Ihres Geräts nicht, lautet der Satz stattdessen Die Zeitzone dieses Geräts erkennt der Dienst nicht. Ohne sie lässt sich der Zeitraum nicht abgrenzen, darum fehlt die Liste. Ein neuer Versuch ändert daran nichts., und der Knopf Erneut laden fehlt.
Wissen aktuell halten
Der Assistent antwortet aus dem Stand, den Ihre Quellen gerade haben. Eine Angabe, die nicht mehr stimmt, gibt er so wieder wie eine richtige. Diese Handgriffe halten den Bestand verlässlich:
- Nach einer Änderung auf Ihrer Website wählen Sie Neu einlesen, statt auf die nächste Auffrischung zu warten. Während des Laufs aktualisiert sich die Liste alle 5 Sekunden; ist er durch, zeigt sie aufgenommen, die Zahlen der Dokumente und Abschnitte und Zuletzt bestätigt mit Datum.
- Den Inhalt einer Text- oder Dateiquelle ändern Sie nicht an Ort und Stelle: Bearbeiten ändert nur Bezeichnung und Einstellungen. Legen Sie den neuen Stand als neue Quelle an und löschen Sie danach die alte. Text- und Dateiquellen frischt auch kein Zeitplan auf, eingereiht werden nur Websites.
- Löschen Sie Quellen, die niemand mehr pflegt. Der Assistent sucht zu jeder Frage in allen Quellen zugleich, eine vergessene Quelle kann darum jederzeit in eine Antwort einfließen.
- Führen Sie Preise, Fristen und Zusagen in genau einer Quelle. Stehen zwei Fassungen im Bestand, kann jede in eine Antwort gelangen. Die Nachprüfung harter Angaben fängt das nicht ab: Sie meldet Angaben, die in keinem der vorliegenden Abschnitte stehen, nicht solche, die veraltet sind.
- Gehen Sie die Fragen mit Notfallantwort und in der Auswertung die Erkannten Lücken regelmäßig durch und ergänzen Sie, was Ihren Quellen fehlt.
- Lassen Sie nach größeren Änderungen am Bestand die Abnahme erneut laufen.
Grenzen je Minute und Tarif
Wie oft sich eine Aktion je Minute auslösen lässt, zählt je angemeldetem Konto:
| Aktion | Höchstens je Minute |
|---|---|
| Quelle aufnehmen, Neu einlesen, Zurückholen und Streuung aufbauen zusammen | 20 |
| Suche über die Schnittstelle | 60 |
| Frage stellen unter Antwort prüfen | 30 |
| Messen | 6 |
| Abstimmen und Bestwert übernehmen | 2 |
Darüber meldet die Seite Zu viele Versuche. Bitte warten Sie einen Moment. Beim Anlegen prüft der Dienst außerdem die Obergrenzen Ihres Tarifs für Quellen, Dokumente und Abschnitte, beim Neu einlesen die für Dokumente und Abschnitte. Ist eine erreicht, erscheint eine Meldung mit Tarif und Zahlen, etwa Die Grenze des Tarifs … ist erreicht: … von …. Die Übersicht steht unter Abrechnung., oder Der gebuchte Tarif deckt das nicht ab. Die Übersicht steht unter Abrechnung. Die Grenzen je Tarif stehen unter Pakete und Kontingente und auf der Preisseite.
Über die Schnittstelle
Quellen, Paare, Suche, Probefragen und Prüfsatz lassen sich auch über die Schnittstelle bedienen, etwa POST /api/v1/knowledge/ask für eine belegte Antwort. Endpunkte, Felder und Antworten beschreibt Schnittstelle: Wissen und Assistenten, die Grenzen Grenzen der Schnittstelle.
Häufige Fragen
Wann bemerkt der Assistent Änderungen auf meiner Website?
Beim nächsten Auffrischen. Fällig ist eine Websitequelle, sobald seit ihrer letzten Bestätigung die Frist unter Auffrischung in Tagen abgelaufen ist, ohne eigene Angabe die Frist des Hauses (7 Tage); dann reiht ein Zeitplan sie ein. Ohne zu warten, reihen Sie mit Neu einlesen im aufgeklappten Formular der Quelle einen Lauf ein.
Warum bekomme ich unter Antwort prüfen keine Antwort?
Ohne Beleg aus einer Quelle gibt es keine Antwort. Steht dort Dazu steht nichts in der hinterlegten Wissensbasis., fehlt das Thema in den Quellen oder die Suche findet es nicht. Prüfen Sie, ob die Quelle auf aufgenommen steht, und legen Sie eine Prüfzeile an, um zu sehen, auf welchem Platz das erwartete Dokument landet.
Antwortet der Assistent im Widget mit gepflegten Paaren?
Ja. Passt eine Frage im Widget zu einem aktiven Paar mit Antwort, geht dessen Antwort im Wortlaut hinaus, ohne dass ein Modell gefragt wird. Die Übergabe nach Punktzahl und die festen Regeln gelten dabei weiter: Berührt die Frage eine feste Sperre, ein angekreuztes Thema oder einen Tabueintrag, geht das Gespräch an einen Menschen, und unter der Antwort steht der Pflichthinweis in der Antwort. Ob eine Frage ein Paar trifft, sehen Sie vorab unter Antwort prüfen: Trifft sie eines, steht dort Diese Antwort stammt aus einem gepflegten Paar.
Wie schließe ich einzelne Seiten meiner Website aus?
Tragen Sie unter Ausgeschlossene Pfade ein Muster je Zeile ein, etwa /intern/ oder *.pdf$. Die Muster gelten zusätzlich zur robots.txt, stehen über ihr und wirken ab dem nächsten Lauf.
Lässt sich ein Neu einlesen rückgängig machen?
Ja, solange die vorige Fassung noch vorgehalten wird. Unter Fassungen holt Zurückholen eine der letzten 5 Fassungen zurück; die neueren werden dabei verworfen.
Selbst fragen, Assistent dieser Website
Automatischer Assistent