ShipSF 工作坊 - Notion 迷你工作坊
원제 · ShipSF Workshops - Mini-workers workshop with Notion
핵심 요약
Notion 结合 Vercel Sandbox 推出了 Workers 功能，允许 AI 代理安全地编写、部署和调用自定义工具，并通过代理凭据注入与确定性执行机制解决安全性与上下文臃肿问题。
하이라이트
Notion Workers 是一种运行时和 SDK，允许用户通过自定义代码扩展 Notion，可用于构建代理工具、外部数据同步功能以及确定性自动化功能。
Vercel Sandbox 为 Notion Workers 提供基础设施，利用代理凭据功能在出站网络请求中即时注入凭据，防止沙盒和 AI 代理接触并泄露敏感凭据。
Notion 代理可以通过 ntmcli 界面可靠且安全地为自己构建、测试和部署工具，而无需等待外部开发者开发或直接向代理暴露静态凭据。
Worker 的用户代码包含模块导出键、工具名称、描述、输入架构以及执行函数，沙盒通过对模块进行 JSON 字符串化来自动提取工具架构并提供给智能体。
在处理不稳定或失败的工具调用时，沙盒会将错误信息直接反馈给智能体，使智能体能够根据当前的内存上下文和错误日志进行自我纠正。
타임라인
Notion Workers 简介与核心功能
Notion Workers 是一个运行时和 SDK，用户或 AI 代理可以通过它编写代码来管理智能家居、运营商店或访问内部数据库。相较于传统的本地脚本或 MCP，Worker 提供了已部署且可由代理可靠触发的接口，同时通过 ntmcli 屏蔽了底层基础设施和凭据管理的复杂性。
- Workers 允许通过自定义代码扩展 Notion，功能涵盖代理工具、数据同步和确定性自动化。
- Worker 工具作为原语，使代理能够可靠地扩展自身，且无需等待外部 MCP 开发者。
- ntmcli 接口将复杂的部署基础设施管理和凭据管理抽象隐藏在底层。
安全架构与 Vercel 代理凭据
托管和执行用户编写的任意代码面临严峻的安全挑战，包括恶意计算资源占用和流量攻击。由于 AI 代理可能在无人审核的情况下记录凭据，Notion 选择 Vercel 作为基础设施提供商，通过代理凭据（brokered credentials）在每次外部 API 调用时即时注入标头，从根本上杜绝了凭据泄露的风险。
- 系统需要严密防范任意代码带来的加密货币挖掘和拒绝服务攻击。
- AI 代理可能会无意中记录并泄露敏感凭据到其上下文窗口中。
- Vercel 的代理凭据功能在出站网络请求时即时注入凭据，沙盒和代理永不直接接触凭据。
Worker 工具实际演示与代码接口
实际演示展示了 AI 代理通过调用过往订单和餐厅选择工具，自动在 Forkable 平台为用户预定午餐。随后展示了另一个集成 Muni 数据和 OpenStreetMap 的出行规划工具，证明了笨代理通过确定性代码也能高效处理复杂任务。
- AI 代理能够自主编写并使用 Worker 工具完成日常订餐等确定性复杂任务。
- 简单的流式代理聊天演示展示了无网络搜索能力的代理如何通过确定性代码规划出行路线。
- Worker 用户代码通过模块导出工具名称、描述、Zod 输入架构和 execute 函数。
工具架构提取与执行流程
构建流程在云端沙盒中将 TypeScript 源码打包为 tarball 并下载。沙盒导入模块后通过标准输出提取并验证工具架构，供智能体加载。在执行时，系统通过快照快速启动沙盒，运行指定的 execute 函数，并通过标准输出和 XML 标签解析返回结果，同时对超时进程进行切断管理。
- 沙盒通过对模块执行 JSON 字符串化来自动剥离无法序列化的 execute 函数，生成自描述的工具架构。
- 沙盒利用快照技术加载代码，确保每次工具调用都处于全新的独立状态。
- 工具执行结果通过标准输出和 XML 标签包裹返回给智能体，同时执行时间受到严格限制。
问答环节：上下文优化、用例与容错
在问答环节中，主讲人解答了关于防止上下文臃肿的机制，指出 CLI 只在需要时加载架构；探讨了视力保险理赔等企业应用场景；并说明了代码部署的简便性以及智能体如何根据错误日志实现工具调用的自我纠正。
- NTM CLI 仅向智能体提供工具名称和简短描述，避免工具过多导致上下文窗口臃肿。
- 常见的企业用例包括连接内部 API 或特定网站提交理赔申请。
- 当工具调用不稳定或出错时，错误信息会直接反馈给智能体，由智能体利用自身的记忆系统进行自我纠正。
설명
Vercel.com