Hantera kunskapskällor

Ladda upp dokument, crawla URL:er och hantera AI-agentens kunskapsinnehåll.

Written by SWEO AI Team

Updated over 2 weeks ago

Typer av kunskapskällor

I Knowledge kan du mata AI:n med kunskap via tre metoder:

MetodFormatBäst förFile Upload.pdf, .docx, .txt, .md, .csv (max 20 MB)Produktmanualer, FAQ-dokument, prislistorURL CrawlingVilken webbsida som helstHelp Center, dokumentationssajter, bloggarManuellt innehållFritext via APIInterna policies, specifika svar

Alla källor visas i en tabell med kolumnerna: Source (filnamn/URL), Type (file/url/manual), Status, Added och en Delete-knapp.

URL-crawling i detalj

Gå till Knowledge → Add Knowledge Source → URL-fliken.

Klistra in webbadressen i fältet, t.ex. https://example.com/docs/getting-started
Klicka Ingest URL
SWEO AI hämtar och extraherar texten från sidan
Texten delas upp i chunks, embeddings genereras och lagras i vektordatabasen

Status visas i tabellen: Processing → Ready (eller Failed vid fel). Tabellen pollar automatiskt var 5:e sekund under processing.

Tips: Crawla din Help Center-startsida för att få in allt innehåll på en gång.

Filuppladdning

Gå till Knowledge → Add Knowledge Source → File Upload-fliken.

Drag & drop en fil i uppladdningszonen, eller klicka för att bläddra
Accepterade format: .pdf, .docx, .txt, .md, .csv
Maximal filstorlek: 20 MB

Bakom kulisserna sker följande:

Filen laddas upp till Appwrite Storage via uploadFileAction
En bakgrundsjobb (POST /api/embeddings) triggas
Texten extraheras, delas i chunks och embeddings genereras
Resultat lagras i vektordatabasen kopplat till ditt tenant-ID

Exempel: Ladda upp product-faq.pdf → status visar Processing → efter ~30 sekunder blir det Ready → din AI kan nu svara på frågor från dokumentet.

Manuellt innehåll

Du kan lägga till manuellt innehåll via API:t med manualSourceAction. Detta är användbart för specifika svar som inte finns i befintliga dokument.

Manuellt innehåll kan även skapas via Analytics → AI Suggestions-fliken, där AI:n föreslår artiklar baserat på content gaps. Klicka Approve & Add för att lägga till ett AI-genererat förslag direkt i Knowledge Base.

Versionshantering

SWEO AI har inbyggd versionshantering för kunskapskällor via versionManagementAction. När du uppdaterar en källa:

Den gamla versionen sparas
Du kan återställa till en tidigare version
Varje version har en tidsstämpel och en unik versionsnummer

Tips: Exportera hela din Knowledge Base som JSON-backup via GET /api/knowledge/export innan stora ändringar.

Chunking & Embeddings

När en kunskapskälla laddas upp sker dessa steg automatiskt i bakgrunden via POST /api/embeddings:

Text extraction — Text extraheras från PDF/DOCX/HTML
Chunking — Texten delas i lagom stora delar för optimal sökning
Embedding-generering — Varje chunk konverteras till en numerisk vektor
Upsert till vektorStore — Vektorerna lagras i Pinecone med tenant-isolering

Vid varje kundfråga sker sedan en vektorsökning som hittar de 5 mest relevanta chunks (top_k = 5). Dessa används som kontext i LLM-prompten.

Synkstatus

Varje källa i Knowledge-tabellen har en statuskolumn:

StatusBetydelseProcessingTexten extraheras, chunks skapas och embeddings genererasReadyKällan är aktiv och sökbar — AI:n kan använda denFailedNågot gick fel — kontrollera filformatet eller URL:en

Under Processing pollar tabellen automatiskt var 5:e sekund tills statusen ändras.

Tips & best practices

Så får du bäst resultat från Knowledge Base:

Ladda upp FAQ först — Ger snabbast resultat, tydliga fråga/svar-par matchar bäst
En källa per ämne — returer.pdf, frakt.md, priser.docx istället för en gigantisk fil
Skriv tydliga rubriker — AI:n hittar bättre med rubriker som "Hur returnerar jag en vara?" än "Sektion 3.2"
Undvik bilder/tabellbilder — AI:n läser text, inte bilder. Konvertera tabellbilder till text
Granska content gaps — Besök Analytics → AI Suggestions veckovis och godkänn förslag
Exportera/importera — Använd /api/knowledge/export och /api/knowledge/import för backup och migreringar