KI-Agenten und strukturierte Dokumentation
Wenn Maschinenlesbarkeit nicht mehr optional istKI-Agenten und strukturierte Doku: Warum Struktur zur Schnittstelle wird
Wer in den letzten fünfzehn Jahren eine Website betrieben hat, kennt die Übung: Sprechende Titel statt „Startseite", saubere Überschriftenhierarchie, Metadaten im Seitenkopf, ein Thema je Seite, konsistente Begriffe. Das Ganze hieß Suchmaschinenoptimierung, war zeitweise überkandidelt und lief im Kern auf eine schlichte Einsicht hinaus: Wer gefunden werden will, muss maschinenlesbar sein.
Genau diese Übung steht der Technischen Dokumentation bevor – nur mit höherem Einsatz. Denn ein KI-Agent zeigt nicht zehn Treffer, aus denen ein Mensch wählt. Er wählt selbst und gibt eine Antwort. Der Auswahlfehler wird damit nicht mehr sichtbar korrigiert, sondern zur Auskunft, auf die jemand sein Handeln stützt. Und die Auskunft betrifft nicht die Bestellseite eines Onlineshops, sondern die Frage, wie eine Maschine sicher zu warten ist.
Dieser Artikel nutzt die Analogie als Denkbrücke: Was Suchmaschinen von Websites wollten, wollen Agenten von Dokumentation – strenger und mit mehr Folgen. Er zeigt, wie ein Agent auf einer Wissensbasis arbeitet, welche drei Reichweiten dabei entstehen und welche sechs Maßnahmen die Redaktion ergreifen kann. Die beruhigende Nachricht steht am Anfang: Keine dieser Maßnahmen ist neu.
|
★ Fakten kompakt |
|---|
Was ein Agent anders macht als eine Suche
Der Unterschied zwischen Suche und Agent ist der Schritt vom Finden zum Zusammensetzen. Eine Suche nimmt Begriffe entgegen und liefert Dokumente, in denen sie vorkommen – die Bewertung übernimmt der Mensch. Ein Agent bekommt eine Aufgabe: „Die Anlage meldet Fehler E-204, was ist zu tun?" Er zerlegt diese Aufgabe, sucht in der Wissensbasis, grenzt über Metadaten ein, findet die Fehlerbeschreibung an einer Stelle, die Abhilfe an einer anderen und den zugehörigen Warnhinweis womöglich an einer dritten – und setzt daraus eine Antwort zusammen.
Dieses Zusammensetzen ist die eigentliche Leistung und zugleich die eigentliche Anforderung. Es gelingt nur, wenn die Bausteine dafür taugen: wenn die Fehlerbeschreibung als abgegrenzter Abschnitt vorliegt, wenn erkennbar ist, zu welchem Produkt und welcher Version sie gehört, und wenn der Warnhinweis nicht drei Kapitel entfernt steht, sondern bei der Handlung, zu der er gehört. Ein Bestand aus zusammenhanglosen Fließtextkapiteln lässt sich nicht sinnvoll zusammensetzen – der Agent produziert dann eine Antwort aus Bruchstücken, die zusammenhanglos gesammelt wurden und trotzdem zusammenhängend klingen.
Und noch eine Eigenschaft unterscheidet ihn: Er kann handeln. Ein Agent im engeren Sinn liest nicht nur, sondern führt Schritte aus – ruft ein System auf, prüft einen Bestand, erzeugt einen Eintrag. Für die Dokumentation heißt das perspektivisch: Er könnte den Wartungsplan prüfen, die passende Anleitung heraussuchen und einen Serviceauftrag anlegen. Damit wird die Frage, ob die Doku maschinenlesbar ist, zur Frage, ob sie an solchen Abläufen überhaupt teilnehmen kann.
Ein Wort zur nüchternen Einordnung, damit dieser Beitrag nicht zur Prophezeiung wird: Die dritte Fähigkeit — das Handeln — ist in der Doku-Praxis heute Ausnahme, nicht Regel. Was in mittelständischen Häusern tatsächlich stattfindet, sind Assistenten, die Fragen beantworten. Alles Weitere ist absehbar, aber nicht dringend. Die Maßnahmen, um die es in diesem Beitrag geht, sind trotzdem sinnvoll — nicht wegen der dritten Stufe, sondern weil sie auf jeder Stufe wirken, angefangen bei der ganz gewöhnlichen Suche.

Abb.: Auftrag, Arbeit, Antwort – und die Wissensbasis, die alles trägt.
Die Analogie: was Suchmaschinen wollten
Die Parallele zur Suchmaschinenoptimierung ist kein rhetorischer Trick, sondern hilfreich – weil die Anforderungen tatsächlich dieselben sind. Suchmaschinen wollten sprechende Titel, weil ein Titel namens „Seite 3" nichts über den Inhalt sagt. Agenten brauchen sprechende Überschriften aus demselben Grund, mit einer Verschärfung: Überschriften bestimmen, wo Inhalte in Abschnitte zerlegt werden. Ein Kapitel „Allgemeines" mit zwölf Seiten wird an beliebigen Stellen geschnitten, und die Fundstellen enthalten dann alles Mögliche.
Suchmaschinen wollten Metadaten im Seitenkopf. Agenten brauchen Metadaten am Dokument – Produkt, Sprache, Version, Status, Gültigkeit –, und zwar aus einem Grund, den es im Web so nicht gab: Sie müssen unterscheiden können, was gilt. Eine Website hat selten drei Fassungen derselben Seite nebeneinander; eine Doku-Ablage hat sie regelmäßig. Suchmaschinen wollten ein Thema je Seite statt Bauchladen-Seiten. Agenten brauchen eigenständige Topics, die ohne ihren Vorgänger verständlich sind – „wie oben beschrieben" ist die Sackgasse dieses Themenfelds.
Und Suchmaschinen belohnten konsistente Begriffe. Bei Agenten ist das keine Belohnung, sondern eine Bedingung: Wenn dieselbe Komponente in drei Dokumenten drei Namen trägt, findet ein Agent je nach Formulierung der Frage alles oder nichts. Der entscheidende Unterschied zum Web liegt aber woanders – in der Sichtbarkeit des Fehlers. Eine schlechte Suchmaschinenplatzierung merkt man; eine falsch zusammengesetzte Agentenantwort sieht aus wie eine richtige. Deshalb ist die Anforderung strenger, obwohl die Maßnahmen dieselben sind.

Abb.: Vier Anforderungen, zweimal – die rechte Spalte erklärt, warum es diesmal strenger zugeht.
Die Warnhinweise verdienen in diesem Zusammenhang eine gesonderte Betrachtung, weil sie die heikelste Stelle sind. In vielen Anleitungen stehen allgemeine Sicherheitshinweise gesammelt am Anfang und spezielle bei den Handlungen — eine gewachsene Praxis, die für einen menschlichen Leser funktioniert, der das Dokument von vorn liest. Ein Agent liest nicht von vorn: Er greift den Abschnitt heraus, der zur Frage passt. Ein Warnhinweis, der drei Kapitel entfernt steht, kommt dann nicht mit.
Die Konsequenz ist eine redaktionelle Entscheidung, die man bewusst treffen sollte: Sicherheitsrelevante Hinweise gehören dorthin, wo die Handlung beschrieben wird — auch auf die Gefahr der Wiederholung. Das widerspricht dem Instinkt, Wiederholungen zu vermeiden, und es ist bei wiederverwendeten Bausteinen ohnehin die richtige Praxis: Ein Topic trägt seine Warnungen mit, sonst kann es nicht eigenständig verwendet werden. Wer das umsetzt, verbessert damit gleichzeitig die Wiederverwendbarkeit — zwei Ziele, dieselbe Maßnahme — und beide sind unabhängig von KI richtig.
Wo die Analogie endet
Bei aller Nützlichkeit hat die Parallele zur Suchmaschinenoptimierung zwei Stellen, an denen sie in die Irre führt — und beide sind wichtig genug, um sie zu benennen. Die erste betrifft das Ziel. Bei Websites ging es um Sichtbarkeit gegenüber Wettbewerbern: Wer weiter oben steht, bekommt den Klick. Bei Technischer Dokumentation gibt es diesen Wettbewerb nicht. Niemand konkurriert um die Frage, wie die eigene Maschine zu warten ist — es gibt nur eine richtige Antwort, und sie steht in der eigenen Anleitung. Das Ziel ist deshalb nicht Sichtbarkeit, sondern Richtigkeit.
Daraus folgt ein wichtiger Unterschied im Vorgehen: Suchmaschinenoptimierung hatte immer eine Kunst-Komponente — man versuchte, ein Bewertungsverfahren zu bedienen, das der Anbieter nicht offenlegte. Für Dokumentation gibt es diese Ebene nicht. Es geht nicht darum, ein Werkzeug zu überlisten, sondern darum, Inhalte so zu bauen, dass sie richtig verstanden werden. Wer in diesem Themenfeld nach Tricks sucht, sucht am falschen Ort — die wirksamen Maßnahmen sind allesamt schlichte Handwerksregeln, die seit Jahrzehnten in jedem Lehrbuch stehen.
Die zweite Stelle betrifft die Folgen. Eine schlecht platzierte Website kostet Umsatz; eine falsch beantwortete Wartungsfrage kann jemanden verletzen. Das klingt dramatisch und ist der nüchterne Grund, warum dieses Thema die Redaktion angeht und nicht das Marketing: Es geht um Instruktionsqualität unter neuen Bedingungen. Wer die Analogie als Denkbrücke nutzt, sollte sie an dieser Stelle wieder verlassen.
Drei Reichweiten
Wo begegnet einem das konkret? In drei Situationen mit sehr unterschiedlicher Steuerbarkeit. Die erste ist der Assistent im eigenen Haus, auf der eigenen Ablage – der Fall, den der Copilot-Beitrag dieser Serie behandelt. Hier hat man alles in der Hand: welcher Bestand zugänglich ist, welche Metadaten gepflegt sind, welche Berechtigungen gelten. Diese Reichweite ist heute Realität, steuerbar und prüfbar – und sie ist der richtige Ort, um anzufangen.
Die zweite Reichweite ist unbequemer: Der Kunde nutzt eigene Werkzeuge auf deiner Dokumentation. Ein Betreiber lädt die Betriebsanleitung als PDF in einen Assistenten und fragt, wie ein Bauteil zu wechseln ist – ohne dass der Hersteller davon erfährt oder darauf Einfluss hätte. Das passiert längst, in jedem Haus, das digitale Anleitungen bereitstellt. Und die Antwort, die der Betreiber bekommt, hängt vollständig an der Beschaffenheit des Dokuments: Ist die Anleitung sauber gegliedert, mit sprechenden Überschriften und Werten in echten Tabellen, bekommt er brauchbare Auskunft. Ist sie ein gescanntes Fließtext-PDF, bekommt er Erfundenes oder gar nichts.
Die dritte Reichweite entsteht gerade: Zugriffe von System zu System. Instandhaltungssoftware, Serviceplattformen und Betreiber-Systeme greifen auf Herstellerdokumentation zu, ohne dass ein Mensch liest – um Wartungsintervalle abzugleichen, Ersatzteile zu ermitteln oder Prüfanweisungen bereitzustellen. Für diese Stufe wird Struktur von einer Qualitätsfrage zur Schnittstellenfrage. Wer heute strukturiert dokumentiert, kann später anschließen; wer es nicht tut, wird umbauen müssen – und zwar unter Zeitdruck, weil dann ein Kunde danach fragt und eine Frist im Raum steht.
Für die zweite Reichweite gibt es einen Aspekt, der über Sicherheit hinausgeht und deshalb selten mitgedacht wird: Was ein Assistent über ein Produkt auskunftsfähig ist, prägt den Eindruck vom Hersteller. Wenn ein Betreiber zu Maschine A brauchbare Antworten bekommt und zu Maschine B nicht, weil deren Anleitung ein Scan ohne Texterkennung ist, entsteht ein Qualitätsunterschied, der mit der Maschine nichts zu tun hat. In Branchen mit vergleichbaren Produkten kann das mittelfristig ein Unterscheidungsmerkmal werden — nicht als Marketingargument, sondern als erlebte Servicequalität.

Abb.: Drei Reichweiten mit unterschiedlicher Steuerbarkeit – und derselben Anforderung an die Inhalte.
|
Eigenschaft |
Wirkung beim Agenten |
Gern vergessen? |
|---|---|---|
|
Sprechende Überschriften |
Bestimmen die Abschnittsgrenzen |
Ja – als Formatvorlage, nicht nur fett |
|
Status als Metadatum |
Unterscheidet Gültiges von Altem |
Ja – der wichtigste Einzelpunkt |
|
Produktbezug als Feld |
Verhindert Antworten zur falschen Baureihe |
Ja – steht meist nur im Fließtext |
|
Eigenständige Abschnitte |
Fundstellen funktionieren allein |
Ja – „siehe oben" bleibt beliebt |
|
Werte in echten Tabellen |
Zahlen sind überhaupt erst lesbar |
Ja – Bildtabellen fallen nie auf |
|
Texterkennung bei Scans |
Ohne sie existiert das Dokument nicht |
Ja – fehlende Treffer sind unsichtbar |
Sechs Maßnahmen — und keine ist neu
Damit zum praktischen Teil, und der ist erfreulich unspektakulär. Erstens Status und Produktbezug als Metadaten am Dokument statt im Dateinamen – damit ein Agent erkennt, was gilt und wozu es gehört. Zweitens sprechende Überschriften als echte Formatvorlagen, weil sie die Abschnittsgrenzen bestimmen. Drittens eigenständige Abschnitte: Jeder trägt seine Voraussetzungen und Warnungen mit, ohne Verweis auf Vorheriges. Viertens einheitliche Benennungen, damit dieselbe Frage in unterschiedlichen Formulierungen dieselben Treffer liefert.
Fünftens Text statt Bild: Werte in echten Tabellen, Abbildungen mit beschreibendem Alternativtext, gescannte Altdokumente mit Texterkennung. Und sechstens die Erreichbarkeit – was hinter einer Anmeldung liegt, sieht kein externer Agent. Für Betriebsanleitungen ist das eine bewusste Entscheidung wert, wie der Beitrag zur externen Bereitstellung ausführt: Wer sie öffentlich zugänglich macht, entscheidet damit auch darüber, welche Auskünfte über sein Produkt im Umlauf sind.
Wer diese sechs Punkte durchgeht, merkt es sofort: Es sind exakt die Prinzipien, die diese Serie an anderen Stellen aus ganz anderen Gründen empfiehlt – Formatvorlagen-Disziplin, Metadatenpflege, topic-basiertes Schreiben, Terminologie, saubere Ausgabe. Nichts davon wurde für KI erfunden. Die Agentenfrage macht lediglich sichtbar und dringlich, was ohnehin gute Redaktionsarbeit war. Wer sich das klarmacht, spart sich ein KI-Projekt: Es genügt, die ohnehin richtige Arbeit endlich konsequent zu machen — mit einem Argument mehr in der Hand.
Für die Reihenfolge gilt dieselbe Priorisierungslogik wie bei jeder Bestandsarbeit in dieser Serie: nach Nutzungshäufigkeit statt nach Vollständigkeit. Welche zehn Themen werden im Service am häufigsten nachgefragt? Genau diese Abschnitte lohnen die Aufmerksamkeit zuerst — mit sprechenden Überschriften, zugehörigen Warnhinweisen und Werten in echten Tabellen. Der größte Teil des Nutzens ist damit gehoben, bei einem Aufwand von Tagen statt Monaten. Der Rest folgt bei ohnehin anstehenden Überarbeitungen.

Abb.: Sechs Maßnahmen mit Verweis auf ihren jeweiligen Ursprung in dieser Serie.
|
⚠ Warnung: Der unsichtbare Kanal Reichweite zwei ist die unangenehmste, weil sie unsichtbar stattfindet. Ein Betreiber lädt die Anleitung in ein Werkzeug seiner Wahl, bekommt eine Antwort und handelt danach — der Hersteller erfährt davon nichts, weder von der Frage noch von der Antwort. Wenn diese Antwort falsch ist, weil das Dokument mehrdeutig war oder Werte nur in Bildtabellen standen, entsteht ein Risiko, das im Haus niemand bemerkt. Was man dagegen tun kann, ist begrenzt und trotzdem wirksam: das Dokument so bauen, dass ein Werkzeug daraus nichts Falsches zusammensetzen kann. Eindeutige Überschriften, Warnhinweise bei der Handlung statt im Sammelkapitel, Werte in echtem Text, klare Produktzuordnung auf jeder Seite. Das ist derselbe Aufwand wie für den eigenen Assistenten — und wirkt in einem Kanal, den man sonst gar nicht erreicht. |
|---|
Eine Frage taucht an dieser Stelle regelmäßig auf: Sollten wir unsere Dokumentation gezielt für KI-Werkzeuge aufbereiten — etwa mit zusätzlichen Auszeichnungen oder maschinenlesbaren Ergänzungen? Die ehrliche Antwort für die meisten Häuser lautet: noch nicht. Solche Formate existieren, sind aber weder etabliert noch von allen Werkzeugen unterstützt, und der Aufwand steht in keinem Verhältnis zum heutigen Nutzen. Was dagegen sicher wirkt, sind die sechs Maßnahmen — sie sind werkzeugunabhängig, wirken bei Menschen ebenso wie bei Systemen und veralten nicht.
Für die erste Reichweite lohnt eine architektonische Anmerkung, die den Unterschied zwischen brauchbar und beliebig ausmacht: Der Zugriffsbereich eines Agenten sollte kuratiert sein, nicht der Gesamtbestand. Eine Wissensbasis aus ausschließlich freigegebenen, aktuellen Ständen liefert bessere Antworten als eine, die alles enthält — und zwar unabhängig davon, wie gut die Metadaten sind. Weniger, dafür verlässlich, schlägt mehr und unklar; das ist dieselbe Erkenntnis wie bei der Suche, und sie gilt hier verschärft, weil der Agent selbst auswählt.
Praktisch bedeutet das eine bewusste Zusammenstellung: Betriebsanleitungen der aktiven Baureihen, Serviceunterlagen, Fehlerlisten, Wartungspläne — jeweils in der gültigen Fassung. Ausgelaufene Produkte gehören dort nur hinein, wenn ihre Maschinen noch im Feld sind, und dann mit klarer Produktzuordnung. Alles Weitere — Entwürfe, Projektunterlagen, Protokolle — bleibt draußen. Diese Zusammenstellung ist übrigens dieselbe, die für die externe Bereitstellung taugt; wer eine hat, hat beide.
Was Struktur als Schnittstelle bedeutet
Für die dritte Reichweite lohnt ein genauerer Blick, weil sie das Selbstverständnis der Redaktion berührt. Wenn Systeme auf Dokumentation zugreifen, wird die Doku Teil einer technischen Kette – ähnlich wie Stammdaten oder Stücklisten. Und für solche Ketten gelten andere Erwartungen als für Lesestoff: Verlässliche Struktur, eindeutige Kennungen, stabile Adressen, klare Versionierung. Genau das leistet strukturierte Dokumentation, und genau das leistet ein gewachsener Word-Bestand nicht.
Praktisch heißt das nicht, dass jede Redaktion jetzt Schnittstellen bauen muss. Es heißt, dass die Entscheidungen, die man ohnehin trifft, künftig eine zusätzliche Dimension haben. Ob ein Wartungsintervall als Fließtextsatz oder als Tabellenwert mit Einheit dasteht, war bisher eine Frage der Lesbarkeit; künftig entscheidet es darüber, ob ein System den Wert übernehmen kann. Ob Produkte über eine gepflegte Werteliste identifiziert werden oder über Freitext, war eine Ordnungsfrage; künftig ist es eine Anschlussfrage.
Wer weiter denken will, findet in den Standards der Branche bereits Vorarbeit: Strukturierte Formate wie DITA sind auf genau diese Maschinenlesbarkeit hin entworfen, und Austauschstandards für technische Informationen existieren in verschiedenen Branchen. Für die meisten mittelständischen Redaktionen ist das noch nicht die dringende Frage – die dringende Frage lautet, ob die eigenen Inhalte überhaupt sauber genug sind, um irgendwann anschlussfähig zu sein. Und genau darauf antworten die sechs Maßnahmen, um die es im nächsten Kapitel geht.
Ein Gedanke zum Selbstverständnis der Redaktion sei ergänzt, weil dieses Thema ihn berührt. Über Jahre galt Technische Dokumentation als Pflichtübung am Ende der Entwicklungskette — nötig für die Konformität, gelesen von wenigen, geschätzt von noch weniger. Wenn Inhalte zur Grundlage von Assistenten und Systemen werden, ändert sich die Rolle: Die Doku wird zur Wissensbasis des Unternehmens über sein eigenes Produkt. Das ist keine Aufwertung durch schöne Worte, sondern eine handfeste Veränderung der Verwendung — und ein Argument, das in Budgetgesprächen erfahrungsgemäß besser ankommt als der Verweis auf Vorschriften.
Eine praktische Frage zum Schluss dieses Kapitels: Woran erkennt man, ob der eigene Bestand für Agenten taugt, ohne einen einzusetzen? Ein einfacher Test hilft — nimm einen beliebigen Abschnitt aus der Mitte einer Anleitung, kopiere ihn ohne Umgebung heraus und lies ihn wie ein Fremder. Ist erkennbar, zu welchem Produkt er gehört? Sind die Voraussetzungen genannt? Steht die zugehörige Warnung dabei? Wenn ein Mensch mit diesem Ausschnitt nichts anfangen kann, kann ein Agent es auch nicht — er sieht am Ende exakt denselben Ausschnitt.
Dieser Test hat den Vorzug, dass er ohne jede Technik funktioniert und sich in fünf Minuten an drei Stellen durchführen lässt. Und er beantwortet die Ausgangsfrage präziser als jede Werkzeugdemonstration: Ein Bestand, dessen Abschnitte einzeln gelesen Sinn ergeben, ist agententauglich. Einer, bei dem der Kontext im Kopf des Lesers entstehen muss, ist es nicht — und zwar unabhängig davon, wie leistungsfähig das eingesetzte Werkzeug ist.
Was man messen kann
Ein Vorbehalt gegen dieses ganze Themenfeld ist berechtigt: Vieles davon ist Zukunftsmusik, und Zukunftsmusik ist ein schlechtes Argument für Budget. Deshalb lohnt der Hinweis, dass sich der Fortschritt messen lässt – mit derselben Übung, die schon für Suche und Assistent taugt: der Zwanzig-Fragen-Probe. Zwanzig echte Fragen aus Service und Vertrieb, gestellt an den eigenen Assistenten auf dem eigenen Bestand, mit einer schlichten Bewertung: richtig, unvollständig, falsch.
Diese Messung hat drei Vorzüge. Sie ist konkret statt spekulativ. Sie ist wiederholbar, sodass sich Fortschritt belegen lässt. Und sie deckt alle drei Reichweiten ab – denn was der interne Assistent beantworten kann, kann auch das Werkzeug des Kunden beantworten, sofern das Dokument erreichbar ist. Wer die Probe zweimal im Abstand von sechs Monaten durchführt und dazwischen an den sechs Maßnahmen arbeitet, hat einen belastbaren Nachweis in der Hand.
Für die zweite Reichweite lohnt eine Variante: dieselben zwanzig Fragen an ein allgemeines Werkzeug stellen, dem man nur die öffentlich verfügbare Betriebsanleitung vorlegt. Das simuliert, was ein Betreiber erlebt – und die Ergebnisse fallen erfahrungsgemäß deutlich schlechter aus als beim internen Assistenten, weil dort die Metadaten fehlen und nur das PDF vorliegt. Genau diese Differenz zeigt, wie viel Arbeit im Dokument selbst steckt statt im System drumherum.
|
✓ Praxis-Tipp: Die PDF-Probe Nimm eine ausgelieferte Betriebsanleitung als PDF, leg sie einem allgemeinen KI-Werkzeug vor und stelle fünf typische Servicefragen — genau so, wie ein Betreiber es täte. Bewerte die Antworten nach drei Kriterien: Stimmt es fachlich? Ist der zugehörige Warnhinweis mitgekommen? Bezieht sich die Antwort auf die richtige Baureihe? Das dauert zwanzig Minuten und zeigt schonungslos, was aus dem eigenen Dokument herausgeholt werden kann — und was nicht. Die häufigsten Befunde: Werte fehlen, weil sie in Bildtabellen stehen; Warnhinweise tauchen nicht auf, weil sie in einem Sammelkapitel am Anfang stehen; und die Antwort mischt Angaben zu zwei Varianten, weil das Dokument beide ohne klare Trennung behandelt. Alle drei Befunde sind behebbar — und zwar mit überschaubarem Aufwand an den Stellen, die am häufigsten gebraucht werden. |
|---|
|
ℹ Ein typischer Fall aus der Praxis Ein typischer Fall sieht so aus: Ein Hersteller stellt seine Betriebsanleitungen öffentlich zum Download bereit und macht aus Neugier die PDF-Probe mit fünf Servicefragen. Das Ergebnis ernüchtert: Bei zwei Fragen fehlen die Zahlenwerte, weil die Wartungstabelle als Grafik eingebunden ist. Bei einer dritten liefert das Werkzeug die Schrittfolge korrekt, aber ohne den zugehörigen Warnhinweis — der steht im Sicherheitskapitel am Anfang der Anleitung, nicht bei der Handlung. Die Konsequenz war weniger dramatisch als befürchtet: Die Wartungstabelle wurde als echte Tabelle neu aufgebaut, die zentralen Warnhinweise wanderten zu den Handlungen, zu denen sie gehören, und die Überschriften wurden geschärft. Aufwand: wenige Tage für die aktive Baureihe. Der Nebeneffekt war der eigentliche Gewinn — dieselben Änderungen verbesserten die Lesbarkeit für Menschen und die Trefferqualität der internen Suche gleich mit. |
|---|
Bleibt die Frage nach dem Zeitpunkt — wann lohnt der Aufwand? Die Antwort fällt bequem aus, weil sie keine Prognose braucht: Die sechs Maßnahmen zahlen sich unabhängig von jeder KI-Entwicklung aus. Sprechende Überschriften verbessern die Lesbarkeit, Metadaten die Suche, eigenständige Abschnitte die Wiederverwendung, Terminologie die Übersetzungskosten, echte Tabellen die Barrierefreiheit. Wer sie umsetzt, macht keine Wette auf eine Technologie, sondern verbessert die Dokumentation — und ist auf die absehbare Entwicklung nebenbei vorbereitet.
Das ist übrigens der Grund, warum dieses Thema in Budgetgesprächen leichter fällt als andere KI-Themen: Man beantragt keine Zukunftsinvestition, sondern Redaktionsqualität mit einem zusätzlichen Argument. Und wenn die dritte Reichweite dann tatsächlich kommt — Systeme, die auf Herstellerdokumentation zugreifen —, steht man nicht am Anfang, sondern muss die vorhandenen Inhalte nur noch anschließen.
Fazit
Die Analogie trägt: Was Suchmaschinen von Websites verlangten – sprechende Titel, Metadaten, ein Thema je Seite, konsistente Begriffe –, verlangen KI-Agenten von Dokumentation. Nur strenger, weil ein Agent nicht zehn Treffer zeigt, sondern eine Antwort gibt, und weil der Auswahlfehler damit unsichtbar wird. Drei Reichweiten sind zu unterscheiden: der Assistent im Haus, fremde Werkzeuge beim Kunden und künftig Zugriffe von System zu System – und alle drei stellen dieselben Anforderungen.
Die sechs Maßnahmen dagegen sind erfreulich vertraut: Status und Produktbezug als Metadaten, sprechende Überschriften als Formatvorlagen, eigenständige Abschnitte, einheitliche Benennungen, Text statt Bild, bewusst entschiedene Erreichbarkeit. Keine davon wurde für KI erfunden. Der beste erste Schritt kostet zwanzig Minuten: die PDF-Probe mit fünf Servicefragen an der eigenen Anleitung. Wenn du bei der Einordnung oder der Aufbereitung des Bestands Unterstützung willst: Genau dabei unterstütze ich dich gern; die Details findest du auf der Beratungsseite zur Technischen Dokumentation.
Häufige Fragen zu KI-Agenten und Dokumentation
Was ist der Unterschied zwischen einer Suche und einem Agenten?
Eine Suche liefert Treffer, aus denen ein Mensch auswählt – der Auswahlfehler ist sichtbar und wird korrigiert. Ein Agent zerlegt eine Aufgabe, sucht in mehreren Schritten, grenzt über Metadaten ein und setzt Fundstellen zu einer Antwort zusammen. Diese Antwort erscheint fertig, und ob die richtigen Bausteine verwendet wurden, sieht man ihr nicht an. Genau deshalb sind die Anforderungen an Struktur und Metadaten höher als bei einer Suche – das Zusammensetzen gelingt nur mit eigenständigen, sauber ausgezeichneten Abschnitten.
Müssen wir uns darum kümmern, wenn wir keine KI einsetzen?
Ja, weil eine der drei Reichweiten außerhalb der eigenen Entscheidung liegt: Betreiber laden Betriebsanleitungen in eigene Werkzeuge und fragen dort nach – ohne dass der Hersteller davon erfährt. Was diese Werkzeuge antworten, hängt vollständig am Dokument: Ist es sauber gegliedert, mit Werten in echten Tabellen und Warnhinweisen bei den Handlungen, kommt Brauchbares heraus. Ist es ein gescanntes Fließtext-PDF, kommt Erfundenes oder nichts. Diese Reichweite findet statt, ob man will oder nicht.
Was ist die wichtigste Einzelmaßnahme?
Der Status als Metadatum – die Angabe, ob ein Dokument gilt. Ein Agent erkennt inhaltliche Ähnlichkeit, aber keine Gültigkeit: Ein Entwurf von 2019 über den Filterwechsel sieht für ihn genauso passend aus wie die freigegebene Fassung. Ohne Statusfeld gibt es keine Möglichkeit, die eine von der anderen zu unterscheiden. Auf Platz zwei folgt der Produktbezug als Feld, weil er Antworten zur falschen Baureihe verhindert – der zweithäufigste Fehler in diesem Themenfeld.
Brauchen wir dafür DITA oder ein Redaktionssystem?
Nein. Strukturierte Formate erleichtern die Sache, weil sie Eigenständigkeit und saubere Abschnittsgrenzen erzwingen – aber die sechs Maßnahmen lassen sich auch in der Dokumentwelt umsetzen: Metadaten am Dokument, Überschriften als echte Formatvorlagen, eigenständige Abschnitte, einheitliche Benennungen, Werte in echten Tabellen, bewusste Erreichbarkeit. Das sind Fragen der Redaktionsdisziplin, nicht der Werkzeugwahl. Wer ohnehin über eine Systemfrage nachdenkt, hat mit der Anschlussfähigkeit allerdings ein zusätzliches Argument.
Wie messen wir, ob unser Bestand tauglich ist?
Mit der PDF-Probe: eine ausgelieferte Anleitung einem allgemeinen KI-Werkzeug vorlegen und fünf typische Servicefragen stellen – genau so, wie ein Betreiber es täte. Bewertet wird nach drei Kriterien: fachlich richtig, Warnhinweis mitgekommen, richtige Baureihe. Das dauert zwanzig Minuten und liefert eine konkrete Mängelliste. Ergänzend taugt die Zwanzig-Fragen-Probe am internen Assistenten; wiederholt nach einem halben Jahr belegt sie den Fortschritt gegenüber Team und Geschäftsführung.
|
Interne Links: Pillar (/technische-dokumentation/) · Copilot trifft Technische Doku (/copilot-technische-dokumentation/) · Metadaten für Technische Doku (/metadaten-technische-dokumentation/) · Externe Doku-Bereitstellung (/externe-doku-bereitstellung/) · Beratung (/technische-dokumentation-beratung/) |
|---|
