Webinhalte für KI verständlich strukturieren

KI-Systeme lesen Inhalte häufig ausschnittsweise. Ein Assistent kann eine ganze Webseite abrufen. Ein Suchsystem kann ihm aber auch nur einen einzelnen Abschnitt liefern. Fehlen darin der Gegenstand, eine Voraussetzung oder eine wichtige Einschränkung, wird selbst ein fachlich richtiger Text leicht missverständlich.

Dieser Ratgeber zeigt, wie Sie Webseiten, Hilfeartikel und technische Dokumentation so aufbauen, dass einzelne Abschnitte auch außerhalb der vollständigen Seite verständlich bleiben. Sie erhalten konkrete Arbeitsschritte, Beispiele und eine Checkliste für die Prüfung.

Die wichtigste Regel: Ein Abschnitt sollte eine konkrete Frage beantworten und den Kontext enthalten, der für diese Antwort notwendig ist.

Wie KI-Systeme Ihre Inhalte lesen

Der direkte Abruf einer Webseite

Ein KI-Assistent ruft eine Seite ab und verarbeitet deren Inhalt. Dabei kann HTML in eine vereinfachte Textdarstellung oder Markdown umgewandelt werden. Gestaltungselemente fallen unter Umständen weg. Bei langen Seiten kann der Inhalt gekürzt werden.

Für diesen Zugriffsweg sind eine klare Seitenstruktur, verständlicher Text und früh sichtbare Verweise auf weiterführende Inhalte hilfreich.

Die Suche in einzelnen Textabschnitten

Bei einem Abruf aus einer Wissensdatenbank wird eine Seite häufig schon vor der eigentlichen Suchanfrage in kleinere Einheiten zerlegt. Diese Einheiten heißen Chunks.

Der Ablauf kann so aussehen:

1. Webseiten oder Dateien werden eingelesen.
2. Ein Parser erkennt Text und Strukturelemente wie Überschriften, Listen und Tabellen.
3. Ein Chunker zerlegt die Inhalte in kleinere Abschnitte.
4. Die Abschnitte werden in einem durchsuchbaren Index gespeichert, beispielsweise mithilfe von Vektoreinbettungen.
5. Bei einer Anfrage erhält der Assistent passende Ausschnitte und gegebenenfalls Metadaten wie Seitentitel und URL.

Ein MCP-Server kann eine solche Suche als Werkzeug bereitstellen. MCP selbst zerlegt und indexiert keine Inhalte. Entscheidend ist das Suchsystem hinter dem Werkzeug.

Ob übergeordnete Überschriften, benachbarte Abschnitte oder Tabellenköpfe mitgeliefert werden, hängt von der jeweiligen Implementierung ab.

Schritt 1: Prüfen Sie Ihren tatsächlichen Einfluss

Bevor Sie Texte überarbeiten, klären Sie, ob Sie nur die Website oder auch das verarbeitende Suchsystem kontrollieren.

Wichtig für SEO und GEO: Eine gut lesbare Abschnittsstruktur kann die Verarbeitung Ihrer Inhalte erleichtern. Daraus folgt keine Garantie für Rankings, Zitate oder Empfehlungen in KI-Antworten. Die Einstellungen Ihrer eigenen Wissensdatenbank lassen sich außerdem nicht pauschal auf öffentliche Suchmaschinen übertragen.

Schritt 2: Beginnen Sie mit zehn wichtigen Seiten

Überarbeiten Sie zunächst eine überschaubare Auswahl. So erkennen Sie wiederkehrende Probleme, bevor Sie die gesamte Website verändern.

Wählen Sie beispielsweise Seiten mit:

• häufigen Kundenfragen,
• wichtigen Produkt- oder Leistungsinformationen,
• langen Anleitungen,
• umfangreichen Tabellen,
• mehreren Betriebssystem- oder Produktvarianten,
• wichtigen Informationen, die nur in Grafiken stehen.

Notieren Sie pro Seite das größte Verständnisproblem und die geplante Änderung.

Schritt 3: Geben Sie jedem Abschnitt eine klare Aufgabe

Lange Abschnitte behandeln oft mehrere Fragen gleichzeitig. Werden sie automatisch geteilt, kann ein Ausschnitt mitten in einer Erklärung beginnen.

Gliedern Sie deshalb nach konkreten Nutzerfragen oder Aufgaben.

Zu allgemein:

„Einrichtung“

Konkreter:

• „Welche Voraussetzungen die Einrichtung benötigt“
• „Wie Sie ein neues Benutzerkonto anlegen“
• „Wie Sie Zugriffsrechte vergeben“
• „Wie Sie die Einrichtung überprüfen“

Jeder Abschnitt sollte eine zusammenhängende Antwort liefern. Trennen Sie eine Voraussetzung oder Einschränkung nicht von der Handlung, für die sie gilt.

Prüfung: Lesen Sie nur die Überschrift und den zugehörigen Abschnitt. Sind Aufgabe, Gegenstand und Bedingungen erkennbar?

Schritt 4: Nutzen Sie aussagekräftige echte Überschriften

Eine Überschrift wie „Einschränkungen“ ist innerhalb einer Seite nachvollziehbar. Als Beginn eines isolierten Suchausschnitts fehlt ihr der Gegenstand.

Setzen Sie Überschriften im CMS als tatsächliche Überschriften um. Ein fett formatierter Absatz ersetzt kein semantisches Überschriftenelement.

Nutzen Sie eine nachvollziehbare Hierarchie. Für viele Ratgeber genügen H2 und H3 unter dem Seitentitel. Tiefere Ebenen sind sinnvoll, wenn der Inhalt sie benötigt. Verflachen Sie die Hierarchie nicht allein wegen einer vermuteten KI-Präferenz. Prüfen Sie bei einem eigenen Suchsystem, welche Ebenen der Parser erkennt und der Chunker berücksichtigt.

Schritt 5: Machen Sie wichtige Aussagen eigenständig verständlich

Achten Sie besonders auf Formulierungen wie „diese Einstellung“, „das Verfahren“, „wie oben beschrieben“ oder „dadurch“. Sie können ihren Bezug verlieren, wenn ein vorheriger Absatz fehlt.

Vorher:

„Diese Einstellung überschreibt den Standard. Sie sollte vor dem nächsten Export angepasst werden.“

Nachher:

„Der individuell festgelegte Exportzeitpunkt ersetzt den voreingestellten Exportzeitpunkt. Ändern Sie ihn vor dem nächsten geplanten Datenexport, wenn dieser bereits zur neuen Uhrzeit stattfinden soll.“

Das Ziel ist ausreichender Kontext. Wiederholen Sie Produktnamen und Begriffe dort, wo sonst Mehrdeutigkeit entsteht. Eine schematische Wiederholung in jedem Satz macht den Text unnötig schwerfällig.

Prüfung: Kopieren Sie einen mittleren Abschnitt in ein leeres Dokument. Ist ohne den vorherigen Text klar, worauf sich die Aussagen beziehen?

Schritt 6: Orientieren Sie die Abschnittslänge am verwendeten System

Chunk-Größen werden häufig in Tokens gemessen. Tokens sind Verarbeitungseinheiten und entsprechen keiner festen Anzahl von Wörtern. Sprache, Fachbegriffe, Code, URLs und Tabellen beeinflussen das Verhältnis.

Es gibt keine allgemeingültige Wortzahl für KI-freundliche Abschnitte.

Wenn Sie das Suchsystem kontrollieren:

1. Ermitteln Sie das tatsächlich eingestellte Größenlimit.
2. Prüfen Sie, ob Überschriften und weiterer Kontext innerhalb dieses Limits mitgezählt werden.
3. Planen Sie Spielraum für solche Ergänzungen ein.
4. Kontrollieren Sie, ob zusammengehörige Erklärungen vollständig in einem Ausschnitt landen.

Wenn Sie das System nicht kontrollieren, gliedern Sie lange Passagen nach sinnvollen Teilfragen. Kürzen Sie keine notwendige Erklärung, nur um eine vermeintliche Idealzahl zu erreichen.

Schritt 7: Halten Sie Tabellen auch ausschnittsweise verständlich

Eine Tabelle kann auf der Website übersichtlich sein und nach einer automatischen Aufteilung unverständlich werden. Fehlen die Spaltenüberschriften, ist ein Wert wie „Nein“ oder „30“ kaum eindeutig.

Prüfen Sie:

• Bleiben Tabellenköpfe bei einer Aufteilung erhalten?
• Stehen Einheiten direkt bei den Werten oder eindeutig in der Spaltenbezeichnung?
• Ist klar, ob eine Zahl einen Standardwert, einen Höchstwert oder eine Voraussetzung bezeichnet?
• Sind Ausnahmen der richtigen Zeile zugeordnet?

Teilen Sie lange Tabellen bei Bedarf nach Themen auf. Aus einer großen Parametertabelle können beispielsweise getrennte Tabellen für Anmeldung, Zeitlimits und Wiederholungsversuche entstehen. Jede erhält eine eigene Überschrift und einen vollständigen Tabellenkopf.

Behalten Sie den Nutzen für Menschen im Blick: Eine große filterbare Tabelle kann weiterhin sinnvoll sein. Ergänzende Detailseiten sollten möglichst aus derselben Datenquelle entstehen. In einer eigenen Wissensdatenbank können Sie gezielt festlegen, welche Darstellung indexiert wird, damit dieselben Inhalte nicht unnötig mehrfach auftauchen.

Schritt 8: Gliedern Sie Anleitungen nach abgeschlossenen Teilaufgaben

Ein Ausschnitt, der bei Schritt acht beginnt, lässt oft offen, was vorher erledigt sein muss.

Zerlegen Sie lange Abläufe in sinnvolle Etappen, beispielsweise:

• Benutzerkonto anlegen
• Identität bestätigen
• Zugriffsrechte vergeben
• Anmeldung testen

Nennen Sie zu Beginn jeder Etappe die notwendigen Voraussetzungen. Halten Sie Warnungen unmittelbar bei der betroffenen Handlung.

Ungünstig:

Eine allgemeine Warnung zur Datensicherung steht nach einer langen Liste mit Löschschritten.

Besser:

Der betreffende Schritt lautet: „Erstellen Sie vor dem Löschen eine Sicherung der vorhandenen Daten. Löschen Sie anschließend …“

So bleibt die Voraussetzung mit der Handlung verbunden, wenn nur dieser Teil abgerufen wird.

Schritt 9: Sichern Sie den Kontext von Codebeispielen

Bei langen Codeblöcken können Initialisierung, eigentlicher Aufruf und Fehlerbehandlung in unterschiedlichen Ausschnitten landen.

Gehen Sie folgendermaßen vor:

1. Stellen Sie unmittelbar vor den Codeblock, was das Beispiel tut und welche Voraussetzungen gelten.
2. Gliedern Sie längere Beispiele in klar benannte Teilaufgaben.
3. Kennzeichnen Sie Ausschnitte, die allein nicht ausführbar sind.
4. Verlinken Sie zusätzlich ein vollständiges ausführbares Beispiel, wenn der Anwendungsfall es erfordert.
5. Prüfen Sie im eigenen Suchsystem, ob Codeblöcke geteilt werden.

Kürzen Sie Beispiele nicht so stark, dass notwendige Abhängigkeiten oder Sicherheitsprüfungen fehlen. Ein Suchausschnitt kann beim Finden des Beispiels helfen; für die Umsetzung kann der vollständige Code erforderlich sein.

Schritt 10: Schreiben Sie die Kernaussage von Grafiken in den Text

Nicht jedes System verarbeitet Bilder oder SVG-Diagramme zuverlässig. Bei einer vereinfachten Textdarstellung können nur Alternativtext und Bildadresse übrig bleiben.

Beschreiben Sie deshalb die fachlich wichtige Aussage im umgebenden Text.

Beispiel:

„Die Grafik zeigt drei Schritte: Das Formular übermittelt die Anfrage an das CRM. Das CRM ordnet die Anfrage einem Ansprechpartner zu. Anschließend erhält der Ansprechpartner eine Benachrichtigung.“

Ergänzen Sie aussagekräftige Alternativtexte. Bei komplexen Diagrammen kann eine kurze Liste der Komponenten und ihrer Beziehungen sinnvoll sein.

Prüfen Sie außerdem Symbole: Wenn ein Häkchen „enthalten“ bedeutet, sollte diese Bedeutung auch textlich erkennbar sein. Rein dekorative Bilder brauchen keine zusätzliche fachliche Beschreibung.

Schritt 11: Prüfen Sie Reiter und versteckte Inhalte in der Textansicht

Reiter können eine Seite optisch verkürzen. In einer Textdarstellung können ihre Inhalte dagegen hintereinander erscheinen. Dabei können Reiterbeschriftungen fehlen oder die Gesamtlänge stark wachsen.

Typischer Fehler: Anweisungen für Windows, macOS und Linux stehen direkt hintereinander, ohne dass jeder Abschnitt sein Betriebssystem nennt.

Konkrete Verbesserung: Verwenden Sie innerhalb der Inhalte Überschriften wie „Installation unter Windows“. Bei umfangreichen Anleitungen können getrennte Plattformseiten sinnvoll sein.

Prüfen Sie auch Akkordeons: Sind deren Inhalte beim verwendeten Abruf tatsächlich vorhanden? Ist außerhalb der visuellen Oberfläche noch klar, welche Frage zu welcher Antwort gehört?

Schritt 12: Testen Sie echte Ausschnitte

Eine Sichtprüfung der Website reicht für die Beurteilung des Chunkings nicht aus. Testen Sie nach Möglichkeit die Darstellung, die Ihr Suchsystem tatsächlich erzeugt.

1. Wählen Sie einen langen Text, eine lange Tabelle und eine Anleitung mit Bildern oder Code.
2. Lassen Sie diese Inhalte durch die reale Verarbeitung laufen.
3. Sehen Sie sich die erzeugten Ausschnitte samt Metadaten an.
4. Suchen Sie mit konkreten Nutzerfragen nach den Inhalten.
5. Prüfen Sie, ob die gefundenen Ausschnitte die Antwort einschließlich Bedingungen und Ausnahmen enthalten.

Beispielfragen für den Test:

• Welche Voraussetzungen gelten für den Datenimport?
• Für welches Betriebssystem gilt die Anleitung?
• Welche Leistungen umfasst das beschriebene Paket?
• Was muss vor dem Löschen eines Datensatzes geschehen?

Halten Sie Fehler getrennt fest: Wird der richtige Inhalt nicht gefunden? Fehlt ihm Kontext? Ist er an sich unvollständig? Diese Probleme benötigen unterschiedliche Korrekturen.

Prüfauftrag für ein KI-Werkzeug

Mit diesem Prompt können Sie eine erste redaktionelle Prüfung durchführen. Die tatsächlichen Grenzen eines unbekannten Suchsystems kann der Prompt nicht verlässlich nachbilden.

Prüfe den folgenden Inhalt darauf, ob einzelne Abschnitte auch außerhalb der vollständigen Seite verständlich sind.

Untersuche:
1. Überschriften, die ihren Gegenstand nicht klar benennen.
2. Abschnitte, die mehrere eigenständige Aufgaben oder Fragen vermischen.
3. Formulierungen, deren Bezug nur aus vorherigen Abschnitten hervorgeht.
4. Voraussetzungen und Warnungen, die zu weit von der betroffenen Handlung entfernt stehen.
5. Tabellen, die ohne Spaltenüberschriften missverständlich wären.
6. Codebeispiele mit unklaren Abhängigkeiten.
7. Informationen, die ausschließlich in Bildern oder Symbolen enthalten sind.
8. Plattform- und Produktvarianten, die nicht ausdrücklich benannt werden.

Gib die Ergebnisse als Tabelle aus:
Textstelle | Verständnisproblem | Konkreter Änderungsvorschlag

Erhalte die fachliche Bedeutung, notwendige Einschränkungen und eine sinnvolle Überschriftenhierarchie. Erfinde keine Produktdetails. Kennzeichne fachliche Rückfragen.

Falls ich Einstellungen des Suchsystems angebe, berücksichtige sie. Falls keine vorliegen, unterstelle weder feste Chunk-Grenzen noch eine allgemeingültige optimale Wortzahl.

Checkliste für die Veröffentlichung

• Jede wichtige Überschrift nennt ihren Gegenstand.
• Überschriften sind semantisch korrekt ausgezeichnet.
• Jeder Abschnitt beantwortet eine erkennbare Frage oder beschreibt eine zusammenhängende Aufgabe.
• Wichtige Aussagen sind ohne unklare Rückverweise verständlich.
• Voraussetzungen und Einschränkungen stehen bei der zugehörigen Aussage.
• Warnungen bleiben mit der betroffenen Handlung verbunden.
• Tabellen enthalten eindeutige Spaltenbezeichnungen und Einheiten.
• Codebeispiele nennen Abhängigkeiten und ihren Ausführungsumfang.
• Die fachlichen Kernaussagen von Bildern stehen auch im Text.
• Plattform- und Produktvarianten sind ausdrücklich bezeichnet.
• Bei einer eigenen Wissensdatenbank wurden tatsächliche Suchausschnitte geprüft.

Starten Sie mit einer Seite: Überarbeiten Sie die Überschriften, lösen Sie unklare Rückverweise auf und ziehen Sie verstreute Voraussetzungen an die richtige Stelle. Prüfen Sie anschließend drei typische Nutzerfragen anhand einzelner Ausschnitte. Nutzen Sie die dabei gefundenen Probleme als Vorlage für die nächsten Seiten.