# Skills en kennis in lagen Een AI-agent is zo goed als wat hij over jouw werk weet. Hoe heten jullie tabellen? Welke definitie van "actieve klant" geldt? Welke conventies hebben jullie voor views en procedures? In Plainwater AI leg je dat één keer vast, en elke agent van elke collega werkt ermee. ## Skills en kennisdocumenten - Een **skill** is een werkinstructie: hoe je iets aanpakt. Bijvoorbeeld "zo schrijven wij een laadprocedure", "zo controleer je een nieuwe bron", "zo ziet een goed dashboard eruit". - Een **kennisdocument** is achtergrond: wat iets is. Bijvoorbeeld een datawoordenboek, een architectuurbeschrijving of de afspraken met een klant. Kennisdocumenten kun je schrijven in de webapp of importeren uit Word, Excel of PDF. Het platform haalt de tekst eruit. ## De lagen Skills en kennis stapelen in lagen, van breed naar specifiek: 1. **Platform** — wat voor iedereen geldt. 2. **Klantprofiel** — wat geldt voor een soort klant, bijvoorbeeld "woningcorporatie" of "groothandel". 3. **Klant** — wat geldt voor deze ene klant. 4. **Opdracht** — wat alleen voor dit werk geldt. Bij de start van een opdracht telt het platform alles op. Komt dezelfde skill op twee lagen voor, dan wint de fijnste laag. Een klant kan dus een platformskill overschrijven met een eigen versie, en een opdracht kan dat weer doen. :::accent Vastgelegd wat er meeging Bij elke start legt het platform vast welke skills en documenten meegingen: de naam, de versie en de herkomst. Zo kun je achteraf zien waarom een agent iets op een bepaalde manier deed. ::: ## Versies Skills en kennisdocumenten hebben versies. Een nieuwe versie overschrijft de oude niet; beide blijven bewaard. Een opdracht gebruikt de nieuwste gepubliceerde versie op het moment dat hij start. ## Een agent kan zelf een skill voorstellen Ontdekt een agent tijdens zijn werk iets dat de volgende keer handig is, bijvoorbeeld een conventie die nergens beschreven stond, dan kan hij een skill voorstellen. Een mens leest het voorstel en keurt het goed of af. Pas na goedkeuring gaat de skill mee in volgende opdrachten. ## Namen in kennisdocumenten Ook in kennisdocumenten staan tabel- en kolomnamen. Die gaan, net als elders, als pseudoniem naar het model. Zie [Pseudonimisering](/concepten/pseudonimisering). ## Wie mag wat | Laag | Toekennen | | --- | --- | | Platform en klantprofiel | beheer van de catalogus | | Klant | beheer van de klant | | Opdracht | bewerken van de opdracht | Op elke laag zie je ook wat er van hogere lagen wordt geërfd. ## Voorbeeld Een team van vier consultants werkt voor drie woningcorporaties. - Op het **platform** staat een skill "zo controleer je een nieuwe bron". - Op het **klantprofiel** "woningcorporatie" staat een kennisdocument met de gangbare begrippen: verhuureenheid, complex, mutatie. - Bij **één klant** staat een eigen datawoordenboek, en een skill die de platformskill aanvult met de naamgeving van die klant. - In **een opdracht** staat een notitie: "let op, de tabel met contracten is in maart omgebouwd". Elke consultant die voor die klant een opdracht start, krijgt precies dezelfde stapel mee. ## Zie ook - [Omgevingen en het landschap](/concepten/omgevingen) - [Aan de slag](/aan-de-slag)