Scegli le autorizzazioni per un agente AI
Ogni autorizzazione che un token API o un'app connessa può avere, cosa consente, quale preimpostazione la include e quali ruoli (proprietario, amministratore, editor, Content Creator) possono concederla.
Ogni token API e app connessa possiede un set di autorizzazioni (abilità) che determinano cosa può fare un agente nella tua area di lavoro. Questo articolo elenca ogni autorizzazione, cosa consente, quale preimpostazione la include e quali ruoli possono concederla.
Come funzionano le autorizzazioni
- Un agente agisce come la persona che ha creato il token, entro i limiti consentiti dal ruolo di tale persona. Non può mai fare più di quanto il suo proprietario potrebbe fare nell'app e vede solo le registrazioni, i video e le raccolte che il suo proprietario può vedere.
- Il tuo ruolo decide cosa puoi concedere. Nella procedura guidata dei token e nella schermata di connessione, un'autorizzazione che il tuo ruolo non può concedere è disattivata con "Il tuo ruolo non può concedere questo." (o "Solo proprietari, amministratori ed editor possono concedere la pubblicazione." per la pubblicazione). Una preimpostazione che ne contiene una è disattivata con "Il tuo ruolo non può concedere ogni abilità in questa preimpostazione."
- Il ruolo viene verificato a ogni chiamata, non solo quando viene creato il token. Se il ruolo del proprietario cambia in seguito, le chiamate che richiedono un'autorizzazione non consentita dal nuovo ruolo vengono rifiutate e il token mostra Supera il ruolo nell'elenco dei token: "Il ruolo del proprietario è cambiato. Le chiamate che richiedono le abilità barrate vengono rifiutate."
- Ogni autorizzazione ha un tipo, mostrato come un badge nella procedura guidata: Letto, Modifica, Pubblica, Gestisci o Spende crediti.
- Un agente vede solo gli strumenti (MCP) e gli endpoint (REST) consentiti dalle sue autorizzazioni. Chiamarne uno che non possiede restituisce "Questo token non possiede l'abilità …."
Preimpostazioni
Il primo passaggio della procedura guidata dei token (A cosa serve?) offre delle preimpostazioni. Selezionandone una, le relative autorizzazioni vengono spuntate; puoi modificarne una qualsiasi nel passaggio successivo e la procedura guidata mostrerà quindi Personalizzato con Ripristina a preimpostazione.
| Preimpostazione | Descrizione sullo schermo | Autorizzazioni |
|---|---|---|
| Scrittore | "Gli agenti creano bozze; una persona revisiona e pubblica." | content:read, articles:write, changelog:write, media:write |
| Editore | "Automazione affidabile che può modificare ciò che vedono i lettori." | Ogni autorizzazione dei siti di documentazione eccetto help:read e insights:read |
| Assistente al supporto | "Risposte da documenti pubblicati. Nient'altro." | help:read |
| Sola lettura | "Ricerca, audit e controlli di traduzione." | content:read |
| Analista | "Legge contenuti e segnali dei lettori per suggerire correzioni." | content:read, insights:read |
| Produttore | "Crea bozze di contenuti e avvia lavori a pagamento entro i limiti di spesa." | Scrittore, più site-pages:write, library:read, videos:create, videos:export, materials:write, credits:spend, jobs:read |
| Agente dell'area di lavoro | "Tutto ciò che un agente può fare in quest'area di lavoro, entro i limiti di spesa." | Ogni autorizzazione eccetto help:read |
Produttore e Agente dell'area di lavoro includono credits:spend, quindi la procedura guidata richiede i limiti di spesa nel passaggio Limiti. Vedi Controlla la spesa e le approvazioni dell'agente.
Le preimpostazioni Scrittore, Editore, Assistente al supporto, Sola lettura e Analista sono per i siti di documentazione.
Autorizzazioni video
| Autorizzazione | Tipo | Cosa consente |
|---|---|---|
library:read |
Letto | "Leggi registrazioni, video, articoli e trascrizioni che il proprietario può vedere": elenca la libreria e le registrazioni, leggi un elemento, la sua trascrizione e il suo articolo, e ottieni un embed. |
videos:create |
Modifica | "Cita e richiedi video, articoli da registrazioni e traduzioni": richiedi un preventivo e richiedi video tutorial, demo di prodotto, pulizia e video stilizzati da una registrazione, clip social, articoli da una registrazione e traduzioni video. L'avvio di lavori a pagamento richiede anche credits:spend. |
videos:export |
Modifica | "Esporta video e ottieni embed": renderizza un MP4 a 1080p (predefinito), 2K o 4K, sempre a 60 fps, e ottieni un link per il download. Le esportazioni non costano crediti. |
materials:write |
Modifica | "Aggiungi immagini, video e PDF ai caricamenti dell'area di lavoro utilizzati per i nuovi video". |
Autorizzazioni dell'area di lavoro
| Autorizzazione | Tipo | Cosa consente |
|---|---|---|
credits:spend |
Spende crediti | "Spendi crediti su lavori preventivati, entro i limiti del token". È la seconda chiave necessaria per ogni avvio a pagamento, oltre all'autorizzazione per quel lavoro (ad esempio videos:create). |
jobs:read |
Letto | "Vedi i lavori avviati dagli altri token del proprietario". Un token vede sempre i propri lavori; questo aggiunge i lavori degli altri token del suo proprietario. Consente inoltre all'agente di annullare un lavoro e leggere il saldo dei crediti dell'area di lavoro. |
Autorizzazioni documenti
Queste si applicano ai siti di documentazione. Sotto Limiti → Siti di documentazione, un token copre Tutti i siti ("Ogni sito di documentazione in quest'area di lavoro, inclusi quelli nuovi.") o Siti scelti.
| Autorizzazione | Tipo | Cosa consente |
|---|---|---|
content:read |
Letto | "Leggi siti, pagine, articoli (anche bozze), revisioni, changelog e pagine del sito". Anche impostazioni del sito, aspetto, navigazione e reindirizzamenti. |
articles:write |
Modifica | "Crea bozze di articoli e modifica articoli non ancora pubblicati". Tradurre un articolo (a pagamento) richiede anche credits:spend. |
structure:write |
Modifica | "Crea e modifica sezioni, sposta, nascondi e rinomina pagine". |
site-pages:write |
Modifica | "Modifica pagine del sito come home, contatti e legali". Generare o tradurre una pagina del sito con l'AI (a pagamento) richiede anche credits:spend. |
changelog:write |
Modifica | "Crea e modifica voci del changelog come bozze". |
media:write |
Modifica | "Carica immagini". |
site:publish |
Pubblica | "Pubblica: cambia ciò che vedono i lettori, modifica contenuti live, contrassegna pagine come pronte". Anche pubblicare ed eliminare voci del changelog e ripristinare una versione precedente del sito. |
insights:read |
Letto | "Leggi insight del sito: lacune di ricerca, domande senza risposta e feedback sulle pagine". Con articles:write può anche contrassegnare una lacuna come coperta. |
site:configure |
Gestisci | "Cambia impostazioni del sito, aspetto e navigazione", e aggiungi reindirizzamenti. |
sites:create |
Gestisci | "Crea nuovi siti di documentazione". |
help:read |
Letto | "Cerca solo pagine pubbliche pubblicate (assistente al supporto)". Un token con solo questa autorizzazione non vede nient'altro. |
Chi può concedere cosa
| Autorizzazione | Proprietario | Amministratore | Editor | Content Creator |
|---|---|---|---|---|
content:read, help:read, insights:read, jobs:read |
Sì | Sì | Sì | Sì |
library:read |
Sì | Sì | Sì | Sì |
articles:write, structure:write, site-pages:write, changelog:write, media:write |
Sì | Sì | Sì | Sì |
videos:export |
Sì | Sì | Sì | Sì |
videos:create, materials:write, credits:spend |
Sì | Sì | No | Sì |
site:publish, site:configure |
Sì | Sì | Sì | No |
sites:create |
Sì | Sì | No | No |
Un Content Creator può assegnare a un token credits:spend, ma i lavori a pagamento che richiedono approvazione vengono sempre approvati dal proprietario dell'area di lavoro o da un amministratore, mai dal solo proprietario del token. Vedi Controlla la spesa e le approvazioni dell'agente.
Non ancora disponibile per gli agenti
Gli agenti non possono ancora eseguire ricerche su siti web o walkthrough registrati, né pubblicare video su altre piattaforme. Tali autorizzazioni non possono essere concesse.