Felsökning

Problem: AI-agenten svarar inkorrekt eller verkar "hitta på" information.

Lösning:

1. Kontrollera att kunskapsbasen (Knowledge) innehåller korrekt information om ämnet
2. Sök efter ärendet i Analytics → AI Suggestions — kanske finns det som content gap
3. Granska Policies — en topic_filter kan blockera rätt svar
4. Kör scenariot i Testing med dry-run för att se confidence och använda källor
5. Om confidence är hög men svaret fel: uppdatera eller ta bort den felaktiga kunskapskällan

Problem: AI löser < 50% av konversationerna.

Lösning:

1. Gå till Analytics → AI Suggestions — godkänn föreslagna kunskapsartiklar
2. Granska Top Topics med låg confidence — skapa dedikerade kunskapskällor
3. Kontrollera confidence-tröskeln i Settings → AI Configuration — om den är > 0.8 kan den vara för strikt
4. Skapa Procedures för vanliga flöden som kräver data-lookup (orderstatus, returer)
5. Kör Flywheel-cykeln veckovis — se AI Insights

Problem: Chat-widgeten syns inte på hemsidan.

Lösning:

1. Verifiera att embed-koden finns före </body>-taggen
2. Kontrollera att data-api-key är korrekt (hämta från Settings → Widget)
3. Kontrollera att data-api-url pekar på din SWEO AI-instans
4. Öppna webbläsarens Developer Console (F12) → Network-fliken → sök efter chat-widget.js
5. Om du ser CORS-fel: lägg till din domän i tillåtna origins under Settings
6. Testa med en ren inkognito-flik (adblockers kan blockera chat-widgets)

Problem: Data Connector misslyckas eller ger timeout.

Lösning:

1. Gå till Connectors och klicka Testa Anslutning
2. Kontrollera att API-nyckeln inte har gått ut (Shopify-tokens roteras ibland)
3. Verifiera Base URL — vanligt fel: https://mystore.myshopify.com (inte .com/admin)
4. Kontrollera att API-nyckeln har rätt scopes (t.ex. read_orders för Shopify)
5. Vid timeout: det externa API:t kan vara nere — kontrollera deras statuspage

Problem: Inkommande e-post skapar inte konversationer.

Lösning:

1. Verifiera att din e-postleverantör (CloudMailin/SendGrid) forwarding pekar på https://your-domain.com/api/webhooks/email
2. Skicka ett test-mejl och kontrollera webhook-loggar
3. Kontrollera att e-postadressen inte filtrerats som spam av din provider
4. Verifiera SPF/DKIM/DMARC-konfiguration för din domän

Problem: AI-agenten svarar långsamt (> 5 sekunder).

Lösning:

• Använd streaming — SSE-endpointen (/api/chat/stream) visar svar token-för-token, vilket upplevs snabbare
• Kontrollera kunskapsbas-storlek — Extremt stora kunskapsbaser (10 000+ chunks) kan ge långsammare embedding-sökning. Rensa irrelevanta källor.
• Minska top_k — Standardvärdet (5) bör räcka. Högre värden ger långsammare svar utan proportionell kvalitetsförbättring.
• Connector-latens — Om Procedures gör externa API-anrop adderas deras latens. Kontrollera connector-prestanda i Analytics.