Choisir les autorisations pour un agent IA
Chaque autorisation qu'un jeton API ou une application connectée peut détenir, ce qu'elle permet, quel préréglage l'inclut et quels rôles (propriétaire, administrateur, éditeur, créateur de contenu) peuvent l'accorder.
Chaque jeton API et application connectée comporte un ensemble d'autorisations (capacités) qui déterminent ce qu'un agent peut faire dans votre espace de travail. Cet article liste chaque autorisation, ce qu'elle permet, quel préréglage l'inclut et quels rôles peuvent l'accorder.
Comment fonctionnent les autorisations
- Un agent agit en tant que personne ayant créé le jeton, dans la limite de ce que permet le rôle de cette personne. Il ne peut jamais faire plus que ce que son propriétaire pourrait faire dans l'application, et il ne voit que les enregistrements, vidéos et collections que son propriétaire peut voir.
- Votre rôle détermine ce que vous pouvez accorder. Dans l'assistant de jeton et sur l'écran de connexion, une autorisation que votre rôle ne peut pas accorder est grisée avec la mention « Votre rôle ne peut pas accorder ceci. » (ou « Seuls les propriétaires, administrateurs et éditeurs peuvent accorder la publication. » pour la publication). Un préréglage qui contient l'une d'entre elles est grisé avec la mention « Votre rôle ne peut pas accorder toutes les capacités de ce préréglage. »
- Le rôle est vérifié à chaque appel, pas seulement lors de la création du jeton. Si le rôle du propriétaire change ultérieurement, les appels nécessitant une autorisation que le nouveau rôle ne permet pas sont refusés, et le jeton affiche Dépasse le rôle dans la liste des jetons : « Le rôle du propriétaire a changé. Les appels nécessitant les capacités barrées sont refusés. »
- Chaque autorisation a un type, affiché sous forme de badge dans l'assistant : Lire, Modifier, Publier, Gérer ou Dépense des crédits.
- Un agent ne voit que les outils (MCP) et les points de terminaison (REST) que ses autorisations permettent. Appeler un élément dont il ne dispose pas renvoie « Ce jeton ne possède pas la capacité … »
Préréglages
La première étape de l'assistant de jeton (À quoi cela sert-il ?) propose des préréglages. En choisir un coche ses autorisations ; vous pouvez modifier n'importe laquelle d'entre elles à l'étape suivante, et l'assistant affiche alors Personnalisé avec Réinitialiser sur préréglage.
| Préréglage | Description à l'écran | Autorisations |
|---|---|---|
| Rédacteur | "Les agents rédigent ; une personne révise et publie." | content:read, articles:write, changelog:write, media:write |
| Éditeur | "Automatisation de confiance pouvant modifier ce que voient les lecteurs." | Toutes les autorisations de site de documentation sauf help:read et insights:read |
| Assistant support | "Réponses à partir de documents publiés. Rien d'autre." | help:read |
| Lecture seule | "Recherche, audits et vérifications de traduction." | content:read |
| Analyste | "Lit le contenu et les signaux des lecteurs pour suggérer des correctifs." | content:read, insights:read |
| Producteur | "Rédige du contenu et démarre un travail payant dans la limite des plafonds de dépenses." | Rédacteur, plus site-pages:write, library:read, videos:create, videos:export, materials:write, credits:spend, jobs:read |
| Agent de l'espace de travail | "Tout ce qu'un agent peut faire dans cet espace de travail, dans la limite des plafonds de dépenses." | Toutes les autorisations sauf help:read |
Producteur et Agent de l'espace de travail incluent credits:spend, donc l'assistant demande des plafonds de dépenses à l'étape Limites. Voir Contrôler les dépenses et les approbations des agents.
Les préréglages Rédacteur, Éditeur, Assistant support, Lecture seule et Analyste sont destinés aux sites de documentation.
Autorisations des vidéos
| Autorisation | Type | Ce qu'elle permet |
|---|---|---|
library:read |
Lire | "Lire les enregistrements, vidéos, articles et transcriptions que le propriétaire peut voir" : lister la bibliothèque et les enregistrements, lire un élément, sa transcription et son article, et obtenir un code d'intégration. |
videos:create |
Modifier | "Citer et demander des vidéos, des articles à partir d'enregistrements et de traductions" : demander un devis et demander des vidéos explicatives, de démonstration de produit, de nettoyage et stylisées à partir d'un enregistrement, des clips sociaux, des articles à partir d'un enregistrement et des traductions vidéo. Démarrer un travail payant nécessite également credits:spend. |
videos:export |
Modifier | "Exporter des vidéos et obtenir des codes d'intégration" : rendre un MP4 en 1080p (par défaut), 2K ou 4K, toujours à 60 fps, et obtenir un lien de téléchargement. Les exportations ne coûtent aucun crédit. |
materials:write |
Modifier | "Ajouter des images, des vidéos et des PDF aux téléchargements de l'espace de travail utilisés pour les nouvelles vidéos". |
Autorisations de l'espace de travail
| Autorisation | Type | Ce qu'elle permet |
|---|---|---|
credits:spend |
Dépense des crédits | "Dépenser des crédits sur un travail cité, dans la limite des plafonds du jeton". C'est la deuxième clé dont chaque démarrage payant a besoin, en plus de l'autorisation pour ce travail (par exemple videos:create). |
jobs:read |
Lire | "Voir les tâches démarrées par les autres jetons du propriétaire". Un jeton voit toujours ses propres tâches ; ceci ajoute les tâches des autres jetons de son propriétaire. Permet également à l'agent d'annuler une tâche et de lire le solde de crédits de l'espace de travail. |
Autorisations des documents
Celles-ci s'appliquent aux sites de documentation. Sous Limites → Sites de documentation, un jeton couvre Tous les sites ("Chaque site de documentation dans cet espace de travail, y compris les nouveaux.") ou Sites choisis.
| Autorisation | Type | Ce qu'elle permet |
|---|---|---|
content:read |
Lire | "Lire les sites, pages, articles (brouillons inclus), révisions, journal des modifications et pages de site". Également les paramètres du site, l'apparence, la navigation et les redirections. |
articles:write |
Modifier | "Créer des articles brouillons et modifier des articles qui ne sont pas en ligne". Traduire un article (payant) nécessite également credits:spend. |
structure:write |
Modifier | "Créer et modifier des sections, déplacer, masquer et renommer des pages". |
site-pages:write |
Modifier | "Modifier les pages de site telles que l'accueil, le contact et les mentions légales". Générer ou traduire une page de site avec l'IA (payant) nécessite également credits:spend. |
changelog:write |
Modifier | "Créer et modifier des entrées de journal des modifications sous forme de brouillons". |
media:write |
Modifier | "Télécharger des images". |
site:publish |
Publier | "Publier : modifier ce que voient les lecteurs, modifier le contenu en ligne, marquer les pages comme prêtes". Également publier et supprimer des entrées de journal des modifications et restaurer une version précédente d'un site. |
insights:read |
Lire | "Lire les statistiques du site : lacunes de recherche, questions sans réponse et retours sur les pages". Avec articles:write, il peut également marquer une lacune comme couverte. |
site:configure |
Gérer | "Modifier les paramètres du site, l'apparence et la navigation", et ajouter des redirections. |
sites:create |
Gérer | "Créer de nouveaux sites de documentation". |
help:read |
Lire | "Rechercher uniquement dans les pages publiques publiées (assistant support)". Un jeton avec seulement cette autorisation ne voit rien d'autre. |
Qui peut accorder quoi
| Autorisation | Propriétaire | Admin | Éditeur | Créateur de contenu |
|---|---|---|---|---|
content:read, help:read, insights:read, jobs:read |
Oui | Oui | Oui | Oui |
library:read |
Oui | Oui | Oui | Oui |
articles:write, structure:write, site-pages:write, changelog:write, media:write |
Oui | Oui | Oui | Oui |
videos:export |
Oui | Oui | Oui | Oui |
videos:create, materials:write, credits:spend |
Oui | Oui | Non | Oui |
site:publish, site:configure |
Oui | Oui | Oui | Non |
sites:create |
Oui | Oui | Non | Non |
Un créateur de contenu peut donner credits:spend à un jeton, mais le travail payant qui nécessite une approbation est toujours approuvé par le propriétaire de l'espace de travail ou un administrateur, jamais par le propriétaire du jeton seul. Voir Contrôler les dépenses et les approbations des agents.
Pas encore disponible pour les agents
Les agents ne peuvent pas encore effectuer de recherche sur des sites Web ou des visites guidées enregistrées, ni publier des vidéos sur d'autres plateformes. Ces autorisations ne peuvent pas être accordées.