Je tools koppelen
Notion koppelen aan een AI-agent
Een bedrijfswiki sterft bijna nooit doordat hij slecht geschreven is. Hij sterft doordat hij nooit meer gelezen wordt. De procedures staan nog op de versie van twee jaar geleden, de klantenbasis houdt regels aan die niet meer bestaan, en na een tijd durft niemand er nog op te vertrouwen. De Notion-koppeling geeft een agent het lezen van de pagina's en het bijwerken van de databases — wat het probleem verschuift van de dag van het schrijven naar de zesde maand, waar het zich werkelijk afspeelt.
1. Wat de agent in Notion doet
De koppeling loopt via de officiële server van Notion, met twee rechten en niet één meer: de inhoud lezen en hem bijwerken. Concreet:
- Een pagina lezen om nauwkeurig te antwoorden. Een agent die een klant een procedure moet uitleggen, gaat die halen waar ze geschreven staat, in plaats van haar uit een taalmodel te verzinnen. Dat is het verschil tussen een aannemelijk en een waar antwoord.
- Een pagina bijwerken wanneer de werkelijkheid veranderd is. Een herzien tarief, een termijn die verschuift, een geschrapte stap: de correctie gebeurt waar de procedure leeft, niet in een bericht dat verloren zal gaan.
- Een database voeden. Een regel aan een overzicht toevoegen, een leeg gebleven eigenschap invullen, twee vermeldingen die over hetzelfde gaan samenbrengen.
Wat de koppeling niet doet: ze raakt noch de instellingen van de werkruimte, noch de rechten, noch de facturering van Notion aan. Ze werkt in de inhoud, niet in het beheer.
2. Het dubbele delen, eigen aan Notion
Dit is de eigenaardigheid die men moet begrijpen voor men wat dan ook koppelt: bij Notion wordt het bereik op twee plaatsen bepaald, en beide tellen.
Eerst aan Notion-zijde. Een integratie ziet een werkruimte niet omdat ze eraan gekoppeld is — ze ziet de pagina's die haar uitdrukkelijk gedeeld zijn. Een niet-gedeelde pagina is onzichtbaar, ook voor een volkomen gemachtigde integratie. Dat is het gedrag van Notion, het hangt niet van ons af, en het is goed nieuws: de grens houdt aan de kant van de leverancier.
Vervolgens aan nullbot-zijde. De koppeling vraagt drie niveaus te benoemen: de werkruimte, de pagina's, de databases. Een agent werkt alleen aan wat is aangewezen, ook al liet Notion hem meer zien.
Het resultaat is een doorsnede, en dat is de juiste reflex: deel aan Notion-zijde alleen wat agenten werkelijk moeten gebruiken. De hele werkruimte delen „om te zien" komt neer op het opheffen van de eerste van de twee beschermingen. Een Notion-werkruimte bevat vaak wervingsnotities, salaristabellen of niet-aangekondigde projecten — drie zaken die niets te zoeken hebben in de context van een agent, hoe zorgvuldig die ook is.
3. De databases, en waarom ze alles veranderen
Een Notion-pagina is tekst: die bijwerken is een redactionele handeling. Een database is iets anders — het is een structuur, met getypeerde eigenschappen, weergaven en vaak automatiseringen die eraan hangen.
Vandaar twee voorzorgen die zich bij een gewone pagina niet voordoen:
- Een schrijfactie in een database kan iets anders in gang zetten. Als een eigenschap „status" een Notion-automatisering aanstuurt, verstuurt het wijzigen ervan een melding, of verplaatst het de rij naar een andere weergave. De agent ziet dat hij een waarde schrijft; de kettingreactie ziet hij niet.
- Een database wordt tegelijkertijd door mensen gebruikt. Anders dan een privéspreadsheet is een Notion-database vaak de werkweergave van een team. Een correctie terwijl iemand hem raadpleegt is niet dramatisch, maar verdient het navolgbaar te zijn.
Daarom is Notion ingedeeld op het hoogste risiconiveau van de catalogus, en daarom vraagt elke schrijfactie standaard menselijke instemming voor uitvoering. Goede praktijk is die goedkeuring actief te laten op de databases die iets aansturen, en haar hooguit te versoepelen op zuivere documentatiepagina's.
4. Wat er in de tijd verandert
Documentatie is het terrein waar de afstand tussen de eerste dag en de zesde maand het hardst is. Op de eerste dag schrijft iedereen. In de zesde maand leest niemand meer na.
- Week 1. De agenten steunen op wat geschreven staat in plaats van op wat ze veronderstellen. Tegenstrijdigheden komen vanzelf boven: twee pagina's die twee verschillende termijnen geven, worden zichtbaar zodra een agent ermee probeert te antwoorden.
- Maand 3. Correcties gebeuren gaandeweg, wanneer de tegenstrijdigheid opduikt, in plaats van te wachten op een hypothetische „dag van het bijwerken van de documentatie" die nooit komt.
- Jaar 2. De wiki is nog bruikbaar — wat op zichzelf de uitzondering is. Een Notion-werkruimte die twee jaar heeft overleefd zonder een kerkhof te worden is een bezit; de meeste overleven niet.
Er wordt geen becijferde winst beloofd: dat hangt af van de omvang van uw werkruimte, van haar structuur en van het aantal mensen dat erin schrijft.
5. Veelgestelde vragen
Moet men een toepassing aanmaken bij Notion Developers?
Nee. De verbinding gebeurt vanuit uw Notion-account, door een gewone toestemming — u klikt, u kiest de te delen pagina's, en klaar. U hoeft niets aan te maken, noch door Notion te laten goedkeuren.
Kan een agent een pagina verwijderen?
De gevraagde rechten dekken het lezen en bijwerken van inhoud, niet het beheer van de werkruimte. En zoals bij elke schrijfactie vraagt een wijziging standaard menselijke instemming voor uitvoering. Baart het verwijderen van een pagina u zorgen, dan ligt het echte antwoord stroomopwaarts: deel die pagina aan Notion-zijde niet met de integratie.
Kan de inhoud van een Notion-pagina de agent bevelen geven?
Nee. Een gelezen pagina wordt als gegeven behandeld, nooit als opdracht. Dat is een algemene regel van het platform en hier telt hij bijzonder: een bedrijfswiki staat open voor het schrijven door veel mensen, en een zin die in een pagina is geschoven mag geen bevel kunnen worden.
Kunnen er meerdere werkruimtes gekoppeld worden?
Het bereik wordt werkruimte voor werkruimte benoemd. Niets belet er meerdere te koppelen, maar elk wordt apart aangewezen, met eigen pagina's en eigen databases. Er bestaat geen kortere weg „heel Notion" — dat is bewust.
Verder lezen
Lees verder: Google Sheets koppelen, bestuur en budgetten, of alle beschikbare koppelingen.