Verbind AI-agents met je Docs-sites
Laat Claude Code, Codex, ChatGPT of je eigen scripts pagina's voor Docs-sites opstellen, organiseren en publiceren. Abonnementen (Pro en hoger), de rechten voor Docs-sites, site-scoping en publicatieregels, met links naar de volledige handleidingen voor AI-agents & API.
AI-agents zoals Claude Code, Codex, Cursor, Claude of ChatGPT kunnen je Docs-sites voor je lezen en schrijven: artikelen opstellen, pagina's corrigeren die lezers laag beoordelen, inhoudelijke hiaten opvullen, vertalen of publiceren. Dit artikel behandelt wat specifiek is voor Docs-sites. Tokens, connectors, verbruik en fouten worden uitgelegd in AI-agents & API.
Voordat je begint
- AI-agents & API is beschikbaar in de Pro-, Zakelijk- en Aangepast-abonnementen, inclusief connectors voor Claude en ChatGPT. Gratis en Starter bevatten dit niet; tokens en apps stoppen met werken als een werkruimte naar een van deze abonnementen wordt verplaatst.
- Een agent handelt als de persoon die het token heeft aangemaakt of verbonden, binnen de rol van die persoon. Het kan op een site nooit meer doen dan die persoon zelf zou kunnen.
- API-aanroepen kosten geen credits. Het vertalen van pagina's en het genereren van sitepagina's met AI kost wel credits, en alleen met een token dat deze mag uitgeven.
Een agent verbinden
Open het werkruimtemenu en kies AI-agents & API, of kies AI-agents & API in het menu Instellingen van een Docs-site (dit opent de activiteit voor die site).
- API-token voor Claude Code, Codex, Cursor of een script: Tokens → Nieuw token, gevolgd door een wizard in vier stappen (Doel, Rechten, Limieten, Beoordelen). Kies een preset voor Docs-sites zoals Schrijver of Publicatiebeheer, kies de sites onder Limieten → Docs-sites en kopieer het token, dat slechts één keer wordt getoond. Zie Een API-token aanmaken.
- Connector voor Claude.ai of ChatGPT: plak de Connector-URL uit Verbonden apps in de app, meld je aan en kies de Sites en Toegang. Zie AI-apps en agents verbinden.
Presets voor Docs-sites
| Preset | Beschrijving op scherm | Voor |
|---|---|---|
| Schrijver | "Agents stellen op; een persoon beoordeelt en publiceert." | Artikelen en changelog-items opstellen, afbeeldingen uploaden |
| Publicatiebeheer | "Vertrouwde automatisering die kan wijzigen wat lezers zien." | Alles voor Docs-sites, inclusief publiceren, instellingen en sites aanmaken |
| Support-assistent | "Antwoorden uit gepubliceerde docs. Niets anders." | Een help-bot die alleen gepubliceerde, openbare pagina's doorzoekt |
| Alleen-lezen | "Onderzoek, audits en vertaalcontroles." | Inhoud lezen |
| Analist | "Leest inhoud en lezerssignalen om correcties voor te stellen." | Inhoud en inzichten lezen |
Producent en Werkruimte-agent voegen video's toe en verbruiken credits. Elke toestemming en wie deze kan verlenen: Agent-rechten.
Rechten voor Docs-sites
| Recht | Staat toe |
|---|---|
content:read |
Sites, pagina's, artikelen (ook concepten), revisies, de changelog en sitepagina's lezen |
articles:write |
Conceptartikelen aanmaken en artikelen bewerken die niet live zijn |
structure:write |
Secties aanmaken en bewerken; pagina's verplaatsen, verbergen en hernoemen |
site-pages:write |
Sitepagina's bewerken zoals home, contact en juridisch |
changelog:write |
Changelog-items aanmaken en bewerken als concept |
media:write |
Afbeeldingen uploaden |
site:publish |
Publiceren: wijzigen wat lezers zien, live inhoud bewerken, pagina's als gereed markeren |
insights:read |
Zoekhiaten, onbeantwoorde vragen en paginaterugkoppeling lezen |
site:configure |
Site-instellingen, uiterlijk en navigatie wijzigen |
sites:create |
Nieuwe Docs-sites aanmaken |
help:read |
Alleen gepubliceerde, openbare pagina's doorzoeken (voor een support-assistent) |
Lezen is open voor elk lid. Schrijven en organiseren: eigenaar, beheerders, editors en Content Creators. Publiceren en site-instellingen: eigenaar, beheerders en editors ("Alleen eigenaren, beheerders en editors kunnen publicatierechten verlenen."). Sites aanmaken: eigenaar en beheerders.
Welke sites een token dekt
Kies onder Limieten → Docs-sites voor Alle sites ("Elke Docs-site in deze werkruimte, inclusief nieuwe.") of Gekozen sites. Een token of verbonden app ziet en wijzigt alleen de sites die eronder vallen. Als een artikel ook op een site buiten het bereik verschijnt, wordt de wijziging geweigerd: "Dit artikel wordt ook getoond op een site die dit token niet kan wijzigen."
Live inhoud vereist publicatierechten
Zonder site:publish kan een agent niet wijzigen wat lezers zien. Het bewerken van een live artikel wordt geweigerd ("Deze inhoud is live op een gepubliceerde site, dus voor het wijzigen is de site:publish-mogelijkheid vereist."), en de agent kan het concept in plaats daarvan ter beoordeling indienen. Je ontvangt een melding, "agent vroeg om beoordeling van pagina op site": "Er is niets gepubliceerd. Lees het artikel en publiceer het wanneer het gereed is."
Elke wijziging die een agent maakt, wordt in de geschiedenis van de pagina getoond als "Agent naam (token)". Publicaties zijn beperkt tot 10 per uur per token. Een gepauzeerde site is alleen-lezen voor agents: "Deze site is gepauzeerd of offline en alleen-lezen."
Wat agents op een site kunnen doen
Sites weergeven en de paginastructuur lezen, pagina's zoeken en lezen, Markdown bekijken, artikelen aanmaken en bijwerken, ze ter beoordeling indienen, secties en pagina's organiseren, sitepagina's en de changelog bewerken, afbeeldingen uploaden, inzichten lezen en hiaten als opgelost markeren, instellingen, uiterlijk, navigatie en redirects wijzigen, sites aanmaken, pagina's vertalen, sitepagina's genereren, publiceren en terugdraaien. Elk vereist het bijbehorende recht.