IT-Dokumentation mit AI vorbereiten und durch Menschen prüfen

Ein sinnvoller Einstieg ist eine klar benannte Aufgabe: etwa eine interne Prüfliste für einen bekannten Support-Ablauf oder die strukturierte Beschreibung freigegebener Bearbeitungsschritte. Legen Sie fest, für wen der Text bestimmt ist und welches Vorwissen vorausgesetzt wird. Eine Anleitung für einen erfahrenen Administrator braucht andere Informationen als eine Orientierung für den Service-Desk.

Die AI soll vorhandenes Wissen strukturieren. Sie kann aus fehlenden Voraussetzungen keine belastbare Vorgehensweise erzeugen. Sind Quellen widersprüchlich oder beschreiben sie unterschiedliche Systemversionen, muss diese Unklarheit vor einer Übernahme fachlich geklärt werden.

Geeignet sind freigegebene Verfahrensbeschreibungen, redigierte Bearbeitungsnotizen und bekannte Prüfregeln. Halten Sie fest, auf welches System und welche Version sich die Information bezieht. Relevant sind auch die erforderliche Rolle, erlaubte Aktionen und Bedingungen, unter denen der Ablauf abgebrochen oder eskaliert werden muss.

Redigieren Sie unnötige vertrauliche Inhalte, ohne den fachlichen Zusammenhang zu zerstören. Ein Platzhalter für ein System muss konsistent sein. Passwörter, Tokens und private Kundendetails gehören nicht in einen Dokumentationsentwurf. Der verwendete AI-Provider und die Verarbeitung der vorgesehenen Eingabefelder müssen vor einer Umsetzung freigegeben sein.

Die Ausgabe sollte eine spätere Prüfung erleichtern. Trennen Sie Voraussetzungen, einzelne Schritte und Erfolgskontrollen. Eine Beobachtung ist kein Befehl, und ein vorgeschlagener Schritt ist keine bestätigte Maßnahme. Wo eine Information fehlt, sollte der Entwurf eine offene Frage zeigen. Eine Quelle oder nachvollziehbare Zuordnung hilft, Aussagen auf ihre Grundlage zurückzuführen.

• Zweck, Zielgruppe und Geltungsbereich der Anleitung
• Benötigte Informationen, Rollen und technische Voraussetzungen
• Aus den Quellen abgeleitete Schritte in nachvollziehbarer Reihenfolge
• Prüfpunkte, Abbruchbedingungen und offene Fragen
• Quellenstand und benannte Verantwortung für die fachliche Prüfung

Angenommen, eine erfundene Support-Notiz beschreibt eine VPN-Unterbrechung. Die lokale Netzwerkverbindung wurde geprüft; als nächster Schritt ist die Sichtung eines freigegebenen Dienststatus vorgesehen. Die Notiz nennt jedoch keinen Ort, an dem dieser Status zu finden ist. Das Beispiel ist synthetisch und kein Kundenfall.

Im erwarteten Entwurf steht: „Nächster Schritt: Dienststatus prüfen. Offen: freigegebene Statusquelle und benötigte Rolle.“ Ein erfundener Befehl oder Neustart wäre keine Ergänzung der Notiz. Die verantwortliche Person klärt Quelle und Rolle und prüft den Geltungsbereich. Bis dahin wird der Schritt nicht zur Durchführung freigegeben.

Prüfen Sie jede Aussage gegen die freigegebenen Quellen: Sind Voraussetzungen vollständig? Passen Rolle und Systemversion? Ist ein Schritt fachlich belegt und seine Kontrolle beschrieben? Wo praktische Tests erforderlich sind, werden diese in der passenden Testumgebung mit den vereinbarten Berechtigungen durchgeführt. Die AI-Ausgabe selbst führt keine beschriebenen Aktionen aus.

Ein gut lesbarer Text kann veraltet oder sachlich falsch sein. Deshalb werden Entwurfsstatus, Quellenstand und offene Fragen sichtbar gehalten. Erst nach der menschlichen Prüfung erfolgt eine vereinbarte Übernahme. Wer spätere Änderungen fachlich verantwortet und wann eine erneute Prüfung nötig ist, gehört zur Definition des Dokumentationsablaufs.

Der AI Automation Pilot kann einen Dokumentationsworkflow in einem vereinbarten Testsystem umsetzen. Dafür werden Eingabe, Ausgabeformat und menschlicher Prüfschritt eingegrenzt. Normale Fälle sowie fehlende oder widersprüchliche Quellen werden mit geeigneten redigierten Beispielen geprüft. Testprotokoll und Übergabeanleitung beschreiben den geprüften Umfang und bekannte Grenzen.

Produktive Veröffentlichung, weitere Anbindungen und laufende Pflege werden separat vereinbart. Für den Erstcheck beschreiben Sie die gewünschte Dokumentationsaufgabe, die vorhandenen Quellen und wer den Inhalt prüfen würde. Senden Sie zunächst keine Zugangsdaten oder vertraulichen Notizen. Daniel Djogic bespricht die Voraussetzungen direkt mit Ihnen.