设置定时触发器节点用于在扣子应用中创建一个定时触发器，或修改已创建的定时触发器。 ## 节点说明 和智能体一样，扣子应用也支持设置定时触发器，在指定的时间点触发定时器调用某个工作流。扣子应用的触发器分为预设触发器和用户触发器两种，前者是开发者编排应用时创建的触发器，对所有用户生效，后者是扣子应用的用户通过定时触发器节点创建的，仅对指定用户生效。关于扣子应用触发器的详细说明，可参考[为应用设置触发器]。 设置定时触发器用于用户主动设置触发器的场景，例如在一个英语学习的 AI 应用中，每个用户都可以创建自己的学习计划，A 用户可以要求每天 10 点学习 10 个单词，B 用户可以要求 12 点学习 5 个。 设置定时触发器等触发器节点仅支持在扣子应用中创建或使用，包含触发器节点的工作流无法添加到智能体中。 ## 设置节点参数 ### 输入 设置定时触发器节点预设多个参数，配置说明如下: | 变量 | **说明** | **示例** | | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | | id | 触发器的 ID，是触发器在扣子平台中的唯一标识，由扣子平台自动创建，不支持手动创建或编辑。* 创建触发器时，无需设置 id，系统会自动生成一个 id。* 更新触发器配置时，需要输入 id，表示更新指定的触发器。 |  | | 用户id | 使用触发器的扣子用户 ID，此触发器仅对该用户生效。扣子应用的系统变量sys\_uuid 可以用来标识用户，你可以使用变量节点获取系统变量 sys\_uuid 的值，并赋值给设置定时触发器节点的用户id 参数。 | | | 名称 | 触发器的名称，用于标识触发器的用途。 | | | 时区 | 触发器的运行时区，建议根据 AI 应用的用户所在时区设置，确保定时任务在正确的时间启动。 | | | 触发时间 | 触发器的触发时间，触发时自动执行这个工作流。可以选择预设的时间选项（如每天 18 点），也可以使用 Cron 表达式来自定义复杂的时间。其中，Cron 表达式支持 AI 自动生成，也可以引用上游节点的输出。 | | | 绑定工作流 | 选择一个工作流，当触发器被激活时，扣子平台会自动运行该工作流。 | | | 参数 | 工作流开始节点设置的参数，其中必选参数应设置运行时的参数值。 | | ## 输出 设置定时触发器节点固定的输出参数为 triggerId，String 类型，表示已创建或更新的触发器 ID。 ## 示例 为一个扣子应用添加每日个性化书单推荐的功能，可以根据不同用户的偏好推荐好书、为每个用户设置触发器，更新推荐书单，用户可以主动查看自己更新后的每日书单。 主要功能及对应流程如下 | **功能模块** | **说明** | **工作流示例** | | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | | 更新推荐书单 | 通过变量节点获取用户 ID 和读书偏好，通过数据库节点查看过去已经推荐过的图书名称，大模型根据读书偏好和已推荐的书单，生成新的推荐书单，并写入数据库中。 |  | | 创建或更新用户触发器 | 通过变量节点获取用户 ID，为用户设置个性化的触发器，绑定**更新推荐书单**的工作流，每天定时为每个用户更新书单。此工作流可以绑定用户界面中的某个按钮，用户单击按钮时触发工作流，创建触发器，每天定时更新书单。 |  | | 查看每日书单 | 通过变量节点获取用户 ID，根据用户 ID 在数据库中查询今日推荐书单。这个工作流可以绑定用户界面中的某个按钮，用户单击按钮时触发工作流，展示今日推荐书单。 |  | | 查看触发器列表 | 查看用户已创建的所有触发器列表。通过变量节点获取用户 ID，根据用户 ID 查询触发器列表。 |  | | 删除书单触发器 | 不再需要获取每日书单时，可以删除书单触发器，每日书单不会定时更新。通过变量节点获取用户 ID，根据用户 ID 查询触发器列表、获取触发器 ID，根据用户 ID 和触发器 ID 删除指定用户的触发器。 |  |