Handleiding › Zo werkt het

Termen

Elke term in deze handleiding betekent één ding, voor jou en voor je agenten. Hieronder staan ze op alfabet.

Actiepunten

De lijst op je server met wat er nog moet gebeuren, met bij elk punt bij wie het ligt en waar het vandaan komt.

Agent

Een AI-medewerker. Een agent doet het werk voor een of meer dossiers, of vervult één bepaalde functie, zoals finance of HR. Ook de System-agent, Rules, Fable en de bouwers zijn agenten. Dat zijn de vier vaste agenten in elk Canoniek AI-systeem.

AI-systeem

Je server met je agenten, de Canoniek-app, je koppelingen, je dossiers, je repo en je kluis: eigenlijk alles bij elkaar.

Basis

Wat wij in elk Canoniek AI-systeem installeren: de vier vaste agenten, de manier van werken die voor iedereen gelijk is, en de kloktaken, hooks en gates. Verbeteringen aan de basis brengen wij. Je System-agent beheert hem; wijkt hij er sterk van af, dan laat hij het ons weten. De core zetten wij bij de installatie neer, maar die is van jou.

Beurt

Wat een agent doet tussen jouw bericht en zijn antwoord.

Blauwdruk

De beschrijving en de code waaruit wij elk Canoniek AI-systeem opbouwen. Ze staan in onze repo op GitHub, waar je leestoegang toe krijgt.

Bouwers

Agenten die de System-agent inzet om iets te bouwen, en die daarna weer stoppen. Je praat niet met ze, maar je kunt hun werk wel controleren.

Canoniek

Canoniek, dat zijn wij. Wij installeren je AI-systeem, zorgen dat alles netjes blijft en dat het doet wat het moet doen, en dat jij ermee leert werken.

Canoniek-app

De app voor iPhone en Mac waarin je met je agenten praat, en live ziet wat ze doen.

Chronologie

De lijst op je server waarin je agenten elke afgeronde handeling vastleggen, met de klant, de agent en waar het resultaat staat.

Compacten

Wat er gebeurt als het gesprek van een agent vol raakt: het wordt samengevat en leeggemaakt, en de agent gaat verder. Vlak daarvoor legt hij vast waar hij was.

Contextvenster

Wat een agent op één moment in zijn gesprek kan hebben, zijn werkgeheugen. Raakt het vol, dan wordt het gesprek gecompact.

Core

Een set basisregels voor al je agenten. Elke agent leest de core bij elke start. Er staat in hoe hij denkt en werkt. De core is van jou: een wijziging spreek je door met je System-agent. De wijziging komt in je eigen deel van de core; het deel uit de blauwdruk werken wij bij, en je eigen deel blijft dan staan.

Dossier

Een klant of een project waarvoor op elk moment één agent verantwoordelijk is. Het werk aan een dossier staat in één map op je Drive.

Drive

Google Drive, of OneDrive als je met Microsoft 365 werkt. Daar staan je dossiers.

Fable

De agent die het werk van je agenten tegenleest als jij daarom vraagt. Hij draait op een ander model dan je andere agenten, zodat hij andere fouten ziet. Hij beslist zelf niets.

Gate

Een kloktaak die controleert of een onderdeel werkt, en jou of je System-agent een melding geeft als er iets mis is.

Hook

Een controle op een vast punt in het werk van een agent. Een hook geeft de agent informatie, of houdt hem tegen, bijvoorbeeld tot hij de communicatie-skill heeft gelezen.

Kloktaak

Een taak die vanzelf draait, op een vast tijdstip of in een vast ritme. Alle kloktaken samen heten de klok.

Kluis

1Password, waar de wachtwoorden en sleutels staan die je agenten gebruiken, zoals de toegang tot je mail en je agenda.

Koppeling

De verbinding tussen een agent en een tool of softwarepakket dat je veel gebruikt, zoals je boekhoudpakket of je planningstool. Technisch is het een MCP- of API-verbinding.

Model

Het AI-model waarop een agent draait, zoals Claude Opus. Welk model elke agent gebruikt, staat ingesteld op je server.

Repo

De bestanden van je AI-systeem op GitHub, in je eigen account. Daar staan de code, de core, de skills en rulebooks van je agenten, en de technische documentatie. Je dossiers en je sleutels staan er niet in.

Rulebook

Het boek met regels dat bij een skill hoort. Er komt een regel bij als jij daar uitdrukkelijk om vraagt, of als je laat merken dat je echt boos bent over een fout.

Rules

De agent die als enige de regels in de rulebooks schrijft. Een regel geef je aan de agent met wie je werkt, op het moment dat hij een fout maakt en jij hem corrigeert. Die agent geeft hem door aan Rules.

Server

Een Mac met minimaal 32 GB geheugen, die dag en nacht aan staat. Wij richten hem in als server, en daarop werken je agenten. Je werkt er zelf niet op.

Skill

Vastgelegd hoe een agent een taak uitvoert, met de stappen, de tools en een voorbeeld. Een skill is er voor al je agenten.

System-agent

Een van de vier vaste agenten. De System-agent beheert je AI-systeem en laat bouwen wat er nodig is. Je praat vooral met je System-agent en met je eigen klantagenten.

Tailscale

Het privénetwerk van Canoniek, waarin je server, je laptop en je telefoon zitten. De toegangsregels zorgen dat alleen jouw apparaten en wij bij je server kunnen.

TestFlight

De app van Apple waarmee je een app installeert die niet in de App Store staat. Zo komt de Canoniek-app op je iPhone en je Mac.

Transcripten

De uitgeschreven tekst van gesprekken die je opneemt met Plaud, een kleine recorder die wij aanraden. Je neemt er gesprekken mee op, op locatie en online.

Verdeler

Het programma dat je binnenkomende berichten verdeelt. Hij geeft de agent bij wie een mail, een appje of een transcript hoort een kopie, volgens de regels die je System-agent invoert. Alles blijft in je inbox en in WhatsApp staan, zoals nu.