Hur man skriver effektiva kunskapskällor för RAG-baserade system (kunskapsupptäckt)

Denna uid ger praktiska rekommendationer för att skriva eller förbättra artiklar, manualer och uid som kommer att användas som källmaterial i ett RAG (Retrieval-Augmented Generation) AI-system. Målet är att göra det så enkelt som möjligt för modellen att förstå och hämta relevant, exakt information.

1. 🎯 Definiera ett tydligt syfte för varje dokument

Varje dokument bör besvara en specifik fråga eller ett användningsfall .

Ange tydligt vad dokumentet handlar om i titeln och rubrikerna (t.ex. ”Hur du återställer ditt lösenord i ESM” , ”VPN-konfiguration för distansanställda” ).

Undvik att blanda ihop ämnen – det är bättre att dela upp långa dokument i mindre, mer fokuserade dokument.

2. 🧱 Använd strukturerade avsnitt och tydliga rubriker

Organisera innehållet i logiska avsnitt: Introduktion, Steg-för-steg, Anteckningar, Vanliga problem, Vanliga frågor .

Använd H2/H3-rubriker – detta hjälper modellen att förstå innehållets struktur och sammanhang.

Varje handling eller instruktion bör finnas i ett eget steg eller stycke.

3. 🔢 Använd numrerade steg och punktlistor

Istället för långa stycken, använd:

## 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.

AI hanterar detta format mycket bättre än ostrukturerad text.

4. 📌 Använd konsekvent terminologi

Använd tydliga och konsekventa namn för system, team, funktioner och akronymer (t.ex. ”ESM-plattform”, ”IT-supportteam”, ”FortiClient VPN”).

Undvik att använda förkortningar eller intern jargong om inte annat anges.

5. 🧠 Pro sammanhang i dokumentet

Lägg till en kort förklaring till varför något görs. Till exempel:

"Lösenordsåterställning krävs var 90:e dag för att följa företagets säkerhetspolicy."

Modellen förstår syfte och avsikt bättre när kontext finns tillgänglig.

6. 🔍 Markera viktig information

Betona viktiga punkter (som sökvägar, inställningar, varningar, tips) med fetstil eller visuell formatering :

Obs: Efter att du har återställt ditt lösenord måste du logga in på VPN igen.

Detta hjälper modellen att identifiera vad som är viktigt i svaret.

7. 📂 Ett dokument = ett ämne

❌ Dålig praxis: ”Allt du behöver veta om ESM”

✅ God praxis:

"Hur man skickar in en ledighetsansökan i ESS2"

"Hur man kontrollerar ärendestatus i ESM"

"Så här aktiverar du MFA för ditt företagskonto"

8. 💬 Inkludera vanliga frågor och typiska användarfrågor

AI svarar ofta på frågor som rör naturligt språk. Inkludera ett avsnitt som:

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

9. 🧪 Testa innan publicering

Testa riktiga användarvänliga frågor och se om svaren lätt kan hittas i texten.

Du kan också testa dokumentet via AI-systemet och utvärdera kvaliteten på de genererade svaren.

10. 🧼 Använd ett enkelt och korrekt språk

AI fungerar bäst med korta, tydliga och grammatiskt korrekta meningar .

Undvik alltför tekniska eller komplicerade fraser.

Använd direkta instruktioner snarare än villkorligt eller suggestivt språk.

✍️ Exempel: Dålig vs Bra

❌ Dåligt:

Om användaren har inloggningsproblem kan de försöka komma ihåg lösenordet eller gå till ESM-inloggningssidan och kanske använda återställningsalternativet.

✅ Bra:

Så här återställer du ditt lösenord:

Gå till ESM:s inloggningssida.

Klicka på “Glömt lösenord”.

Ange din företags-e-postadress.

Kontrollera din inkorg och klicka på återställningslänken.

⚠️ Viktigt: Använd ett enda språk i alla dokument

För att upprätthålla en hög nivå av noggrannhet och svarskvalitet i AI-systemet måste alla källdokument vara skrivna på samma språk. Att blanda språk inom kunskapsbasen minskar modellens effektivitet och svarens tydlighet avsevärt.

Bestäm i förväg vilket huvudspråk som ska användas (t.ex. engelska, finska, tyska, svenska eller polska) och se till att alla artiklar, instruktioner och dokumentation följer det valet konsekvent.