Partage et autorisations des custom agents

Les custom agents automatisent le travail dans votre espace de travail Notion et vos outils connectés. Comprendre le fonctionnement des autorisations vous aide à partager les agents en toute sécurité tout en protégeant vos données.

Principale différence par rapport à l’agent Notion :

• L’IA de Notion agit comme vous et respecte vos autorisations personnelles . Elle ne voit que ce que vous pouvez voir.

• Les custom agents agissent comme des membres d’équipe spécialisés avec leurs propres autorisations. Ils ont accès aux ressources spécifiques que vous leur accordez.

Les custom agents disposent de deux types d’autorisations qui fonctionnent ensemble :

1. Ce à quoi l’agent peut accéder : les pages Notion, les bases de données et les applications connectées spécifiques que vous autorisez l’agent à utiliser.

2. Qui peut accéder à l’agent : les personnes avec lesquelles vous partagez l’agent et ce qu’elles peuvent faire avec lui.

Exemple :

Votre équipe financière crée un custom agent appelé BudgetBot pour répondre aux questions sur les dépenses et les approbations budgétaires.

• L’équipe financière donne à BudgetBot accès à des pages privées, telles que des modèles de budget, des workflows de validation et des directives de dépenses par service.

• L’équipe financière donne aux responsables de service les autorisations Peut voir et interagir avec BudgetBot.

• Les chefs de service ayant accès à BudgetBot peuvent désormais lui poser des questions et obtenir des réponses à l’aide des documents internes de l’équipe financière, même s’ils ou elles n’ont pas d’accès direct à ces pages.

Cela permet aux responsables de département de prendre des décisions éclairées plus rapidement. Ils ou elles peuvent demander à BudgetBot toute information budgétaire, des résumés rapides au contenu complet des documents, sans avoir besoin d’un accès direct à chaque page de l’équipe financière.

Lorsque vous créez un custom agent, vous choisissez explicitement ce à quoi il peut accéder dans les paramètres Outils et accès. Les custom agents peuvent accéder à :

• Pages et bases de données Notion ; sélectionnez des pages ou des bases de données spécifiques.

• Applications connectées : canaux Slack, MCP, Calendar, Mail.

• Niveaux d’autorisation : peut voir, peut commenter, peut modifier.

Vous pouvez également donner à un custom agent l'accès à une page depuis la page elle-même. Ouvrez la page, cliquez sur Partager, recherchez l'agent par son nom et ajoutez-le comme vous ajouteriez une personne. L'agent apparaîtra alors dans le menu de partage de cette page.

Par défaut, les nouveaux agents n’ont accès à aucune page de l’espace de travail. Les créateurs doivent explicitement activer cette option et accepter la fenêtre modale d’avertissement. Les administrateurs d’espace de travail Enterprise peuvent contrôler qui peut créer un custom agent, voir tous les agents d’un espace de travail, et désactiver les déclencheurs ou remplacer les autorisations sur n’importe quel agent.

L’agent peut uniquement accéder aux ressources pour lesquelles vous lui avez explicitement donné l’autorisation. Il ne peut accéder à rien d’autre dans votre espace de travail. Il n’y a pas d’autorisations héritées de qui que ce soit (qu’il s’agisse du créateur ou de l’utilisateur de l’agent).

Cela inclut également les autorisations sur les lignes de base de données. Un agent personnalisé répond en utilisant ses propres accès, et non les autorisations de la personne qui l’a déclenché. Ainsi, si l’agent peut voir plus de lignes que l’utilisateur final, l’agent peut exposer des informations auxquelles l’utilisateur final ne peut pas accéder directement.

• Pour accorder un accès en lecture seule à une ressource Notion, vous devez avoir au moins un accès en lecture seule à cette ressource.

• Pour accorder un niveau d’accès supérieur à la vue, vous devez disposer d’un accès complet pour partager cette ressource.

Partagez votre custom agent avec votre équipe tout comme une page Notion en cliquant sur Partager en haut de la page. Les custom agents ont trois niveaux d’autorisation qui déterminent qui peut les utiliser et les modifier.

• Utilisez l’agent pour poser des questions ou exécuter des tâches.

• Consultez les réponses et les résultats de l’agent.

• Afficher les paramètres et les instructions de l’agent en mode lecture seule.

• Tout ce qui est inclus dans Peut voir et interagir.

• Afficher et modifier les instructions de l’agent.

• Voir toutes les discussions que les utilisateurs ont eues avec le custom agent.

• Ajouter ou supprimer des pages et des bases de données Notion.

• Possibilité de modifier les paramètres et les instructions, à l’exception des connexions tierces activées par d’autres personnes.

• Tout ce qui est inclus dans Peut modifier.

• Partager l’agent avec d’autres personnes.

• Supprimer l’agent.

Vous pouvez dupliquer un custom agent pour créer une copie privée que vous pouvez adapter à votre propre flux de travail. La copie est privée par défaut. Vous seul y avez accès jusqu’à ce que vous la partagiez.

Lorsque vous dupliquez un custom agent, Notion vérifie vos propres autorisations, et non celles de l’agent d’origine, pour décider de ce que le duplicata comprend :

• Ressources (pages, bases de données) : Seules les ressources auxquelles vous avez accès sont conservées. Les ressources auxquelles vous ne pouvez pas accéder sont supprimées de la copie.

• Déclencheurs : les déclencheurs qui s’appuient sur des ressources auxquelles vous n’avez pas accès (par exemple un canal Slack privé) sont supprimés.

• Outils comme Slack : Non transférés automatiquement. Vous devrez réauthentifier toute connexion tierce sur la copie.

• Instructions : Clonées sous forme de nouvelle page. Les références aux pages auxquelles vous n’avez pas accès apparaissent sous forme de puces sans accès et ne sont pas ajoutées aux paramètres Outils et accès de la copie.

Pour les intégrations, Notion vérifie que toute personne configurant l’agent a accès à la ressource qu’elle modifie. Par exemple, si vous configurez un canal Slack auquel vous seul avez accès, les autres éditeurs ne peuvent pas modifier ou voir cette ressource ; ils peuvent seulement la supprimer ou en configurer une nouvelle.

• Afficher les résultats produits par les agents dans les pages ou les bases de données Notion qui sont partagées avec elles et eux.

• Modifier des pages ou des bases de données qui peuvent déclencher l’exécution de custom agents déjà configurés.

• Créer des custom agents.

• Modifier les paramètres de l’agent (sauf si l’autorisation

  Peut modifier a été explicitement donnée).

• Poser des questions et recevoir des réponses en fonction de ce à quoi l’agent peut accéder.

Les administrateurs de l’espace de travail peuvent gérer les custom agents dans l’ensemble de l’organisation à l’aide des outils et des commandes suivants.

Sur le Forfait Enterprise, les administrateurs peuvent également gérer les custom agents à partir de leurs propres outils en utilisant l'Admin API. Consultez la section Admin API ci-dessous.

Dans Paramètres → IA de Notion, les admins des espaces de travail disposant d’un forfait Business ou Enterprise peuvent consulter et gérer les dépenses liées aux agents. L’onglet Vue d’ensemble répertorie chaque agent avec son propriétaire, son type, son modèle, ses exécutions et les crédits utilisés. Vous pouvez modifier le modèle d’un agent directement depuis cette table. Pour définir des limites de crédit, ouvrez l’onglet Crédits. Vous pouvez y définir une limite pour un agent ou une limite par défaut pour tous les agents.

Pour découvrir ces onglets, consultez Vue d’ensemble des paramètres de l’IA de Notion →

Pour éviter qu’un agent essentiel à l’activité ne soit mis en pause, définissez sa limite de crédit sur Illimité, ce qui supprime le plafond par agent. L’agent peut toujours être limité par les crédits dont dispose votre espace de travail. Un agent utilise par défaut les crédits Select de son propriétaire, puis les crédits Notion de l’espace de travail si vous l’autorisez, et vous pouvez modifier le financement d’un agent depuis son onglet Crédits.

En savoir plus sur le fonctionnement des crédits d’IA pour les custom agents →

• Cherchez et affichez tous les custom agents dans votre espace de travail.

• Découvrez qui a créé chaque agent et quand il a été actif pour la dernière fois.

• Désactivez et réactivez la modification, la discussion et les déclencheurs de l’agent pour arrêter les exécutions automatisées.

• Enterprise uniquement : modifiez les autorisations et supprimez n’importe quel agent, même si vous n’y avez pas accès.

La liste des agents affiche également le modèle de chaque agent, le nombre d’exécutions terminées et les crédits utilisés. Vous pouvez modifier le modèle d’un agent directement depuis la table. Un agent qui n’a jamais été publié apparaît comme Brouillon, car un brouillon ne peut pas être exécuté.

Pour accéder au Répertoire des agents, allez dans Paramètres, sélectionnez IA de Notion dans la barre latérale, puis accédez à l’onglet Vue d’ensemble. Parcourez ou recherchez des agents dans votre espace de travail.

Limiter les personnes autorisées à créer des custom agents :

1. Allez dans Paramètres > IA de Notion.

2. Ouvrez l’onglet Contrôles , puis accédez à Contrôler qui peut créer des agents.

3. Choisissez qui peut créer des agents : Tous les membres de l’espace de travail (par défaut), Propriétaires de l’espace de travail uniquement ou Propriétaires de l’espace de travail + groupes ajoutés uniquement.

• Consultez les pages et les bases de données auxquelles chaque custom agent peut accéder.

• Gérer les autorisations des agents sur des ressources spécifiques.

• Supprimer l’accès des agents au contenu sensible.

Pour accéder à la recherche de contenu, accédez à Paramètres > Recherche de contenu et utilisez le filtre Partagé avec pour sélectionner un custom agent.

• Historique complet de toutes les actions du custom agent.

• Filtrer par agent, utilisateur/utilisatrice, date ou type d’action.

Pour accéder au journal d’audit, accédez à Paramètres >  Journal d’audit et filtrez les événements de custom agents en choisissant l’agent dans la liste déroulante Utilisateurs/Agents.

• Identifier les agents les plus utilisés et ceux qui ne sont pas utilisés.

• Surveiller l’adoption et la valeur.

Pour accéder aux données analytiques de l’IA, accédez à Paramètres > Données analytiques et ouvrez l’onglet IA.

Le transfert de propriété garantit que les agents essentiels à l’activité continuent de fonctionner lorsque des utilisateurs quittent l’espace de travail. Après 7 jours sans propriétaire, l’agent cesse de fonctionner.

1. Accédez à Paramètres > Membres et ouvrez l’onglet Récemment parti·es.

2. Les utilisateurs et utilisatrices récemment parti·es verront les agents apparaître en tant qu’« agents privés » dans le flux de réapprovisionnement de contenu.

3. Choisissez le nouveau ou la nouvelle propriétaire et confirmez le transfert.

Le transfert de propriété est également pris en charge via l’API publique.

Gérez les custom agents à partir de vos propres outils et scripts :

• Consultez chaque custom agent de votre espace de travail, y compris qui l'a créé, s'il est actif, quel modèle il utilise, quand il a été exécuté pour la dernière fois et à quoi il peut accéder.

• Consultez l'utilisation des crédits pour chaque agent et définissez des limites de crédit pour un agent ou pour l'ensemble de l'espace de travail.

• Définissez qui peut créer des agents, activez ou désactivez les agents et supprimez des agents.

L'Admin API est utile lorsque vous gérez de nombreux agents ou que vous souhaitez intégrer des données d'utilisation dans vos propres rapports. En savoir plus sur la gestion des custom agents avec Admin API →