Comprendre la tarification des workers (bêta)

Les workers exécutent du code en arrière-plan pour automatiser des tâches dans Notion. Ils sont parfaits pour les tâches qui ne nécessitent pas de raisonnement par l’IA, telles que la synchronisation de données, la rédaction de mises à jour et la gestion d’événements. Les workers sont souvent associés à des agents personnalisés : l’agent décide de ce qu’il faut faire et les workers exécutent efficacement des étapes spécifiques.

Pendant la phase bêta, les workers sont gratuits pour les forfaits Business et Enterprise (y compris les essais Business). À partir du 11 août 2026, ils nécessiteront des crédits Notion. Les administrateur·rices d’espace de travail peuvent acheter des crédits Notion en tant que module complémentaire pour les forfaits Business et Enterprise.

La période bêta gratuite s’applique uniquement aux workers. Les actions des agents personnalisés consommeront des crédits en fonction de l’offre et des paramètres de crédits de votre espace de travail.

Les workers utilisent des crédits Notion qui sont comptabilisés sous forme d’exécutions. Chaque exécution représente une unité de travail effectuée en votre nom. Le nombre de crédits par exécution peut varier en fonction de la quantité de travail effectuée par le worker, par exemple la durée de son exécution ou la quantité de traitement nécessaire. En général, plus la tâche est importante, plus le nombre de crédits consommés est élevé.

Les workers peuvent s’exécuter de plusieurs manières (et nous continuerons à étoffer cette liste) :

• Synchronisations (programmées) : Chaque synchronisation compte comme une exécution.

• Appels d’outils (déclenchés par l’agent) : Chaque appel d’outil de worker déclenché par un agent personnalisé compte comme une exécution.

• Webhooks (déclenchés par des événements) : Chaque événement traité par un worker compte comme une exécution.

Les workers coûtent généralement 0,0003 $ par exécution, ce qui correspond à 33 333 exécutions pour 1000 crédits Notion par mois (10 $). Ils sont moins chers que les agents personnalisés, car leur tarification est basée sur la quantité de travail qu’ils effectuent lorsqu’ils s’exécutent sans nécessiter une de prise de décision par l’IA.

Les tables ci-dessous présentent de manière détaillée les coûts de référence pour chaque type d’action des workers. Utilisez ces informations comme point de départ pour comprendre les coûts. Votre utilisation réelle peut varier et constitue le meilleur moyen de déterminer la quantité de crédits nécessaire.

La table ci-dessous présente des exemples d’utilisation. Votre utilisation réelle dépend de la fréquence d’exécution de vos synchronisations et de la quantité de travail effectuée par un worker lors de chaque exécution.

La synchronisation d’un plus grand nombre de données ou la gestion de plusieurs mises à jour coûtera plus cher. Si vous avez plusieurs synchronisations, plusieurs workers ou des workers qui s’exécutent en réponse à de nombreux événements, l’utilisation totale peut être plus élevée.

Les workers peuvent également alimenter des outils personnalisés utilisés par les agents personnalisés. Par exemple, un agent personnalisé peut appeler un worker pour récupérer des données d’un autre système, effectuer un calcul ou mettre à jour des enregistrements.

L’utilisation des appels d’outils dépend de la fréquence à laquelle un agent appelle un worker. Chaque appel d’outil compte comme une exécution de worker distincte (ainsi, une exécution d’agent peut générer plusieurs exécutions de worker).

La table ci-dessous présente des volumes de webhooks typiques et leur coût potentiel. Votre utilisation réelle dépend du nombre d’événements envoyés par vos outils et du nombre de déclencheurs de webhooks que vous avez configurés. Chaque événement entrant que vous traitez compte comme une exécution par un worker. Le coût total évolue donc en fonction de votre volume d’événements.

Dans la version bêta gratuite, vous pouvez suivre l’utilisation des crédits par le Worker directement dans la CLI, y compris pour les sept derniers jours d’utilisation. L’utilisation des Workers apparaîtra également dans le tableau de bord des crédits Notion d’ici la fin du mois de mai, afin que les administrateurs puissent suivre l’utilisation des crédits pour les Workers et les agents personnalisés au même endroit.

Les Workers sont gratuits dans la version bêta ; vous pouvez donc profiter de cette période pour exécuter des processus réels et estimer le nombre de crédits dont vous aurez besoin une fois que les crédits seront appliqués.

Essayez d’appliquer les meilleures pratiques ci-dessous pour que l’utilisation des Workers reste prévisible :

• Commencez par une fréquence peu élevée. Pour les synchronisations, commencez par des exécutions horaires ou quotidiennes si des mises à jour en temps réel ne sont pas nécessaires.

• Augmentez la fréquence uniquement si nécessaire. Passez à une fréquence de 15 minutes, 5 minutes ou une minute uniquement si le flux de travail l’exige.

• Effectuez des traitements par lots autant que possible. Au lieu d’exécuter un Worker pour chaque petit changement, regroupez les mises à jour.

• Synchronisez uniquement ce dont vous avez besoin. Synchronisez uniquement les bases de données, les enregistrements ou les champs nécessaires.

• Évitez les nouvelles tentatives inutiles. Si un Worker échoue, assurez-vous qu’il ne fait pas de nouvelles tentatives trop fréquemment sans que le problème sous-jacent soit résolu.

• Examinez régulièrement l’utilisation. Vérifiez l’utilisation de la CLI lors de la configuration et après des modifications majeures du flux de travail.