ShipSF Workshops - Mini-Worker-Workshop mit Notion

Highlights

• Notion Worker sind ein SDK und eine Laufzeitumgebung, um Notion mit benutzerdefiniertem Code von Agenten oder Entwicklern zu erweitern.

• Vercel Sandbox verhindert Angriffe wie Krypto-Mining oder Denial-of-Service durch isolierte und faire Rechenressourcen.

• Durch Brokered Credentials sendet der Vercel-Proxy Zugangsdaten erst im letzten Moment in ausgehende Header, ohne dass die Sandbox dauerhaft Zugriff darauf hat.

• Agenten generieren über die ntmcli ihre eigenen Tools selbst, validieren Formate über Zod und führen deterministischen Code aus.

• Eine Sandbox-Ausführung bricht in der Produktionsumgebung nach fünf Minuten ab, um Endlosschleifen und unnötige Kosten zu verhindern.

Timeline

1. 00:00 - 02:28

   Einführung in Notion Worker und Anwendungsfälle

   Die Einführung erläutert die Grundlagen von Notion Workern als SDK und Laufzeitumgebung. Entwickler und KI-Agenten nutzen sie, um Smart Homes zu verwalten oder echte Geschäfte zu automatisieren. Im Gegensatz zu lokalen Agenten-Skills oder MCPs bieten Worker eine standardisierte Schnittstelle, die über die ntmcli verwaltet wird.

   • Worker erweitern Notion durch benutzerdefinierten Code von Agenten oder Menschen.
   • Anwendungsbereiche umfassen Smart-Home-Steuerung, Geschäftsprozesse und interne Tool-Zugriffe.
   • Es gibt drei Funktionsbereiche: Agenten-Tools, Syncs für externe Daten und deterministische Automatisierungen.
   • Worker-Tools erlauben Agenten die eigenständige Erweiterung ohne feste MCP-Abhängigkeiten.
2. 02:28 - 04:43

   Sicherheit und Sandbox-Architektur mit Vercel

   Beim Ausführen von beliebigem Code durch Agenten stehen Sicherheit und Rechenleistung im Vordergrund. Um Krypto-Mining und Datenabfluss zu verhindern, arbeitet das System mit Vercel zusammen. Die Brokered Credentials sorgen dafür, dass die Sandbox selbst niemals sensible Schlüssel erhält, da der Proxy die Daten erst beim Netzwerkaufruf einfügt.

   • Sicherheitsbedenken betreffen schädlichen Code, Krypto-Mining und DoS-Angriffe.
   • Vercel Sandbox schützt die Infrastruktur vor unkontrolliertem und schädlichem Benutzer-Code.
   • Brokered Credentials fügen API-Schlüssel erst im ausgehenden Proxy-Header ein.
   • Sandbox-Isolation hindert Agenten daran, Zugangsdaten dauerhaft auszulesen oder zu protokollieren.
3. 04:43 - 08:35

   Praxisbeispiel: Automatische Essensbestellung

   Ein konkreter Anwendungsfall zeigt einen Agenten, der wöchentlich das Mittagessen für den Benutzer plant und bestellt. Der Agent nutzt dafür selbst geschriebene Worker-Tools, analysiert vergangene Bestellungen und interagiert mit der Plattform Forkable. Nach einer erfolgreichen Empfehlung wird die Bestellung ohne manuelle Zwischenschritte ausgelöst.

   • Ein wöchentlich laufender Agent bestellt eigenständig Mittagessen über Forkable.
   • Der Agent greift auf vergangene Bestellungen und tagesaktuelle Restaurant-Menüs zu.
   • Bestellungen werden automatisch im System aktualisiert und im Protokoll festgehalten.
4. 08:35 - 13:00

   Agenten-Agenten-Kommunikation und Tool-Erstellung

   Die Demo zeigt einen Agenten, der trotz geringer eigener Schlussfolgerungsfähigkeit komplexe Aufgaben wie die Routenplanung für Museen löst. Er nutzt dafür deterministischen Code, der Live-Daten verarbeitet. Der Quellcode wird lokal in ein Tarball-Paket konvertiert und für die Ausführung vorbereitet.

   • Ein einfacher Streaming-Agent demonstriert deterministische Routen- und Ausflugsplanung.
   • Agenten verarbeiten Live-Daten von Verkehrs-APIs und OpenStreetMap.
   • Quellcode wird lokal kompiliert, verpackt und in den Blob-Speicher geladen.
5. 13:00 - 19:50

   Extraktion, Validierung und Ausführung von Tool-Schemata

   Um Agenten die Nutzung des Codes zu ermöglichen, extrahiert das System die Schnittstellen über ein JSON-Format aus dem Modul-Export. Die Ausgaben werden in der Standardausgabe protokolliert und validiert. Für jeden Tool-Aufruf wird ein frischer Sandbox-Snapshot geladen, und Prozesse erhalten ein hartes Zeitlimit von fünf Minuten.

   • JSON stringify entfernt nicht-serialisierbare Funktionen und extrahiert reine Tool-Schemata.
   • Standardausgabe und XML-Tags umschließen relevante Ergebnisse für den Agenten.
   • Sandboxes nutzen Snapshots für schnelle Neustarts und frische Ausführungszustände.
   • Laufzeiten von mehr als fünf Minuten in der Produktion brechen den Prozess automatisch ab.
6. 19:50 - 28:43

   Frage-und-Antwort-Runde: Anwendungsfälle und Sicherheit

   In der Fragerunde werden Themen wie Kontextfenster-Optimierung, Cloud-Funktions-Vergleiche und Authentifizierung besprochen. Agenten listen Tools modular auf, um Überlastungen zu vermeiden. Zudem korrigieren sich Agenten bei fehlerhaften Tool-Parametern eigenständig über ihren integrierten Speicherkontext.

   • Tool-Listen werden progressiv angezeigt, um das Kontextfenster nicht zu überlasten.
   • Enterprise-Beispiele umfassen die automatisierte Einreichung von Versicherungsansprüchen.
   • Die Bereitstellung neuer Worker erfordert lediglich den Befehl NTN workers deploy.
   • Fehlgeschlagene Tool-Aufrufe erlauben Agenten die direkte Selbstkorrektur im Speicherkontext.