Воркшопы ShipSF — воркшоп по созданию мини-воркеров с Notion

하이라이트

• Воркеры Notion представляют собой среду выполнения и SDK для расширения возможностей агентов с помощью пользовательского кода, развертываемого в песочницах Vercel.

• Функция проксирования учетных данных Vercel внедряет токены в сетевые запросы «точно в срок», не передавая их в песочницу, что защищает от утечек при компрометации кода агента.

• Для предотвращения раздувания контекстного окна агент запрашивает через NTM CLI только имена и описания доступных инструментов без загрузки полных схем ввода.

• Лимит времени выполнения кода в песочнице в продакшене составляет пять минут, после чего процесс принудительно завершается для предотвращения избыточного потребления ресурсов.

• Процесс развертывания инструмента требует компиляции TypeScript, упаковки в тарбол, загрузки в хранилище Blob и сериализации модуля для проверки схемы через Zod.

타임라인

1. 00:00 - 04:40

   Архитектура воркеров и безопасность песочницы Vercel

   Разработчики и ИИ-агенты создают инструменты без необходимости ожидания сторонних интеграций через протокол MCP. Прямой доступ агентов к коду создает риски случайного логирования конфиденциальных данных, поэтому архитектура безопасности исключает передачу секретов внутрь среды выполнения.

   • Воркеры расширяют Notion пользовательским кодом, выполняя функции инструментов агентов, синхронизаторов или детерминированных автоматизаций.
   • Интеграция с песочницей Vercel защищает производственные системы от вредоносного кода, майнинга криптовалюты и атак типа «отказ в обслуживании».
   • Посреднические учетные данные Vercel внедряют ключи доступа в исходящие запросы «точно в срок», исключая их сохранение в песочнице.
2. 04:40 - 08:35

   Автоматизация заказа обедов через интеграцию с Forkable

   Агент самостоятельно выбирает еду на основе прошлых предпочтений пользователя. Все действия выполняются в фоновом режиме по расписанию, а журнал заказов обновляется для последующей корректировки рекомендаций.

   • Агент по заказу обедов работает по еженедельному расписанию, используя кастомные инструменты для проверки истории заказов и доступных ресторанов.
   • Инструменты воркера позволяют агенту самостоятельно взаимодействовать с платформой Forkable для оформления доставки.
3. 08:35 - 13:50

   Разработка кода воркера и схемы инструментов

   Создание воркера не требует сложных алгоритмов рассуждения от модели благодаря выносу логики в детерминированный код. Модули упаковываются в архив и передаются в среду выполнения для интеграции с Vercel AI SDK.

   • Простой агент на базе GPT-5 for Nano использует специализированные инструменты для детерминированного выполнения сложных задач вроде планирования маршрутов.
   • Код воркера экспортирует имя модуля, описание, схему ввода на базе Zod и функцию execute.
4. 13:50 - 22:30

   Процесс сборки, извлечения схем и оптимизация контекста

   Архитектура обрабатывает стандартный вывод песочницы, упаковывая результаты в специальные XML-теги для надежного парсинга. Ограничение длины логов и ограничение времени выполнения пятью минутами обеспечивают стабильность системы.

   • Песочница импортирует пользовательский модуль, выполняет сериализацию схемы через JSON stringify и проверяет структуру с помощью Zod.
   • Для защиты от раздувания контекстного окна агент запрашивает через NTM CLI только список имен и описаний инструментов.
5. 22:30 - 28:43

   Корпоративные сценарии применения и ответы на вопросы

   Участники воркшопа обсуждают безопасность совместного доступа к воркерам и обработку нестабильных сетевых соединений. Агент способен анализировать ошибки выполнения инструментов и корректировать дальнейшие шаги на основе системной памяти.

   • Корпоративные варианты использования включают автоматическую подачу страховых претензий с использованием внутренних API и токенов.
   • В отличие от AWS Lambda, воркеры развертываются значительно проще с помощью одной команды через CLI.
   • При сбое вызова инструмента сообщение об ошибке передается обратно агенту для самостоятельного исправления параметров.