KAI-modulen¶

KAI er ePortal sin interne AI-assistent. Den er en tversgående funksjon som brukes av flere moduler (Prosjekt, HMS, Time, Bankavstemming, Håndbok, m.fl.), men har egen tilgangsstyring og konfigurasjon — derfor dokumenteres den som egen modul.

KAI har ikke en egen oppføring i modulregisteret (wv_Module). Tilgang styres i stedet av en samling med KAI.*-objekttyper i datatilgang-systemet, og selve KAI-funksjonene ligger som rutere/komponenter inne i de modulene de hører til (f.eks. /time/kai-chat er en del av Time-modulen — moduleId: 13, se time-routing.module.ts:21).

Egenskap	Verdi
Type	Tverr-modul AI-assistent
Tilgangsstyring	Egen RBAC (fail-closed) per funksjon via `KAI.*` ObjectTypes
Standardrute (auto-registrering av timer)	`/time/kai-chat`

Tilgang¶

KAI er fail-closed — alle KAI.*-objekttyper i wv_DataAccess seedes med CanView = 0 for alle brukernivåer som standard, og administrator må eksplisitt aktivere hver funksjon per brukernivå før den blir synlig. Den eneste unntakene som seedes med CanView = 1 er KAI.Time (lese-tilgang for ansatte til egne timeregistreringer) og KAI.BugReport (alle kan rapportere feil), se Migration_20260313110000.cs.

Hvem	Hva trengs
Ansatt	`KAI.Time` for å bruke chat-baserte timeforslag
Leder / Administrator	`KAI.Project`, `KAI.Approval`, `KAI.Handbook` osv. avhengig av funksjon
Administrator / Sysadmin	`KAI.Admin` for konfigurasjon av Master-prompts og regler

Tilgang konfigureres under Datatilgang. Tilgangsgruppen i admin-UI heter "KAI" og samler følgende ObjectTypes (verifisert i data-access-admin.component.ts:37):

ObjectType	Hva styres
`KAI.Time`	KAI chat/auto-registrering på timer (ansatt)
`KAI.Approval`	KAI-forslag i godkjenningsflyt (leder)
`KAI.Project`	KAI-planlegger / KAI-statusrapport i prosjekt
`KAI.Crm`	KAI kundebrief i CRM («før du ringer»)
`KAI.Admin`	Administrasjon av KAI (Master-prompts, regler)
`KAI.Handbook`	KAI-funksjoner i Håndbok-modulen
`KAI.BugReport`	Sende inn KAI-bug-rapporter
`KAI.Checklist`	KAI sjekkliste-generator (HMS)
`KAI.Accounting`	KAI for Live Regnskap (PowerOffice Go / Visma Business NXT)
`KAI.HMS`	KAI-funksjoner i HMS-modulen
`KAI.TimeAction`	KAI Action Mode for bulk-oppdatering av timer
`KAI.WorkflowBuilder`	KAI arbeidsflyt-generator

KAI-objekttypene følger samme Own/Department/All-scope-system som resten av wv_DataAccess, men de fleste seedes med Own som standard. Se Datatilgang for hvordan scope brukes generelt.

Funksjoner i denne modulen¶

Funksjon	Hva	ObjectType
KAI-planlegger for prosjekt	Leser et tilbud, en kravspesifikasjon eller utkast og foreslår et prosjekt-skjelett med milepæler og oppgaver. Se Bruke KAI-planlegger.	`KAI.Project`
KAI-statusrapport	Lager status-utkast (sammendrag, fremdrift, milepæler, avvik, anbefalinger) for prosjekt basert på data i ePortal. Se Generere statusrapport.	`KAI.Project`
KAI sjekkliste-generator	Tar fritekst som "Daglig kontroll av lift" og foreslår en HMS-mal med punkter, svaralternativer og obligatorisk-flagg. Se Lage sjekkliste med KAI.	`KAI.Checklist`
KAI arbeidsflyt-generator	Oversetter fritekst-beskrivelser ("når X, hvis Y, så Z") til utkast i blokk-byggeren for arbeidsflyter, med sandkasse-test før publisering. Se Lage arbeidsflyt med KAI.	`KAI.WorkflowBuilder`
KAI auto-registrering av timer	Ansatt skriver fritekst ("4 timer på Acme-prosjektet i går") — KAI foreslår timeregistrering med prosjekt, lønnsart og kommentar. Ansatt bekrefter før lagring. Standardperiode er siste 30 dager (se kai-auto-register-chat.component.ts:14-21).	`KAI.Time`
KAI Action Mode (bulk-tid)	Bulk-oppdateringer av timeregistreringer via KAI (f.eks. flytte timer mellom prosjekt, korrigere lønnsart).	`KAI.TimeAction`
KAI timekontroll / godkjenning	KAI-forslag i godkjennings-flyten — markerer rader som kan auto-godkjennes eller trenger oppmerksomhet.	`KAI.Approval`
KAI for regnskapsspørsmål / Live Regnskap	Svarer på regnskapsspørsmål med live tall fra regnskapssystemet (PowerOffice Go / Visma Business NXT): saldobalanse, transaksjoner, budsjettavvik, resultat og kunde-/leverandørreskontro. I leverandør- og kundespørsmål skiller KAI fakturaer fra betalinger, slik at «største leverandører» rangeres etter fakturert volum — ikke netto (faktura minus betaling). Avdelings-/prosjektnavn slås opp mot dimensjonsregisteret; kan ikke navnet entydig løses til en kode, sier KAI fra i stedet for å vise tall for hele selskapet. Datatilgangens dimensjonsfilter (konto/avdeling/prosjekt) håndheves også i KAI-svarene. KAI foreslår i tillegg matching mellom bankbilag og bilag i bankavstemmingen — se Bankavstemming-modulen.	`KAI.Accounting`
KAI for HMS	KAI-funksjoner som avviks-analyse, kjemikalie-tolk og lignende inne i HMS-modulen. Se HMS-modulen.	`KAI.HMS`
KAI for Håndbok	KAI-funksjoner for å skrive/foreslå håndbok-innhold og kapitler.	`KAI.Handbook`
KAI bug-rapport	La brukerne sende inn KAI-feilrapporter inkludert kontekst (siste prompt/svar) til administrator.	`KAI.BugReport`
KAI Master-prompts	Administrator/Sysadmin kan tilpasse system-promptene KAI bruker per funksjon (tone, selskaps-terminologi, særskilte krav). Se KAI-innstillinger.	`KAI.Admin`

KAI har også en regelmotor og ML-basert avvikssøking som administreres under KAI-regler og KAI ML-oppdaging. Disse styres av KAI.Admin.

Arbeidsprosesser¶

Se prosesskartet for KAI for den felles genererings- og kontrollflyten og hvordan forslag lagres i fagmodulene.

Prosess	For hvem
Bruke KAI-planlegger	Leder + Administrator
Generere statusrapport	Leder
Lage sjekkliste med KAI	Administrator + HMS-koordinator
Lage arbeidsflyt med KAI	Administrator

Slik bruker du KAI auto-registrering av timer¶

Ruten /time/kai-chat (komponent KaiAutoRegisterChatComponent) krever at brukeren har CanCreate på KAI.Time — komponenten henter tillatelser via KaiChatSessionService.getMyPermissions() og setter hasKAIAccess = perms.time?.canCreate (kai-auto-register-chat.component.ts:27-31).

Gå til Time → KAI-chat i menyen (eller åpne /time/kai-chat direkte).
Skriv en kort beskrivelse i chat-feltet, f.eks. "4 timer på Acme-prosjektet i går — rørlegging på badet".
KAI henter historikk fra siste 30 dager som kontekst og foreslår én eller flere timelinjer.
Kontrollér forslaget (prosjekt, lønnsart, kommentar, dato) før du bekrefter.
Bekrefter du, lagres timene som vanlige timeregistreringer.

Relaterte innstillinger¶

Konfigurasjon ligger under Innstillinger → KAI:

KAI-innstillinger — hovedbryter og generell konfigurasjon (Master-prompts)
KAI-regler — modulspesifikke regler og terskler
KAI-bruk — bruk-statistikk og kostnad
KAI ML-oppdaging — automatisk avvikssøking

Vanlige problemer¶

Problem	Sannsynlig årsak	Tiltak
KAI-chat viser "ingen tilgang" eller skjuler input-feltet	Brukerens nivå har ikke `CanCreate` på `KAI.Time`	Administrator må aktivere `KAI.Time` med riktig scope under Datatilgang.
KAI-funksjon i annen modul mangler	Tilhørende `KAI.*`-objekttype er ikke aktivert for brukernivået	Skru på `KAI.Project` / `KAI.HMS` / `KAI.Checklist` osv. på brukernivået.
Bankavstemming-KAI svarer ikke	Krever både `KAI.Accounting` OG aktiv NXT-integrasjon	Sjekk integrasjon for Live Regnskap; sjekk at brukernivået har `CanView` på `KAI.Accounting`.

For flere KAI-spesifikke feilsituasjoner, se feilsøking for KAI-modulen.

Relaterte sider¶

Datatilgang — RBAC for KAI og andre objekttyper
Prosjekt-modulen — KAI-planlegger og statusrapport
HMS-modulen — KAI sjekkliste-generator og avviks-analyse
Time-modulen — KAI auto-registrering og Action Mode
Bankavstemming-modulen — KAI for matching og Live Regnskap
Arbeidsflyter — KAI arbeidsflyt-generator