Skip to main content
我们强烈建议使用运行脚本来搭建自动化,因为它可以覆盖所有操作行为,包括原本需要手动搭建的操作。你只需在 AI 对话中描述需求即可。请注意:如果你手动添加操作,AI 后续将无法识别或修改它们。
运行脚本操作允许你编写自定义 JavaScript 代码,在安全沙箱环境中运行。当内置操作无法满足你的需求时,例如复杂的数据转换、条件分支逻辑或多步 API 调用,可以使用运行脚本处理。

何时使用运行脚本 vs 内置操作

尽可能使用内置操作。只在内置操作无法满足需求时才使用运行脚本。

运行环境

如何设置

  1. 在工作流中添加运行脚本操作。
  2. 在代码编辑器中编写 JavaScript 代码。
  3. 通过 input 对象访问前序步骤的数据。
  4. 通过 output.set() 将结果传递给后续步骤。
  5. (可选)在配置面板中声明 npm 依赖。
  6. 点击测试运行脚本并查看输出。

input 对象结构

input 对象包含前序所有步骤的输出数据。键为步骤的 Action ID,值为该步骤的输出。
字段通过字段 ID(如 fldXXXXXX)而非字段名称引用。你可以在测试面板中查看实际的数据结构和字段 ID。

output.set 详解

使用 output.set(key, value) 将数据输出给后续步骤:
后续步骤可以通过 + 按钮引用脚本输出的每个键值。

内置变量

利用这两个变量,你可以在脚本中直接调用 Teable API:

调用外部 API

npm 依赖

在配置面板的依赖声明区域,以 JSON 格式添加需要的包:
然后在代码中通过 require() 引入:
尽可能使用 JavaScript 内置功能(如 Array.mapArray.filterJSON.parse 等),而非引入 npm 包。内置功能运行更快,也不需要额外配置。

调试技巧

  • 使用 console.log():在脚本中添加日志,测试运行后可以在输出面板中查看。
  • 先测试数据结构:在编写复杂逻辑前,先用 output.set("debug", input) 查看完整的输入数据结构。
  • 逐步构建:从简单的代码开始,确认数据获取正确后再添加业务逻辑。
  • 检查字段 ID:字段使用 ID(如 fldXXXXXX)引用,在测试面板中确认实际的 ID。

错误处理

使用 try/catch 捕获错误,避免脚本崩溃导致工作流中断:

安全说明

  • 脚本在安全沙箱中运行,与宿主系统隔离,无法访问文件系统或操作系统资源。
  • AUTOMATION_TOKEN 是自动生成的临时凭证,仅在当前工作流运行期间有效。
  • 不要在脚本代码中硬编码密码或 API 密钥。建议通过 Webhook 触发器或记录字段传入敏感信息。
  • 脚本有 60 秒的执行时间限制,超时会自动终止。

适用场景

  • 复杂数据转换:将多个字段的数据重新组织为特定格式,如生成报告摘要、拼接多语言内容。
  • 多步 API 编排:先调用 API A 获取 Token,再调用 API B 发送数据,在一个脚本中完成多步操作。
  • 条件分支处理:根据记录的不同字段值执行不同的处理逻辑,如根据订单金额选择不同的审批流程。
  • 数据校验和清洗:批量检查数据格式、去重、填充缺失值等。

相关文档

最后修改于 2026年5月26日