Individuellen Code mit Workern ausführen (Beta)
Erfahre, was Worker sind und wofür sie verwendet werden 🔨
Zu den FAQsNotion-Worker sind Teil unserer Developer Platform. Sie führen individuellen Code in der Notion-Infrastruktur aus, um Folgendes zu ermöglichen:
Datenbank-Synchronisierung
Tools für Custom Agents
Webhook-Auslöser
Die technische Einrichtung findest du in der Dokumentation für Entwickler/-innen.
Weitere Informationen zu den Preisen findest du in diesem Artikel.
Das solltest du wissen, bevor du loslegst
Worker sind im Business und Enterprise Plan verfügbar.
Ein/-e Workspace-Besitzer/-in muss Worker für den Workspace aktivieren.
Wenn du versuchst, einen Worker bereitzustellen oder zu verwalten, befolgst du in der Regel unsere Entwicklerdokumentation und verwendest die Notion-CLI.
Preise und Verfügbarkeit von Plänen für Worker
Weitere Informationen zu den Preisen für Worker findest du in diesem Artikel.
Datenbank-Synchronisierung
Die Datenbanksynchronisierung (mit Workern) bringt Informationen aus externen Tools in eine Notion-Datenbank und hält sie automatisch auf dem neuesten Stand. Sobald sie eingerichtet ist, bleibt die synchronisierte Datenbank von selbst auf dem neuesten Stand, sodass dein Team und deine Agenten immer die neuesten Daten sehen, ohne dass jemand zwischen den Tools kopieren oder einfügen muss.
Ein paar gängige Beispiele:
Synchronisieren von Zendesk-Support-Tickets mit einer Priorisierungs-Datenbank
Synchronisieren von Salesforce-Konten mit einem Pipeline-Tracker
Synchronisieren von Daten aus einem internen Tool oder einer internen Datenbank
Sobald sie live ist, verhält sich die synchronisierte Datenbank wie jede andere Datenbank in Notion. Der Zugriff wird durch deine Standard-Freigabeberechtigungen in Notion geregelt.
Agenten-Tools
Agenten-Tools (mit Workern) erweitern die Möglichkeiten deiner Custom Agents über die integrierten Aktionen von Notion und MCP hinaus, mit Funktionen, die auf die Arbeitsweise deines Teams zugeschnitten sind.
Ein paar gängige Beispiele:
Abfragen eines Data Warehouse
Generieren von Assets aus einem Notion-Dokument
Ausführen von Aktionen in einer anderen App, die nicht nativ unterstützt oder über MCP verfügbar ist
Webhook-Auslöser
Mit Webhook-Triggern (mit Workern) kann ein Ereignis in einem anderen Tool einen Workflow in Notion oder einem anderen verbundenen System starten.
Ein paar gängige Beispiele:
Schließen einer Aufgabe, wenn ein Pull-Request gemerged wird
Aktualisieren eines CRM-Datensatzes, wenn sich ein Abo ändert
Erstellen eines Onboarding-Dokuments, wenn ein Angebot unterzeichnet wird
Sobald er eingerichtet ist, wird der Workflow jedes Mal automatisch ausgeführt, wenn das Ereignis eintritt, sodass dein Team Informationen nicht manuell zwischen den Tools verschieben muss.
Wenn etwas nicht funktioniert
Führe die folgenden Schritte der Reihe nach aus:
Stelle sicher, dass dein Workspace berechtigt ist und dass ein/-e Workspace-Besitzer/-in Worker aktiviert hat. Worker sind im Business und Enterprise Plan verfügbar und müssen von einem Workspace-Admin aktiviert werden.
Vergewissere dich, dass du den vorgesehenen Einrichtungspfad verwendest. Bei den meisten Einrichtungsvorgängen verwendest du die Notion CLI sowie die Dokumente für Entwickler/-innen.
Wenn die Bereitstellung deines Workers fehlschlägt, überprüfe als Nächstes die Berechtigungen. Möglicherweise hast du keinen Zugriff auf die Bereitstellung in diesem Workspace, auch wenn du die darin enthaltenen Seiten anzeigen kannst.
Wenn dein Worker ausgeführt wird, aber nichts in Notion ändert, teste die Aktion zunächst manuell. Wenn du dieselbe Änderung in Notion nicht vornehmen kannst, liegt das in der Regel an einem Problem mit den Berechtigungen oder den Workspace-Einstellungen.
Wenn die Kosten höher ausfallen als erwartet, verringere die Ausführungshäufigkeit. Worker, die häufiger ausgeführt werden, kosten mehr. Beginne mit einem langsameren Zeitplan und erhöhe die Ausführungsfrequenz, sobald du sicher bist, dass alles funktioniert.
Du kommst trotzdem nicht weiter? Befolge die Anweisungen in den Dokumenten für Entwickler/-innen für die jeweilige Fehlermeldung. Dort findest du die genaueste Lösung.
FAQs
Wie unterscheiden sich Worker von Custom Agents?
Wie unterscheiden sich Worker von Custom Agents?
Worker und Personalisierte Agenten lösen unterschiedliche Probleme, können aber zusammenarbeiten.
Worker: Führen individuellen Code in der Notion-Infrastruktur aus. Entwickler/-innen verwenden Worker beispielsweise für Automatisierungen, geplante Synchronisierungen und individuelle Integrationen.
Personalisierte Agenten: Erledigen Routineaufgaben für dein Team automatisch. Du legst Auslöser fest, und sie werden im Hintergrund ausgeführt, wobei dein Workspace als Kontext dient.
In einigen Konfigurationen kann ein Worker ein einzigartiges Tool bereitstellen, das ein Personalisierter Agent verwenden kann. Ein Worker könnte beispielsweise Daten aus einem anderen System abrufen, und der Agent kann diese Daten verwenden, um zu reagieren oder Maßnahmen zu ergreifen.
Sind Worker dasselbe wie Automatisierungen?
Sind Worker dasselbe wie Automatisierungen?
Nicht ganz. Automatisierungen sind in Notion integriert und können von jedem eingerichtet werden. Worker sind für Entwickler/-innen gedacht, die individuellen Code ausführen möchten. Wenn du keinen Code benötigst, beginne mit Automatisierungen.
Werden Worker auf meinen Servern ausgeführt?
Werden Worker auf meinen Servern ausgeführt?
Nein. Worker werden auf den Servern von Notion ausgeführt, sodass du keine Infrastruktur einrichten oder verwalten musst.
Benötige ich die CLI, um Worker zu verwenden?
Benötige ich die CLI, um Worker zu verwenden?
Nicht unbedingt, um Worker zu verwenden, aber in der Regel benötigst du die CLI, um sie einzurichten und bereitzustellen. Entwickler/-innen können die Anweisungen in den Dokumenten für Entwickler/-innen befolgen, um loszulegen.
