Kies machtigingen voor een AI-agent
Elke machtiging die een API-token of verbonden app kan hebben, wat deze toestaat, welke voorinstelling deze bevat en welke rollen (eigenaar, beheerder, redacteur, Content Creator) deze kunnen verlenen.
Elk API-token en elke verbonden app beschikt over een set machtigingen (mogelijkheden) die bepalen wat een agent in je werkruimte mag doen. Dit artikel somt elke machtiging op, wat deze toestaat, welke voorinstelling deze bevat en welke rollen deze kunnen verlenen.
Hoe machtigingen werken
- Een agent handelt als de persoon die het token heeft gemaakt, binnen de grenzen van wat de rol van die persoon toestaat. Het kan nooit meer doen dan de eigenaar in de app zou kunnen, en het ziet alleen de opnames, video's en collecties die de eigenaar kan zien.
- Jouw rol bepaalt wat je kunt verlenen. In de token-wizard en op het verbindingsscherm is een machtiging die jouw rol niet kan verlenen grijs weergegeven met "Jouw rol kan dit niet verlenen." (of "Alleen eigenaren, beheerders en redacteurs kunnen publiceren verlenen." voor publiceren). Een voorinstelling die er een bevat, is grijs weergegeven met "Jouw rol kan niet elke mogelijkheid in deze voorinstelling verlenen."
- De rol wordt bij elke aanroep gecontroleerd, niet alleen wanneer het token wordt gemaakt. Als de rol van de eigenaar later verandert, worden aanroepen die een machtiging vereisen die de nieuwe rol niet toestaat geweigerd, en toont het token Overschrijdt rol in de tokenlijst: "De rol van de eigenaar is gewijzigd. Aanroepen die de doorgehaalde mogelijkheden vereisen, worden geweigerd."
- Elke machtiging heeft een type, weergegeven als een badge in de wizard: Lezen, Bewerken, Publiceren, Beheren of Geeft credits uit.
- Een agent ziet alleen de tools (MCP) en eindpunten (REST) die de machtigingen toestaan. Het aanroepen van een tool of eindpunt waarvoor de machtiging ontbreekt, resulteert in "Dit token mist de … mogelijkheid."
Voorinstellingen
De eerste stap van de token-wizard (Waar is het voor?) biedt voorinstellingen aan. Door er een te kiezen, worden de bijbehorende machtigingen aangevinkt; je kunt ze in de volgende stap wijzigen, waarna de wizard Aangepast toont met Reset naar voorinstelling.
| Voorinstelling | Beschrijving op scherm | Machtigingen |
|---|---|---|
| Schrijver | "Agents maken concepten; een persoon beoordeelt en publiceert." | content:read, articles:write, changelog:write, media:write |
| Publicatiebeheer | "Vertrouwde automatisering die kan wijzigen wat lezers zien." | Elke docs-site machtiging behalve help:read en insights:read |
| Support-assistent | "Antwoorden uit gepubliceerde docs. Niets anders." | help:read |
| Alleen-lezen | "Onderzoek, audits en vertaalcontroles." | content:read |
| Analist | "Leest inhoud en lezerssignalen om verbeteringen voor te stellen." | content:read, insights:read |
| Producent | "Maakt concepten van inhoud en start betaald werk binnen bestedingslimieten." | Schrijver, plus site-pages:write, library:read, videos:create, videos:export, materials:write, credits:spend, jobs:read |
| Werkruimte-agent | "Alles wat een agent in deze werkruimte kan doen, binnen bestedingslimieten." | Elke machtiging behalve help:read |
Producent en Werkruimte-agent bevatten credits:spend, dus de wizard vraagt om bestedingslimieten in de stap Limieten. Zie Bestedingslimieten en goedkeuringen voor agents beheren.
De voorinstellingen Schrijver, Publicatiebeheer, Support-assistent, Alleen-lezen en Analist zijn voor docs-sites.
Videomachtigingen
| Machtiging | Type | Wat het toestaat |
|---|---|---|
library:read |
Lezen | "Lees opnames, video's, artikelen en transcripties die de eigenaar kan zien": de bibliotheek en opnames weergeven, een item, de transcriptie en het artikel lezen, en een embed verkrijgen. |
videos:create |
Bewerken | "Citeer en vraag video's, artikelen van opnames en vertalingen aan": vraag om een citaat en verzoek om instructievideo's, productdemo's, opschoon- en gestileerde video's van een opname, sociale clips, artikelen van een opname en videovertalingen. Voor het starten van betaald werk is ook credits:spend nodig. |
videos:export |
Bewerken | "Exporteer video's en verkrijg embeds": render een MP4 op 1080p (standaard), 2K of 4K, altijd 60 fps, en verkrijg een downloadlink. Exports kosten geen credits. |
materials:write |
Bewerken | "Voeg afbeeldingen, video's en PDF's toe aan de werkruimte-uploads die worden gebruikt voor nieuwe video's". |
Werkruimtemachtigingen
| Machtiging | Type | Wat het toestaat |
|---|---|---|
credits:spend |
Geeft credits uit | "Geef credits uit aan geciteerd werk, binnen de limieten van het token". Dit is de tweede sleutel die elke betaalde start nodig heeft, naast de machtiging voor dat werk (bijvoorbeeld videos:create). |
jobs:read |
Lezen | "Zie taken gestart door andere tokens van de eigenaar". Een token ziet altijd zijn eigen taken; dit voegt de taken van andere tokens van de eigenaar toe. Laat de agent ook een taak annuleren en het creditsaldo van de werkruimte lezen. |
Docs-machtigingen
Deze zijn van toepassing op docs-sites. Onder Limieten → Docs-sites dekt een token Alle sites ("Elke docs-site in deze werkruimte, inclusief nieuwe.") of Gekozen sites.
| Machtiging | Type | Wat het toestaat |
|---|---|---|
content:read |
Lezen | "Lees sites, pagina's, artikelen (ook concepten), revisies, changelog en sitepagina's". Ook site-instellingen, uiterlijk, navigatie en redirects. |
articles:write |
Bewerken | "Maak conceptartikelen en bewerk artikelen die niet live zijn". Voor het vertalen van een artikel (betaald) is ook credits:spend nodig. |
structure:write |
Bewerken | "Maak en bewerk secties, verplaats, verberg en hernoem pagina's". |
site-pages:write |
Bewerken | "Bewerk sitepagina's zoals home, contact en juridisch". Voor het genereren of vertalen van een sitepagina met AI (betaald) is ook credits:spend nodig. |
changelog:write |
Bewerken | "Maak en bewerk changelog-items als concepten". |
media:write |
Bewerken | "Upload afbeeldingen". |
site:publish |
Publiceren | "Publiceren: wijzig wat lezers zien, bewerk live inhoud, markeer pagina's als gereed". Ook het publiceren en verwijderen van changelog-items en het terugdraaien van een site. |
insights:read |
Lezen | "Lees site-inzichten: zoekhiaten, onbeantwoorde vragen en paginaterugkoppeling". Met articles:write kan het ook een hiaat als opgelost markeren. |
site:configure |
Beheren | "Wijzig site-instellingen, uiterlijk en navigatie", en voeg redirects toe. |
sites:create |
Beheren | "Maak nieuwe docs-sites". |
help:read |
Lezen | "Zoek alleen in gepubliceerde, openbare pagina's (support-assistent)". Een token met alleen deze machtiging ziet niets anders. |
Wie kan wat verlenen
| Machtiging | Eigenaar | Beheerder | Redacteur | Content Creator |
|---|---|---|---|---|
content:read, help:read, insights:read, jobs:read |
Ja | Ja | Ja | Ja |
library:read |
Ja | Ja | Ja | Ja |
articles:write, structure:write, site-pages:write, changelog:write, media:write |
Ja | Ja | Ja | Ja |
videos:export |
Ja | Ja | Ja | Ja |
videos:create, materials:write, credits:spend |
Ja | Ja | Nee | Ja |
site:publish, site:configure |
Ja | Ja | Ja | Nee |
sites:create |
Ja | Ja | Nee | Nee |
Een Content Creator kan een token credits:spend geven, maar betaald werk dat goedkeuring vereist, wordt altijd goedgekeurd door de eigenaar van de werkruimte of een beheerder, nooit door de eigenaar van het token alleen. Zie Bestedingslimieten en goedkeuringen voor agents beheren.
Nog niet beschikbaar voor agents
Agents kunnen nog geen website-onderzoek of opgenomen walkthroughs uitvoeren, of video's publiceren naar andere platforms. Die machtigingen kunnen niet worden verleend.