Notion Custom Agents : guide pratique pour 2026
Les Custom Agents de Notion sont des agents IA autonomes qui automatisent vos workflows récurrents sans intervention manuelle. Vous décrivez une tâche, vous définissez un déclencheur, et l’agent s’exécute en arrière-plan, que vous soyez connecté ou non.
Lancés le 24 février 2026 avec Notion 3.3, les Custom Agents ont déjà séduit les équipes : plus de 21 000 agents ont été créés pendant la bêta, et Notion utilise en interne 2 800 agents, soit plus d’agents que d’employés (blog Notion, février 2026). Avec plus de 100 millions d’utilisateurs dans le monde en 2026, Notion mise sur l’IA agentique pour transformer la productivité des équipes. Depuis la sortie, trois mises à jour majeures ont façonné l’écosystème : l’environnement d’exécution de code Notion Workers le 12 mars 2026, Notion 3.4 Part 2 le 14 avril 2026 qui a rendu les agents 35 à 50 % moins chers, et la période gratuite qui se termine le 3 mai 2026. Ce guide vous explique comment créer, configurer et utiliser les Custom Agents concrètement, en tenant compte de ces échéances.
Qu’est-ce qu’un Custom Agent Notion ?
Un Custom Agent est un workflow IA autonome qui tourne 24 heures sur 24 dans votre workspace Notion. Contrairement à l’Agent personnel (celui que vous appelez via le panneau IA en bas à droite), un Custom Agent fonctionne sans intervention de votre part. Vous lui attribuez une mission, un déclencheur et des sources de données, puis il travaille en autonomie.
Si vous connaissez déjà les automations Notion, les Custom Agents en sont l’évolution naturelle. Là où une automation exécute une action simple (modifier une propriété, envoyer une notification), un Custom Agent raisonne sur le contexte et prend des décisions multi-étapes.

Trois grandes catégories d’agents se dégagent :
| Type d’agent | Fonction | Exemple concret |
|---|---|---|
| Q&A | Répond aux questions récurrentes | Agent IT qui résout les tickets de support |
| Tri de tâches | Capture et route les demandes | Agent qui transforme les messages Slack en tâches assignées |
| Reporting | Génère des rapports récurrents | Agent qui publie un standup quotidien dans Slack |
Pour un aperçu global de toutes les fonctionnalités IA de Notion (Agent personnel, Enterprise Search, Meeting Notes), consultez mon guide complet Notion IA.
Comment créer un Custom Agent : guide pas à pas
Les 6 étapes pour créer un Custom Agent, de la configuration à la mise en production.
Étape 1 : Accéder à la section Agents

Ouvrez Notion sur desktop ou web (les Custom Agents ne se créent pas depuis mobile). Dans la barre latérale gauche, repérez la section Agents et cliquez sur le bouton + pour créer un nouvel agent.
Vous avez trois options :
- Création assistée par IA : décrivez votre workflow en langage naturel et laissez Notion générer la configuration initiale.
- Partir d’un template : choisissez parmi les modèles prédéfinis (Q&A, tri de tâches, reporting) et personnalisez-les.
- Page vierge : rédigez vos instructions manuellement pour un contrôle total.
Je recommande de commencer par la création assistée. Vous décrivez ce que vous voulez en une ou deux phrases, et Notion génère les instructions, les déclencheurs et les paramètres d’accès. Vous ajustez ensuite.
Étape 2 : Rédiger les instructions de l’agent
Les instructions sont la pièce maîtresse de votre agent. C’est l’équivalent d’une fiche de poste : plus elle est précise, meilleurs sont les résultats.
Bonnes pratiques pour les instructions :
- Commencez par l’objectif : « Ton rôle est de trier les demandes entrantes dans la base Tickets et de les assigner au bon responsable. »
- Détaillez les étapes : « 1. Lis le contenu du ticket. 2. Identifie la catégorie (bug, feature, question). 3. Assigne au responsable selon le tableau de routage. »
- Donnez des exemples : « Si le ticket mentionne une erreur 500, catégorise-le comme bug critique et assigne-le à l’équipe Backend. »
- Précisez le format de sortie : « Publie un résumé dans le canal #support-triage sur Slack avec le lien vers le ticket. »
J’ai constaté qu’un agent avec des instructions de 10 à 15 lignes bien structurées produit de meilleurs résultats qu’un agent avec 3 lignes vagues ou 50 lignes trop détaillées.
Étape 3 : Configurer les déclencheurs
Les déclencheurs déterminent quand votre agent entre en action. Notion propose deux familles de déclencheurs :
Déclencheurs planifiés :
- Quotidien, hebdomadaire, mensuel ou annuel
- Heure et fuseau horaire personnalisables
- Idéal pour les agents de reporting (standup du matin, résumé de sprint hebdomadaire)
Déclencheurs événementiels :
- Un commentaire est ajouté sur une page Notion
- Une page est créée, modifiée ou supprimée dans une base de données
- L’agent est mentionné (@) dans une page ou un commentaire
- Un message est posté dans un canal Slack public
- Une réaction emoji est ajoutée sur Slack
- Un fil de discussion est créé sur Slack
Le choix du déclencheur dépend du cas d’usage. Pour un agent de tri de tickets, un déclencheur « page créée dans la base Tickets » est logique. Pour un agent de standup, un déclencheur planifié quotidien à 9 h convient mieux.
Étape 4 : Définir les sources de données
Les 6 sources de données accessibles à un Custom Agent.
Votre agent n’accède qu’aux données que vous lui autorisez explicitement. Vous pouvez lui donner accès à :
- Des pages et bases de données Notion spécifiques : ciblez exactement les données pertinentes pour sa mission.
- Les pages partagées avec tout le workspace : pour les agents Q&A qui doivent chercher dans l’ensemble de la documentation.
- Slack : lecture et écriture dans les canaux publics et privés (depuis le 14 avril 2026). Les messages directs (DM) ne sont pas pris en charge.
- Notion Mail et Calendar : lecture des emails, événements, et création de nouveaux éléments.
- Outils externes via MCP : connexion à Linear, Figma, HubSpot, GitHub, Stripe, Intercom, Sentry, Amplitude, Ramp, Attio, Canva, Wiz, Salesforce, Box et vos serveurs MCP personnalisés (liste complète des connexions MCP).
- Outils personnalisés via Notion Workers : depuis mars 2026, vous pouvez écrire vos propres Tools en TypeScript et les exposer à vos agents. Utile pour appeler une API qui n’a pas de connecteur MCP (Twilio, Datadog, une API interne).
- Le web : activez l’option si votre agent doit chercher des informations en ligne (désactivez-la pour les workflows strictement internes).
Étape 5 : Choisir le modèle IA
Les Custom Agents prennent en charge plusieurs modèles de langage : Claude, GPT et Gemini. Le mode Auto (réglage par défaut) laisse Notion sélectionner le modèle optimal pour chaque requête. Depuis Notion 3.4 Part 2 (14 avril 2026), trois nouveaux modèles économiques sont disponibles : GPT-5.4 Mini et Nano, Haiku 4.5 et MiniMax M2.5. Ces modèles consomment jusqu’à 10 fois moins de crédits que les modèles avancés (release notes Notion, 14 avril 2026).
Mon conseil : laissez le mode Auto pour commencer. Si vous constatez que votre agent produit des résultats moyens sur des tâches complexes, basculez manuellement sur Claude ou GPT. Pour des agents de tri, de routage ou de triage d’emails, GPT-5.4 Mini ou Haiku 4.5 réduisent sensiblement les coûts sans sacrifier la qualité (voir la section Tarifs). Pour un suivi détaillé des coûts par modèle, consultez mon guide Notion Credits.
Étape 6 : Tester et publier
Avant de publier, utilisez l’onglet Chat de votre agent pour le tester en conditions réelles. Posez-lui des questions, soumettez-lui des cas limites, vérifiez ses réponses.
Une fois satisfait, publiez l’agent. Il sera accessible à votre équipe selon les permissions que vous avez définies. Chaque exécution est visible dans l’onglet Activity, où vous pouvez suivre les déclencheurs, les actions prises et les erreurs éventuelles.
Étendre les Custom Agents avec Notion Workers
Depuis le 12 mars 2026, Notion propose Notion Workers, un environnement d’exécution TypeScript qui permet d’écrire du code personnalisé pour vos Custom Agents. Concrètement, au-delà des connecteurs MCP prédéfinis, vous pouvez donner à vos agents des capacités programmables sur mesure, hébergées et exécutées par Notion sur l’infrastructure Vercel Sandbox.
Workers est actuellement en alpha et réservé aux workspaces Business et Enterprise dont l’administrateur a activé l’accès. Le SDK @notionhq/workers et le CLI ntn sont gratuits. Seule l’exécution des agents qui appellent vos Workers consomme des crédits Notion, selon la même grille tarifaire que les autres agents (voir section Tarifs).
Deux capacités sont exposées par Workers :
| Type | Rôle | Exemple concret |
|---|---|---|
| Tool | Fonction appelée à la demande par un Custom Agent | Envoyer un SMS via Twilio, interroger une API interne, créer un ticket dans un outil sans connecteur MCP |
| Sync | Job planifié qui alimente une base Notion | Importer un CRM externe toutes les 5 minutes, synchroniser un flux RSS, miroir bidirectionnel avec HubSpot |
J’ai testé Workers pendant l’alpha pour trois cas d’usage qui complètent bien les Custom Agents :
- Synchronisation externe : un Sync qui importe les opportunités HubSpot dans une base Notion toutes les 5 minutes. Un Custom Agent analyse ensuite les opportunités en retard et publie un récapitulatif quotidien. Sans Workers, il aurait fallu passer par Zapier ou l’API Notion avec un serveur tiers.
- Alertes intelligentes : un Tool qui interroge l’API Sentry quand le taux d’erreurs dépasse un seuil, crée une page dans la base Incidents, puis un Custom Agent corrèle les incidents et rédige un rapport hebdomadaire.
- Slack vers Notion avec logique métier : un Tool qui reçoit un message Slack, en extrait les entités (client, montant, produit) via une API de parsing custom, puis insère une ligne dans le CRM Notion. Plus flexible que la connexion Slack native des Custom Agents lorsque vous avez besoin d’une logique de parsing personnalisée.
Chaque Worker s’exécute dans une microVM Firecracker éphémère, avec un modèle de sécurité zéro confiance : les credentials sont injectés au niveau réseau sans jamais être exposés au code, et la VM est détruite après chaque exécution. Pour un tutoriel complet, les prérequis d’installation et les exemples de code, consultez mon guide dédié à Notion Workers.
Mon conseil : les Custom Agents configurés en langage naturel couvrent 80 % des besoins. Workers est réservé aux cas où vous avez besoin d’une intégration sur mesure ou d’une logique métier impossible à exprimer en prompt. Commencez toujours par un agent standard, et passez à Workers seulement si vous butez sur une limite technique.
Cas d’usage concrets et résultats mesurés
Agent Q&A pour le support IT
Remote, plateforme RH pour équipes distribuées, a déployé un Custom Agent pour son support IT interne. Selon James Lawley, IT Operations Manager chez Remote, l’agent trie les tickets avec une précision supérieure à 95 % et résout plus de 25 % des demandes sans intervention humaine. L’équipe économise 20 heures par semaine (release notes Notion 3.3, février 2026).
C’est le cas d’usage le plus immédiat pour la plupart des équipes. Si votre base de connaissances interne est bien documentée dans Notion, un agent Q&A peut répondre aux questions récurrentes (« Comment configurer le VPN ? », « Où trouver le template de brief ? ») en quelques secondes.
Agent de reporting quotidien
Braintrust, plateforme d’observabilité IA, utilise un Custom Agent qui génère des rapports quotidiens sur les opportunités commerciales. Morgane Palomares, VP Marketing chez Braintrust, estime que chaque mise à jour lui fait gagner 20 minutes par jour (release notes Notion 3.3, février 2026).
J’ai configuré un agent similaire pour mon propre workflow. Chaque matin à 8 h, il compile les tâches en retard, les échéances du jour et les commentaires non lus dans mes bases de données, puis publie un résumé dans un canal Slack dédié. La mise en place m’a pris 15 minutes.
Agent de tri de tâches avec Slack
Un des retours les plus fréquents sur Reddit concerne les agents de tri connectés à Slack. Le principe : quand quelqu’un poste une demande dans un canal Slack dédié (par exemple #demandes-marketing), l’agent la capture, la convertit en tâche dans une base de données Notion, la catégorise et l’assigne au bon responsable.
C’est particulièrement utile pour les équipes qui reçoivent des demandes de plusieurs départements. Au lieu de trier manuellement chaque message, l’agent s’en charge en temps réel. Pour donner un ordre de grandeur, chez Ramp, un seul agent Q&A a répondu à 4 000 questions en deux semaines, économisant environ 2 000 heures de travail (case study Ramp, Notion 2026).
Permissions et contrôle administrateur
Les Custom Agents disposent de trois niveaux de permissions, semblables à ceux d’un coéquipier :
| Niveau | Droits |
|---|---|
| Full Access | Configure les instructions, déclencheurs, accès. Consulte et gère les logs d’activité. Exécute et interagit avec l’agent. |
| Can Edit | Modifie les instructions et la configuration. Consulte les logs d’activité. |
| Can View and Interact | Exécute l’agent et interagit via le chat. Lecture seule sur les paramètres. |
Les administrateurs d’un plan Enterprise peuvent restreindre qui a le droit de créer des agents via Paramètres > Notion IA > Agents. Chaque exécution d’agent est journalisée, et toutes les modifications sont réversibles grâce à l’historique de versions de Notion.
Côté sécurité, Notion est certifié SOC 2 Type 2 et ISO 27001. Les Custom Agents ne s’entraînent pas sur vos données. Le plan Enterprise offre le zero data retention avec les fournisseurs de modèles IA. J’ai détaillé ces points dans mon guide sur la protection des données Notion.
De 0 euros à 10 dollars pour 1 000 crédits : les deux phases tarifaires des Custom Agents en 2026.
Tarifs des Custom Agents en 2026
Voici ce qu’il faut retenir sur les coûts. La période gratuite se termine le 3 mai 2026 : il reste moins de trois semaines pour tester les Custom Agents sans engagement.
| Période | Accès | Coût |
|---|---|---|
| Jusqu’au 3 mai 2026 inclus | Gratuit sur Business et Enterprise (y compris essais Business) | 0 euros |
| À partir du 4 mai 2026 | Système de Notion Credits | 10 dollars pour 1 000 crédits (add-on) |
Depuis le 14 avril 2026, les Custom Agents coûtent 35 à 50 % moins cher grâce à l’optimisation de l’infrastructure et aux nouveaux modèles économiques (release notes Notion 3.4, 14 avril 2026). Voici les fourchettes de coût par type d’agent, selon la documentation officielle :
| Type d’agent | Coût par exécution |
|---|---|
| Agent Q&A | ~0,03 $ à 0,11 $ |
| Agent de tri / routage | ~0,05 $ à 0,15 $ |
| Agent de mise à jour de statut | ~0,08 $ à 0,18 $ |
| Agent de triage d’emails | ~0,04 $ à 0,10 $ |
| Agent de reporting quotidien | ~0,10 $ à 0,30 $ |
La consommation de crédits dépend de plusieurs facteurs :
- Le volume de données traitées (pages longues, bases volumineuses)
- Le nombre d’outils connectés
- La complexité du workflow (multi-étapes = plus de crédits)
- La fréquence d’exécution
- Le modèle IA sélectionné : les modèles économiques (GPT-5.4 Mini/Nano, Haiku 4.5, MiniMax M2.5) consomment jusqu’à 10 fois moins de crédits que les modèles avancés
Les crédits sont partagés entre tous les membres du workspace. Les crédits non utilisés ne se cumulent pas d’un mois à l’autre. Si votre solde de crédits est insuffisant, les agents se mettent automatiquement en pause. Le dashboard Notion Credits permet aux administrateurs de suivre la consommation par agent et de définir des plafonds mensuels.
Les autres fonctionnalités IA de Notion (Agent personnel, Meeting Notes, Enterprise Search) restent incluses dans les plans Business et Enterprise sans surcoût. Pour un comparatif détaillé de tous les plans, consultez mon article sur les tarifs Notion.
Limites actuelles des Custom Agents
Après un mois d’utilisation, voici les limites que j’ai identifiées :
- DM Slack inaccessibles : depuis le 14 avril 2026, les agents peuvent lire et écrire dans les canaux Slack publics et privés. Les messages directs (DM) restent cependant hors de portée.
- Pas de création depuis mobile : vous pouvez interagir avec un agent depuis mobile, mais la création et l’édition nécessitent un desktop ou un navigateur web.
- Performances sur gros workspaces : selon les retours de la communauté, avec plus de 5 000 pages, les agents deviennent plus lents et moins précis dans leurs recherches. C’est une limitation connue qui affecte aussi l’Agent personnel.
- Pas de chaînage natif : un agent ne peut pas déclencher un autre agent directement. Si vous avez besoin de workflows multi-agents, il faut passer par un intermédiaire (une base de données Notion qui sert de file d’attente, par exemple).
- Crédits limités : à partir de mai 2026, la consommation de crédits sera le principal frein. La baisse de 35 à 50 % annoncée en avril 2026 atténue l’impact, mais les équipes avec beaucoup d’agents devront optimiser la fréquence d’exécution et privilégier les modèles économiques (GPT-5.4 Mini/Nano, Haiku 4.5).
Pour les workflows plus complexes qui dépassent les capacités natives de Notion, l’API Notion reste une option complémentaire.
Automations pour les règles simples, Custom Agents pour les workflows IA multi-étapes.
Custom Agents vs automations Notion : que choisir ?

| Critère | Automations Notion | Custom Agents |
|---|---|---|
| Complexité | Actions simples (modifier propriété, notifier) | Workflows multi-étapes avec raisonnement IA |
| Déclencheurs | Propriété modifiée, page ajoutée | Horaire, événement Notion, Slack, mention |
| Intelligence | Règles fixes (si X, alors Y) | Analyse contextuelle, prise de décision |
| Outils connectés | Notion uniquement | Notion, Slack (public et privé), Mail, Calendar, MCP, Salesforce, Box |
| Coût | Inclus dans tous les plans | Business/Enterprise + crédits (à partir de mai 2026) |
| Cas d’usage | Mise à jour automatique de statuts, notifications | Q&A, tri intelligent, reporting, analyse |
En pratique, les deux se complètent. J’utilise les automations pour les actions simples et déterministes (quand un statut passe à « Terminé », archiver la page) et les Custom Agents pour tout ce qui nécessite du contexte et du jugement (trier un ticket selon son contenu, résumer une semaine de travail).
Ce que j’en pense
Après un mois d’utilisation quotidienne, les Custom Agents sont la fonctionnalité qui m’a le plus changé la vie dans Notion depuis les automations. L’agent Q&A et l’agent de reporting quotidien me font gagner un temps réel et mesurable.
Ce qui fonctionne bien : la création en langage naturel est intuitive, et l’onglet Activity permet de voir exactement ce que fait chaque agent, étape par étape. Le protocole MCP ouvre la porte à des connexions avec des outils tiers comme Linear ou Figma, et l’arrivée de Notion Workers en mars 2026 permet désormais aux équipes techniques d’écrire leurs propres outils en TypeScript pour combler les intégrations manquantes.
Ce qui reste à améliorer : le chaînage natif entre agents et les performances sur les gros workspaces. Le support des canaux Slack privés, ajouté le 14 avril 2026, règle l’un des principaux irritants. La baisse de coûts annoncée le même jour atténue le point de friction tarifaire, mais les petites équipes qui veulent déployer plusieurs agents devront surveiller leur consommation via le dashboard Notion Credits.
Ma recommandation : profitez de la période gratuite (jusqu’au 3 mai 2026 inclus, soit moins de trois semaines) pour tester un ou deux agents simples, avant le passage au système de crédits le 4 mai. Commencez par un agent de reporting quotidien ou un agent Q&A sur votre base de connaissances. Si les résultats sont concluants, vous saurez exactement combien de crédits prévoir pour la suite. Avec la baisse de coûts d’avril 2026 et les modèles économiques comme GPT-5.4 Mini, la facture sera plus légère que prévu. Suivez votre consommation dans le dashboard Notion Credits et consultez mon guide AI Autofill pour combiner agents et enrichissement automatique de vos bases de données. Les développeurs qui veulent aller plus loin trouveront dans mon guide Notion Workers le tutoriel complet pour écrire leurs propres Tools et Syncs.