Agent personnalisé

How to build a Custom Agent
Dans cet article

Avec les agents personnalisés, vous créez des flux de travail partagés qui automatisent les tâches récurrentes de votre équipe, en les exécutant exactement comme vous le souhaitez, en arrière-plan. 🤖

Aller directement aux questions fréquentes

Custom Agents are currently in beta and subject to the beta terms of your agreement.

Les agents personnalisés automatisent les flux de travail manuels récurrents pour l’ensemble de votre équipe. Ils s’exécutent automatiquement en arrière-plan sur des déclencheurs définis en utilisant vos documents et bases de données existants comme contexte.

Configurez-les une seule fois, en créant un flux de travail pour les tâches répétitives telles que les rapports hebdomadaires ou le tri des commentaires, et ils deviendront une ressource partagée sur laquelle toute l’équipe s’appuiera.

Que sont les agents personnalisés ?

Les agents personnalisés sont intégrés à Notion et fonctionnent selon vos instructions. Une fois que vous les avez configurés, ils peuvent :

  • Lire les pages et les bases de données Notion, ainsi que certaines applications connectées.

  • S’exécuter sur des déclencheurs récurrents et des événements de l’espace de travail.

  • Effectuer des actions telles que la publication de rapports, le dépôt de bugs, la mise à jour d’enregistrements ou l’envoi de messages.

Contrairement à l’agent Notion, les agents personnalisés sont conçus pour s’exécuter automatiquement en arrière-plan en fonction de déclencheurs et de planifications.

Utilisez vos documents et bases de données existants comme contexte

Les agents personnalisés sont directement intégrés à Notion. Les agents utilisent vos documents et bases de données existants comme contexte et se connectent via Slack, ce qui augmente la productivité. Les agents personnalisés peuvent :

  • Être @mentionnés dans les pages Notion, les propriétés de base de données et les commentaires.

  • Être associés à des événements de base de données (par exemple, lorsqu’une page est créée ou mise à jour).

  • Surveillés votre espace de travail et les outils connectés en fonction des déclencheurs que vous configurez.

Gérer automatiquement les tâches récurrentes avec des déclencheurs

Utilisez des déclencheurs pour que les agents personnalisés s’exécutent sans que vous n’ayez à les démarrer manuellement à chaque fois. Définissez un déclencheur une seule fois, puis le travail se déroule en continu en arrière-plan.

  • Exécutez-les selon une planification (quotidien, hebdomadaire, mensuel, etc.).

  • Réagissez aux événements dans Notion et Slack.

  • Continuez à les exécuter en arrière-plan une fois que vous les avez publiés.

Cela permet d’automatiser les flux de travail (rapports réguliers, files d’attente de triage, maintenance des connaissances, etc.) et de gagner du temps.

Sécurisé et transparent par conception

Les agents n’agissent que sur les pages, les bases de données et les applications externes auxquelles vous accordez explicitement l’accès. Par défaut, ils n’ont jamais un accès complet à l’espace de travail, ce qui réduit les risques.

  • Contrôlez qui peut modifier, exécuter ou interagir avec chaque agent.

  • Consultez les journaux d’activité pour voir ce qu’un agent a fait et à quel moment.

  • Utilisez l’historique des versions pour consulter ou restaurer les configurations précédentes.

  • Gardez les exécutions révisables et réversibles afin de pouvoir itérer en toute sécurité.

  • Avoir un forfait Notion Business ou Enterprise.

  • Pour créer ou modifier des agents personnalisés, utilisez la version Web ou l’application de bureau. Vous pouvez voir ou interagir avec les agents sur le bureau ou sur le Web.

    • Visualisez et interagissez avec tout contenu créé par les agents dans les pages et les bases de données Notion sur mobile.

    • Affichez les publications de l’agent dans Slack via l’application mobile Slack.

Vous pouvez créer un agent personnalisé à partir de plusieurs emplacements. Le point d’entrée principal est la section Agents dans la barre latérale.

  1. Accédez à la section Agents dans la barre latérale de gauche et sélectionnez + pour créer un nouvel agent personnalisé.

  2. Choisissez la façon dont vous souhaitez commencer :

    • Créer à partir d’un modèle

      • Sélectionnez un modèle

      • Passez en revue les ébauches d’instructions, les déclencheurs et les accès que l’IA de Notion génère et itère.

      • Enregistrer.

    • Créer avec le chat alimenté par l’IA

      • Dans le chat, décrivez ce que vous voulez que l’agent fasse en utilisant un langage naturel.

      • Passez en revue les ébauches d’instructions, les déclencheurs et les accès que l’IA de Notion génère et itère.

      • Enregistrer.

    • Créer à partir de zéro

      • Sélectionnez Créer à partir de zéro.

      • Commencez à partir d’un champ d’instructions vide ou discutez avec votre agent.

      • Rédigez vos instructions manuellement, en suivant les meilleures pratiques pour des instructions claires et concrètes. Définissez ce que l’agent doit faire, comment il doit se comporter et quel travail il doit gérer.

      • Définissez les déclencheurs, l’accès, votre modèle d’IA jusqu’à ce qu’ils correspondent à votre flux de travail.

      • Enregistrer.

To create clear instructions for your Agent, start with the job and outcome you want. Then add concrete steps, inputs, and outputs. Use examples when you have them.

Tip: Use our Custom Agent templates as a starting point.

Les déclencheurs déterminent quand votre agent s’exécute. Vous pouvez combiner plusieurs types de déclencheurs pour un seul agent.

Automatisez les flux de travail avec des planifications récurrentes et basées sur le temps

Utilisez des planifications récurrentes pour exécuter les agents à une certaine fréquence.

  1. Ouvrez les paramètres de votre agent personnalisé.

  2. Accédez à la section Déclencheurs.

  3. Ajoutez un déclencheur Récurrent.

  4. Choisissez quand vous voulez que l’agent s’exécute :

    • Sélectionnez une fréquence (tous les jours, toutes les semaines, tous les mois ou tous les ans).

    • Définissez une heure spécifique, y compris le fuseau horaire (par exemple, « tous les jours à minuit PST »).

  5. Passez en revue la prochaine heure d’exécution planifiée pour confirmer que la planification est correcte.

  6. Sauvegardez votre déclencheur.

Utiliser les déclencheurs Notion

Les déclencheurs Notion exécutent votre agent en fonction des événements dans votre espace de travail. Vous pouvez déclencher des agents lorsque :

  • Un commentaire est ajouté à une page.

  • Une page est ajoutée à une base de données.

  • Une page est mise à jour dans une base de données.

  • Une page est supprimée d’une base de données.

  • L’agent personnalisé est @mentionné dans une page ou un commentaire.

Pour ajouter un déclencheur Notion :

  1. Ouvrez les paramètres de votre agent personnalisé et sélectionnez Déclencheurs.

  2. Choisissez un type de déclencheur Notion.

  3. Précisez :

    • La page ou la base de données à surveiller.

    • L’événement (par exemple, « page créée dans la base de données »).

    • Tout filtre ou condition supplémentaire, le cas échéant.

  4. Enregistrer.

Utiliser les déclencheurs Slack

Les déclencheurs Slack permettent aux agents de surveiller les événements dans les canaux Slack publics. Les agents peuvent être déclenchés par un message publié sur un canal, une réaction émoji ajoutée à un message, un fil de discussion démarré dans un canal ou une mention d’agent personnalisé dans un message.

Pour ajouter un déclencheur Slack :

  1. Connectez Slack à votre agent lors de la configuration si vous ne l’avez pas déjà fait.

  2. Dans Déclencheurs, ajoutez un déclencheur Slack.

  3. Sélectionnez :

    • Le type d’événement.

    • Le canal à surveiller.

    • Tout filtre ou condition supplémentaire, le cas échéant.

  4. Enregistrer.

Note:

  • If you want to @mention a Custom Agent by name in Slack, your Slack workspace owner needs to allow members to create user groups. This is a Slack requirement (not a Notion setting).

  • Saved or "Later" messages in Slack are not supported.

Les agents personnalisés n’utilisent que le contenu auquel vous leur accordez explicitement l’accès pour leur travail. Vous configurez cela dans les paramètres d’accès de chaque agent.

Donnez à un agent personnalisé l’accès au contenu de votre espace de travail

Pour contrôler ce qu’un agent peut voir dans Notion :

  1. Ouvrez les paramètres de votre agent personnalisé.

  2. Accédez à la section Outils et accès.

  3. Ajoutez des pages ou des bases de données spécifiques que l’agent doit utiliser comme contexte :

    • Accordez l’accès au Centre d’aide pour une couverture qui inclut le contenu d’aide de Notion.

    • Accordez l’accès aux pages partagées avec tous les membres de Notion si vous souhaitez une couverture étendue qui inclut du contenu dans tout l’espace de travail.

    • Ajoutez des pages et des bases de données ciblées pour des flux de travail ciblés (par exemple, « Tickets clients », « Bugs », « Incidents »).

  4. Limitez l’accès à « aucun » ou à un petit ensemble de pages si vous souhaitez une portée plus étroite.

Linking to Notion pages in your Instructions doesn’t add them to the connected Tools and Access.

Autoriser ou bloquer l’accès au Web

Les agents peuvent éventuellement naviguer sur le Web si nécessaire. Utilisez l’accès Web lorsque votre flux de travail dépend d’informations externes. Désactivez-le pour les flux de travail strictement internes ou lorsque vous souhaitez un contrôle plus strict sur les sources. Pour contrôler l’accès au Web :

  1. Ouvrez les paramètres de votre agent.

  2. Trouvez l’option Accès Web.

  3. Activez l’accès Web pour permettre à l’agent de récupérer des informations sur Internet.

  4. Désactivez l’accès Web pour restreindre l’agent à Notion et aux applications configurées uniquement.

Donner aux agents personnalisés l’accès à Slack

Les agents personnalisés peuvent lire et écrire sur Slack via une intégration dédiée. Avant de connecter Slack à votre agent personnalisé, un administrateur ou une administratrice doit d’abord connecter le connecteur IA de Slack à votre espace de travail via les paramètres de l’IA de Notion. Les agents peuvent effectuer les opérations suivantes :

  • Lire les canaux publics.

  • Publier des messages, des réponses et des mises à jour sur les canaux.

  • Réagir aux fils de discussion et utiliser les informations de Slack comme contexte.

Private messages and Slack grid are currently unsupported.

Pour connecter Slack :

  1. Lors de la configuration de l’agent, suivez l’instruction pour connecter Slack.

  2. Assurez-vous que le compte Slack utilise la même adresse e-mail que votre compte Notion.

  3. Approuvez les champs d’application demandés dans le flux d’autorisation de Slack.

  4. Choisissez les canaux auxquels l’agent peut accéder.

Les agents personnalisés peuvent fonctionner sur différents grands modèles de langage. Cela vous permet d’équilibrer la vitesse, le coût et la qualité. Vous pouvez ajuster le modèle au fil du temps si votre flux de travail change ou si vous constatez des besoins de performance différents. Les modèles pris en charge incluent Claude, GPT et Gemini. Auto est la valeur par défaut recommandée.

Pour choisir un modèle :

  1. Ouvrez les paramètres de votre agent personnalisé.

  2. Accédez à la section Modèle.

  3. Sélectionnez un modèle spécifique si vous souhaitez un comportement cohérent, ou sélectionnez Auto pour laisser Notion choisir le meilleur modèle par demande.

  4. Enregistrer.

Les agents personnalisés se comportent comme des pages Notion lorsqu’il s’agit de partager avec d’autres personnes dans votre espace de travail, à quelques différences près.

Partagez des agents avec votre équipe

Lorsqu’ils sont partagés, les agents peuvent apparaître dans la barre latérale sous une section Agents, dans les résultats de recherche et dans toute zone de l’espace de travail qui répertorie ou référence les agents.

Pour partager un agent :

  1. Ouvrez la page de l’agent personnalisé.

  2. Cliquez sur Partager.

  3. Ajoutez des personnes, des groupes ou l’ensemble de l’espace de travail.

Niveaux d’autorisation

Les agents utilisent un ensemble simplifié de niveaux d’autorisation :

  • Accès completLes personnes avec les autorisations d’accès complet à un agent peuvent configurer les instructions, les déclencheurs, l’accès et les modèles, afficher et gérer les journaux d’activité, et exécuter ou interagir avec l’agent.

  • Peut modifierLes personnes avec les autorisations Peut modifier pour un agent peuvent modifier les instructions et la configuration et examiner l’activité.

  • Peut voir et interagirLes personnes avec les autorisations Peut voir et interagir avec un agent peuventexécuter l’agent et discuter avec lui et afficher la page Paramètres (Déclencheurs, Instructions, Outils et Accès) en mode lecture seule. Elles ne peuvent pas modifier ou partager l’agent.

Users without access may still trigger or interact with agents configured to respond to events like Slack messages in accessible channels.

Une fois votre agent personnalisé créé, il apparaîtra dans la barre latérale. Chaque page d’agent personnalisé comporte trois onglets principaux. Utilisez ces onglets ensemble pour concevoir, tester et maintenir un agent au fil du temps.

  1. Chat Un espace de conversation privé ou partagé en tête-à-tête pour cet agent spécifique.

    • Utile pour tester de nouvelles instructions, demander à l’agent d’exécuter des tâches ponctuelles et itérer sur le comportement.

  2. Activité Un journal de chaque exécution d’agent visible pour les personnes avec un accès complet.

    • Les journaux incluent ce qui a déclenché l’exécution, les actions entreprises et les erreurs ou échecs.

  3. Paramètres Le centre de contrôle de l’agent.

    • Le panneau Paramètres comprend les instructions de l’agent, les déclencheurs, les autorisations d’accès et la sélection du modèle.

Treat configuration as a conversation. Use Custom Agent Chat to test, debug, and iterate on your instructions. Ask the agent to run one-off tasks, provide context on errors, and test different scenarios.

Utilisez l’onglet Paramètres pour modifier un agent

  1. Ouvrez la page de l’agent.

  2. Accédez à l’onglet Paramètres.

  3. Mettez à jour les instructions, les déclencheurs, l’accès aux pages, aux bases de données et aux outils externes, ou la sélection de modèles.

  4. Enregistrez et publiez vos modifications.

  5. Utilisez l’onglet Chat et l’onglet Activité pour vérifier que l’agent se comporte comme prévu après les modifications.

Annuler une modification avec l’historique des versions

Pour restaurer une version précédente de votre agent personnalisé :

  1. Ouvrez la page de l’agent.

  2. Accédez à l’historique des versions.

  3. Passez en revue les versions précédentes pour voir :

    • Qui a apporté des modifications.

    • Quand elles ont été faites.

    • Ce qui a changé dans chaque version.

  4. Sélectionnez la version que vous souhaitez restaurer.

  5. Confirmez pour rétablir l’agent à cette version.


Questions fréquentes

How is this different from Notion Agent in the bottom right corner?

Notion Agent helps you:

  • Draft, edit, and summarize content.

  • Answer questions about pages and databases.

  • Perform one-off tasks while you work.

Custom Agents:

  • They follow precise instructions you define.

  • They can run autonomously in the background via triggers and schedules.

  • They operate only on the pages, databases, and external tools you explicitly grant.

Notion Agent is on-demand, whereas Custom Agents are autonomous.

If a run fails, how can I debug it?

To debug a run:

  1. Open the agent page.

  2. Go to the Activity tab in the agent's Settings or from the agent chat view.

  3. Find the failing run in the list.

  4. Open it to see:

    • What triggered the run.

    • What the agent "thought" and did at each step.

    • Any error messages or explanations.

If the agent behaved incorrectly:

  • Adjust its instructions or triggers.

  • Re-run with updated configuration.

  • If something looks wrong or suspicious, provide a thumbs-down and a detailed description where available so the team can improve the system.

What Slack app do I need to connect?

To use Slack with Custom Agents:

  1. Make sure Slack is connected with the same email address you use for Notion.

  2. When prompted during agent setup, connect the Slack app even if you already use Slack elsewhere in Notion.

  3. Approve access and configure which channels the agent can read or write to.

Who can create and see Custom Agents?

  • Custom Agents are available to everyone in the workspace by default.

    • Enterprise plan Admins can restrict access by going to Settings > Notion AI >

      Agents > Control who can create agents.

  • For each agent:

    • The creator decides who can access it and at what level (Full access, Can edit, Can interact).

    • In Slack, anyone in a channel can see messages posted by that channel's agents.

How will I know where this agent is going to run?

While configuring an agent, check:

  1. Triggers to see:

    • Which schedules are active.

    • Which Notion databases or pages are watched.

    • Which Slack channels or other apps are connected.

  2. Access / Permissions to see:

    • Which pages, databases, and external sources the agent can use.

  3. Activity to see:

    • Where the agent has already run and what it did.

After you publish:

  • Use the Activity tab and logs to confirm agents are running only where expected.

  • Review runs regularly to keep behavior aligned with your workflows.

D’autres questions ? Envoyez un message au service client

Donner votre avis

Cette ressource vous a-t-elle été utile ?


Powered by Fruition