Talleres ShipSF - Taller de mini-workers con Notion

Highlights

• Los workers de Notion funcionan como un motor de ejecución basado en un SDK para ampliar Notion con código personalizado escrito por agentes o desarrolladores.

• La infraestructura de Vercel Sandbox aísla la ejecución de código arbitrario para prevenir problemas como minería de criptomonedas y ataques de denegación de servicio.

• El proxy de Vercel implementa credenciales intermediadas que inyectan tokens en las solicitudes salientes justo a tiempo, evitando que el código aislado almacene credenciales.

• La interfaz de desarrollo de un worker requiere un módulo exportado que contenga el nombre, la descripción, el esquema de entrada y la función de ejecución.

• Los agentes gestionan las herramientas mediante la CLI de NTM, consultando listas simples de nombres y descripciones para evitar saturar la ventana de contexto.

Timeline

1. 00:00 - 02:30

   Concepto y capacidades de los workers

   Se introduce el concepto de los workers como un motor de ejecución y SDK para integrar código en Notion. Se detallan tres capacidades principales: herramientas de agentes, sincronizaciones de datos y automatizaciones. Además, se contrasta esta tecnología con los modelos MCP tradicionales debido a su manejo avanzado de credenciales y despliegue.

   • Los workers extienden Notion mediante código personalizado ejecutado por agentes o usuarios.
   • Las capacidades principales incluyen herramientas para agentes, sincronizaciones de datos externos y automatizaciones deterministas.
   • La interfaz simplifica el acceso a credenciales en comparación con otras alternativas como MCP.
2. 02:30 - 04:40

   Seguridad e infraestructura con Vercel Sandbox

   La seguridad representa una prioridad al alojar código arbitrario de usuarios y agentes. Para mitigar riesgos de ataques y uso malicioso de recursos de cómputo, la plataforma se integra con Vercel Sandbox. Mediante el uso de credenciales intermediadas, el entorno aislado nunca recibe directamente las credenciales, bloqueando posibles robos de información.

   • Vercel Sandbox aísla la ejecución para evitar minería de criptomonedas y ataques de denegación de servicio.
   • El sistema previene que agentes malintencionados registren credenciales en sus ventanas de contexto.
   • El proxy de Vercel inyecta credenciales en las cabeceras de red salientes justo a tiempo durante las llamadas a API.
3. 04:40 - 11:00

   Demostración de un agente con workers

   Se muestra una demostración práctica donde un agente utiliza herramientas de worker para interactuar con la plataforma Forkable y realizar pedidos de comida de forma automática. Asimismo, se demuestra un agente básico que planifica una ruta a un museo combinando datos de transporte y mapas sin consumir excesivos recursos de razonamiento.

   • Un agente autónomo gestiona pedidos de almuerzo semanales mediante herramientas personalizadas.
   • Un agente simple ejecuta código determinista para planificar rutas hacia museos de arte usando datos en vivo.
   • Las herramientas permiten resolver tareas complejas de manera económica sin necesidad de un razonamiento avanzado.
4. 11:00 - 17:00

   Estructura del código y despliegue

   Se explica el diseño técnico de un worker a partir de módulos de TypeScript. El proceso de despliegue compila el código de forma segura dentro de un sandbox en la nube mediante un paquete tarball. Posteriormente, el sistema analiza las exportaciones del módulo para generar esquemas validados que el agente puede consumir.

   • El código del usuario define el nombre exportado, la descripción, el esquema de entrada y la función de ejecución.
   • El sandbox procesa el código fuente subido a almacenamiento en blobs para empaquetarlo y extraer metadatos.
   • La serialización a JSON elimina funciones no serializables y permite validar la estructura de la herramienta.
5. 17:00 - 28:43

   Ejecución de herramientas y gestión de contexto

   Se detallan los mecanismos de ejecución en tiempo de ejecución, incluyendo el uso de instantáneas y el análisis de la salida estándar. Se abordan preguntas sobre la gestión del contexto al crear múltiples herramientas, explicando que el agente consulta únicamente los nombres y descripciones básicos mediante la CLI de NTM.

   • Las invocaciones de herramientas cargan instantáneas limpias del sandbox para garantizar estados independientes.
   • La salida estándar del proceso se analiza envolviendo los resultados relevantes en etiquetas XML con límites de tamaño.
   • Los agentes revelan sus herramientas de forma progresiva a través de la CLI de NTM para proteger la ventana de contexto.