Handleiding › Skills en regels
Wat er in de basis zit
Elk Canoniek AI-systeem begint met een basis: een core, documenten en skills. Een deel richten wij in en houden wij bij; dat is in elk Canoniek AI-systeem gelijk, en je hoeft er niets mee. Een ander deel gaat over jouw werk en je kantoor; dat vullen we bij de start samen met jou in, en dat lees je na. Je eigen skills komen daar bij terwijl je met je agenten werkt. Wat het verschil is tussen een core, een document en een skill, lees je in Je core, je documenten en je skills.
Wat wij inrichten en bijhouden
Het gedeelde deel van je core. Hoe een agent denkt en werkt, wat hij jou eerst vraagt en wat hij zelf afhandelt. Het komt uit onze blauwdruk, en wij werken het bij elke update bij.
De technische documenten. Welke machines er zijn en hoe ze heten, wat er draait, hoe er aan je AI-systeem gebouwd wordt, hoe een correctie bij Rules komt, hoe een agent je iets laat zien, en welke versie van de core er draait. Wij vullen ze in, en daarna houdt je System-agent ze bij.
Zes skills. Ze beschrijven onze manier van werken.
- Een verzoek afhandelen. De stappen van een binnengekomen bericht naar een concept-mail: plaatsen, uitzoeken, wegen of er iets uit moet, opstellen en vastleggen. Zo werkt elke agent in dezelfde volgorde.
- Compacten. Hoe een agent alles vastlegt en voor zichzelf opschrijft waar hij was, voordat zijn gesprek wordt gecompact. Zo pakt hij daarna zijn draad weer op; hoe dat gaat, staat in Het contextvenster en compacten.
- Onderzoek. Hoe een agent uitzoekt wat niet in je eigen materiaal staat, onder meer met Google Deep Research, en aangeeft hoe zeker het antwoord is. Zo zie je bij elk antwoord waarop het rust.
- Bouwen. Hoe je System-agent bouwwerk uitzet en keurt, en hoe hij bewijst dat het werkt. Zo meldt een agent pas "het werkt nu" als hij het gemeten heeft.
- Regels. Hoe Rules van een doorgegeven correctie een regel maakt, en in welk rulebook die hoort. Zo schrijft alleen Rules in de rulebooks, en blijven de regels met elkaar in lijn.
- Sleutels en wachtwoorden. Hoe agenten omgaan met sleutels, wachtwoorden en logins: die komen uit je kluis, en een agent schrijft ze nergens op. Heeft een pakket dat jij gebruikt een eigen manier van inloggen, dan zetten we dat erbij.
Wat we bij de start samen met jou invullen
Dit gaat over jouw werk. Wij stellen het op, en jij leest het na en zegt wat er anders moet, want een agent werkt met wat erin staat. Je krijgt het vóór de installatie in één document; zie Wat we vóór de installatie voor je opstellen.
Je eigen deel van je core. Wat je werk is, wie er om je heen werken en waar je dossiers staan. Het komt uit je use cases en je intake. Na de installatie is het van jou: een wijziging spreek je door met je System-agent, en grotere wijzigingen nemen we mee in het wekelijkse uur.
Vier documenten. De mensen om je heen, de indeling van je mappen, je use cases en je intake, en wat is afgewezen. Na de installatie houdt je System-agent ze bij, bijvoorbeeld bij een nieuwe collega of een nieuwe map.
Vier skills.
- Waar je gegevens staan. In welke volgorde een agent zoekt, en wat hij doet als hij iets niet vindt. Waar je gegevens staan en hoe de map van een klant eruitziet, spreken we bij de start af, het liefst met voor elke klant dezelfde mappen, zoals intake, offertes en onderhanden werk; die indeling staat in een eigen document, dat je vóór de installatie naleest. Dan weet een agent waar hij zijn werk neerzet: een offerte komt in de map waar jij offertes altijd bewaart.
- Vastleggen. Hoe een agent vastlegt wat er gebeurd is, in het dossier en in de chronologie. Zo vinden je andere agenten het terug, en de agent zelf ook nadat zijn gesprek is gecompact. Zijn administratie houdt hij bij in een map _ai-state, in de map van de klant of het project; welke map dat is, volgt uit de indeling die we bij de start afspreken.
- Schrijven. Hoe je agenten schrijven, per ontvanger, ook in een bericht aan jou. Zo past elk bericht in toon en vorm bij de ontvanger. Wij doen een voorstel; jij leest het, en zegt waar het anders moet.
- Je vakkennis. Hoe het in jouw branche in Nederland werkt, en wat een agent van jou moet weten. Zo werkt een agent met de feiten van jouw vak in plaats van met wat een algemeen model erover denkt. Wij draaien er een Deep Research voor en stellen de skill op. Lees hem en stuur bij: staat er iets verkeerds in, dan neemt een agent dat over.
Bij elke skill hoort een rulebook. Bij de start staan er al regels in, behalve bij Onderzoek, Waar je gegevens staan en Je vakkennis; daarna groeit elk rulebook met de regels die je laat vastleggen.