So schreiben Sie effektive Wissensquellen für RAG-basierte Systeme (Wissensentdeckung)

Dieser uid bietet praktische Empfehlungen zum Schreiben oder Verbessern von Artikeln, Handbüchern und uid , die als Quellenmaterial in einem RAG-KI-System (Retrieval-Augmented Generation) verwendet werden. Ziel ist es, dem Modell das Verstehen und Abrufen relevanter, präziser Informationen so einfach wie möglich zu machen.

1. 🎯 Definieren Sie für jedes Dokument einen klaren Zweck

Jedes Dokument sollte eine bestimmte Frage oder einen bestimmten Anwendungsfall beantworten.

Geben Sie im Titel und in den Überschriften klar an, worum es in dem Dokument geht (z. B. „So setzen Sie Ihr Kennwort in ESM zurück“ , „VPN-Einrichtung für Remote-Mitarbeiter“ ).

Vermeiden Sie es, Themen zu vermischen . Es ist besser, lange Dokumente in kleinere, fokussierte Dokumente aufzuteilen.

2. 🧱 Verwenden Sie strukturierte Abschnitte und klare Überschriften

Organisieren Sie den Inhalt in logische Abschnitte: Einführung, Schritt-für-Schritt, Hinweise, Häufige Probleme, FAQ .

Verwenden Sie H2/H3-Überschriften – dies hilft dem Modell, die Struktur und den Kontext des Inhalts zu verstehen.

Jede Aktion oder Anweisung sollte in einem eigenen Schritt oder Absatz stehen.

3. 🔢 Verwenden Sie nummerierte Schritte und Aufzählungspunkte

Verwenden Sie anstelle langer Absätze:

## How to reset your password
1. Go to the login page.
2. Click on “Forgot password”.
3. Enter your company email address.
4. Check your inbox and click the reset link.

KI verarbeitet dieses Format viel besser als unstrukturierten Text.

4. 📌 Verwenden Sie eine einheitliche Terminologie

Verwenden Sie klare und konsistente Namen für Systeme, Teams, Funktionen und Akronyme (z. B. „ESM-Plattform“, „IT-Support-Team“, „FortiClient VPN“).

Vermeiden Sie die Verwendung von Abkürzungen oder internem Fachjargon, sofern dieser nicht definiert ist.

5. 🧠 Stellen Sie Kontext innerhalb des Dokuments Pro

Fügen Sie eine kurze Erklärung hinzu, warum etwas getan wird. Zum Beispiel:

„Um die Sicherheitsrichtlinien des Unternehmens einzuhalten, ist alle 90 Tage eine Passwortzurücksetzung erforderlich.“

Das Modell versteht Zweck und Absicht besser, wenn Kontext verfügbar ist.

6. 🔍 Wichtige Informationen hervorheben

Heben Sie wichtige Punkte (wie Pfade, Einstellungen, Warnungen, Tipps) durch fetten Text oder visuelle Formatierung hervor:

Hinweis: Nach dem Zurücksetzen Ihres Passworts müssen Sie sich erneut beim VPN anmelden.

Dies hilft dem Modell zu erkennen, worauf es in der Antwort ankommt.

7. 📂 Ein Dokument = ein Thema

❌ Schlechte Praxis: „Alles, was Sie über ESM wissen müssen“

✅ Gute Praxis:

„So reichen Sie einen Urlaubsantrag in ESS2 ein“

„So überprüfen Sie den Ticketstatus in ESM“

„So aktivieren Sie MFA für Ihr Firmenkonto“

8. 💬 Fügen Sie FAQs und typische Benutzerfragen hinzu

KI antwortet häufig auf Fragen in natürlicher Sprache. Fügen Sie einen Abschnitt wie diesen ein:

## Frequently Asked Questions
- What if I didn't receive the reset email?
- Can I reset my password outside the office network?

9. 🧪 Vor der Veröffentlichung testen

Versuchen Sie, Fragen zu stellen, die den tatsächlichen Benutzern ähneln, und prüfen Sie, ob die Antworten im Text leicht zu finden sind.

Testen Sie das Dokument optional mit dem KI-System und bewerten Sie die Qualität der generierten Antworten.

10. 🧼 Verwenden Sie eine einfache, korrekte Sprache

KI erzielt die besten Ergebnisse bei kurzen, klaren und grammatikalisch korrekten Sätzen .

Vermeiden Sie zu technische oder komplexe Ausdrücke.

Verwenden Sie direkte Anweisungen anstelle von bedingter oder suggestiver Sprache.

✍️ Beispiel: Schlecht vs. Gut

❌ Schlecht:

Wenn der Benutzer Probleme beim Anmelden hat, kann er versuchen, sich an das Kennwort zu erinnern, oder er kann zur ESM-Anmeldeseite gehen und dort möglicherweise die Option zum Zurücksetzen verwenden.

✅ Gut:

So setzen Sie Ihr Passwort zurück:

Gehen Sie zur ESM-Anmeldeseite.

Klicken Sie auf „Passwort vergessen“.

Geben Sie Ihre Firmen-E-Mail-Adresse ein.

Überprüfen Sie Ihren Posteingang und klicken Sie auf den Link zum Zurücksetzen.

⚠️ Wichtig: Verwenden Sie für alle Dokumente eine einheitliche Sprache

Um ein hohes Maß an Genauigkeit und Antwortqualität im KI-System zu gewährleisten, müssen alle Quelldokumente in derselben Sprache verfasst sein . Das Mischen von Sprachen innerhalb der Wissensdatenbank verringert die Modelleffizienz und die Klarheit der Antworten erheblich.

Bitte entscheiden Sie im Voraus, welche Hauptsprache verwendet werden soll (z. B. Englisch, Finnisch, Deutsch, Schwedisch oder Polnisch), und stellen Sie sicher, dass alle Artikel, Anweisungen und Dokumentationen dieser Auswahl konsequent folgen.