Välj behörigheter för en AI-agent
Varje behörighet som en API-nyckel eller ansluten app kan ha, vad den tillåter, vilken förinställning som inkluderar den, och vilka roller (ägare, administratör, redaktör, innehållsskapare) som kan bevilja den.
Varje API-nyckel och ansluten app har en uppsättning behörigheter (förmågor) som avgör vad en agent får göra i din arbetsyta. Den här artikeln listar varje behörighet, vad den tillåter, vilken förinställning som inkluderar den och vilka roller som kan bevilja den.
Hur behörigheter fungerar
- En agent agerar som den person som skapade nyckeln, inom ramen för vad personens roll tillåter. Den kan aldrig göra mer än vad dess ägare kan göra i appen, och den ser bara de inspelningar, videor och samlingar som dess ägare kan se.
- Din roll avgör vad du kan bevilja. I nyckelguiden och på anslutningsskärmen är en behörighet som din roll inte kan bevilja gråmarkerad med "Din roll kan inte bevilja detta." (eller "Endast ägare, administratörer och redaktörer kan bevilja publicering." för publicering). En förinställning som innehåller en av dem är gråmarkerad med "Din roll kan inte bevilja alla förmågor i denna förinställning."
- Rollen kontrolleras vid varje anrop, inte bara när nyckeln skapas. Om ägarens roll ändras senare nekas anrop som kräver en behörighet som den nya rollen inte tillåter, och nyckeln visar Överskrider roll i nyckellistan: "Ägarens roll ändrades. Anrop som kräver de överstrukna förmågorna nekas."
- Varje behörighet har en typ, som visas som en bricka i guiden: Läs, Redigera, Publicera, Hantera eller Använder krediter.
- En agent ser bara de verktyg (MCP) och slutpunkter (REST) som dess behörigheter tillåter. Att anropa en som den saknar returnerar "Denna nyckel saknar förmågan …"
Förinställningar
Det första steget i nyckelguiden (Vad är syftet?) erbjuder förinställningar. Att välja en markerar dess behörigheter; du kan ändra vilken som helst av dem i nästa steg, och guiden visar då Anpassad med Återställ till förinställning.
| Förinställning | Beskrivning på skärmen | Behörigheter |
|---|---|---|
| Skribent | "Agenter utkast; en person granskar och publicerar." | content:read, articles:write, changelog:write, media:write |
| Publicerare | "Betrodd automatisering som kan ändra vad läsare ser." | Varje behörighet för dokumentsajter utom help:read och insights:read |
| Supportassistent | "Svar från publicerade dokument. Inget annat." | help:read |
| Skrivskyddad | "Forskning, revisioner och översättningskontroller." | content:read |
| Analytiker | "Läser innehåll och läsarsignaler för att föreslå förbättringar." | content:read, insights:read |
| Producent | "Skriver utkast till innehåll och startar betalt arbete inom utgiftsgränser." | Skribent, plus site-pages:write, library:read, videos:create, videos:export, materials:write, credits:spend, jobs:read |
| Arbetsyteagent | "Allt en agent kan göra i denna arbetsyta, inom utgiftsgränser." | Varje behörighet utom help:read |
Producent och Arbetsyteagent inkluderar credits:spend, så guiden frågar efter utgiftsgränser i steget Gränser. Se Kontrollera agentutgifter och godkännanden.
Förinställningarna Skribent, Publicerare, Supportassistent, Skrivskyddad och Analytiker är till för dokumentsajter.
Behörigheter för videor
| Behörighet | Typ | Vad den tillåter |
|---|---|---|
library:read |
Läs | "Läs inspelningar, videor, artiklar och transkriberingar som ägaren kan se": lista biblioteket och inspelningar, läs ett objekt, dess transkribering och dess artikel, samt hämta en inbäddning. |
videos:create |
Redigera | "Citera och begär videor, artiklar från inspelningar och översättningar": be om ett citat och begär instruktionsvideor, produktdemonstrationer, städade och stylade videor från en inspelning, sociala klipp, artiklar från en inspelning och videoöversättningar. Att starta betalt arbete kräver även credits:spend. |
videos:export |
Redigera | "Exportera videor och hämta inbäddningar": rendera en MP4 i 1080p (standard), 2K eller 4K, alltid 60 fps, och hämta en nedladdningslänk. Export kostar inga krediter. |
materials:write |
Redigera | "Lägg till bilder, videor och PDF-filer till arbetsytans uppladdningar som används för nya videor". |
Behörigheter för arbetsytan
| Behörighet | Typ | Vad den tillåter |
|---|---|---|
credits:spend |
Använder krediter | "Använd krediter för citerat arbete, inom nyckelns gränser". Det är den andra nyckeln som varje betald start kräver, utöver behörigheten för det arbetet (till exempel videos:create). |
jobs:read |
Läs | "Se jobb startade av ägarens andra nycklar". En nyckel ser alltid sina egna jobb; detta lägger till jobben från ägarens andra nycklar. Låter även agenten avbryta ett jobb och läsa arbetsytans kreditsaldo. |
Behörigheter för dokument
Dessa gäller för dokumentsajter. Under Gränser → Dokumentsajter täcker en nyckel Alla webbplatser ("Varje dokumentsajt i denna arbetsyta, inklusive nya.") eller Valda webbplatser.
| Behörighet | Typ | Vad den tillåter |
|---|---|---|
content:read |
Läs | "Läs webbplatser, sidor, artiklar (även utkast), ändringsloggar och webbplatssidor". Även webbplatsinställningar, utseende, navigering och omdirigeringar. |
articles:write |
Redigera | "Skapa utkast till artiklar och redigera artiklar som inte är publicerade". Att översätta en artikel (betald) kräver även credits:spend. |
structure:write |
Redigera | "Skapa och redigera sektioner, flytta, dölja och byta namn på sidor". |
site-pages:write |
Redigera | "Redigera webbplatssidor som hem, kontakt och juridisk information". Att generera eller översätta en webbplatssida med AI (betald) kräver även credits:spend. |
changelog:write |
Redigera | "Skapa och redigera ändringsloggposter som utkast". |
media:write |
Redigera | "Ladda upp bilder". |
site:publish |
Publicera | "Publicera: ändra vad läsare ser, redigera live-innehåll, markera sidor som klara". Även publicering och radering av ändringsloggposter och återställning av en webbplats. |
insights:read |
Läs | "Läs webbplatsinsikter: sökglapp, obesvarade frågor och sidfeedback". Med articles:write kan den även markera ett glapp som täckt. |
site:configure |
Hantera | "Ändra webbplatsinställningar, utseende och navigering", samt lägga till omdirigeringar. |
sites:create |
Hantera | "Skapa nya dokumentsajter". |
help:read |
Läs | "Sök endast i publicerade, offentliga sidor (supportassistent)". En nyckel med endast denna behörighet ser inget annat. |
Vem kan bevilja vad
| Behörighet | Ägare | Administratör | Redaktör | Innehållsskapare |
|---|---|---|---|---|
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 | Nej | Ja |
site:publish, site:configure |
Ja | Ja | Ja | Nej |
sites:create |
Ja | Ja | Nej | Nej |
En innehållsskapare kan ge en nyckel credits:spend, men betalt arbete som kräver godkännande godkänns alltid av arbetsytans ägare eller en administratör, aldrig av nyckelns ägare ensam. Se Kontrollera agentutgifter och godkännanden.
Inte tillgängligt för agenter än
Agenter kan ännu inte köra webbplatsforskning eller inspelade genomgångar, eller publicera videor till andra plattformar. Dessa behörigheter kan inte beviljas.