Individuellen Code mit Workern ausführen (Beta)

Notion Workers sind Teil unserer Developer Platform. Sie führen benutzerdefinierten Code auf der Infrastruktur von Notion aus, um Folgendes zu ermöglichen:

• Datenbank-Synchronisierung

• Tools für Custom Agents

• Webhook-Auslöser

• Worker sind im Business und Enterprise Plan verfügbar.

• Standardmäßig sind Workers für den Workspace aktiviert (nur für Besitzer/-innen).

• Workspace-Besitzer/-innen können:

  • Beschränke die Erstellung von Workers auf Besitzer/-innen.

  • Bestimmten Mitgliedern oder Gruppen erlauben, Workers zu erstellen.

  • Workers für den Workspace deaktivieren.

• Wenn du versuchst, einen Worker bereitzustellen oder zu verwalten, befolgst du in der Regel unsere Entwicklerdokumentation und verwendest die Notion CLI.

• Du kannst den Entwicklermodus aktivieren, um Worker in Notion anzuzeigen, Protokolle zu lesen und Worker zu deaktivieren oder zu löschen. Um einen Worker bereitzustellen oder seinen Code oder seine Einrichtung zu ändern, verwende die Notion CLI oder das Coding-Tool deines Teams. Erfahre mehr über den Entwicklermodus →

Weitere Informationen zu den Preisen für Worker findest du in diesem Artikel.

Die Datenbanksynchronisierung (unterstützt durch Worker) überträgt 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 aktuell, sodass dein Team und deine Agents 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 standardmäßigen Notion-Freigabeberechtigungen geregelt.

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.

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.

Mit dem Entwicklermodus kannst du Workers über den Entwicklerbereich in deiner Seitenleiste öffnen. Nutze diese Ansicht für schnelle Überprüfungen und grundlegende Aktionen. In Notion kannst du:

• Alle Workers in einer Liste sehen.

• Einen Worker öffnen und Übersicht, Protokolle, Umgebungsvariablen und Einstellungen anzeigen.

• Worker-Protokolle lesen.

• Einen Worker deaktivieren oder löschen.

Um einen Worker bereitzustellen oder seinen Code oder seine Einrichtung zu ändern, verwende die Notion CLI oder das Coding-Tool deines Teams.

Standardmäßig kann nur die Person, die einen Worker erstellt hat, ihn bearbeiten oder als neue Verbindungen hinzufügen. Teile einen Worker mit deinen Teammitgliedern, damit sie ihn mit einem Custom Agent verbinden oder bei der Verwaltung helfen können.

Erfahre mehr darüber, wie du einen Worker teilst →

Führe die folgenden Schritte der Reihe nach aus:

1. Stelle sicher, dass dein Workspace berechtigt ist und dass ein Workspace-Besitzer/-in Workers aktiviert hat. Workers sind in Business- und Enterprise Plan verfügbar und erfordern die Aktivierung durch einen Workspace-Admin.

2. Bestätige, dass du den vorgesehenen Lernpfad verwendest. Für die meisten Setups verwendest du die Notion CLI plus die Entwicklerdokumentation.

3. Wenn die Bereitstellung deines Worker fehlschlägt, überprüfe als Nächstes die Berechtigungen. Möglicherweise hast du keinen Zugriff auf die Bereitstellung in diesem Workspace, auch wenn du Seiten darin anzeigen kannst.

4. Wenn dein Worker zur Ausführung kommt, aber nichts in Notion ändert, teste die Aktion zuerst manuell. Wenn du die gleiche Änderung nicht in Notion vornehmen kannst, liegt dies normalerweise an einem Berechtigungs- oder Workspace-Einstellungsproblem.

5. Wenn die Kosten höher als erwartet ausfallen, verringere die Ausführungshäufigkeit. Workers, die häufiger zur Ausführung kommen, kosten mehr. Beginne mit einem langsameren Zeitplan und erhöhe ihn, sobald du sicher bist, dass er funktioniert.

6. Immer noch nicht weitergekommen? Folge der Entwicklerdokumentation für die spezifische Fehlermeldung. Dort findest du die genaueste Lösung.