> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coze.cn/llms.txt
> Use this file to discover all available pages before exploring further.

查询定时触发器节点用于查看指定用户的触发器。
## 节点说明 {#87c5a6a8}
和低代码智能体一样，低代码应用也支持设置定时触发器，在指定的时间点触发定时器调用某个工作流。设置定时触发器用于用户主动设置触发器的场景，例如在一个英语学习的 AI 应用中，每个用户都可以创建自己的学习计划，A 用户可以要求每天 10 点学习 10 个单词，B 用户可以要求 12 点学习 5 个。关于低代码应用触发器的详细说明，可参考[为应用设置触发器](/guides/set_trigger_for_app)。
通过[设置定时触发器节点](/guides/set_timed_trigger)节点创建触发器之后，可以通过查询定时触发器节点查看指定用户的触发器，支持查看某个触发器的详情，也可以查看触发器列表。
:::tip 说明
设置定时触发器等触发器节点仅支持在低代码应用中创建或使用，包含触发器节点的工作流无法添加到智能体中。
:::
## 设置节点参数 {#82a7fd68}
### 输入 {#a1e425a1}
查询定时触发器节点预设多个参数，配置说明如下:
<!-- @cols-width: 168,492 -->
| | | \
|**参数** |**说明** |
|---|---|
| | | \
|id |触发器的 ID，是触发器在扣子编程中的唯一标识，由扣子编程自动创建。可以通过设置定时触发器节点的输出参数中获取，也可以先不指定 id，查看此用户的所有触发器详情，详情中包括每一个触发器的 ID。 |\
| |:::tip 说明 |\
| |* 未指定 id 时，此节点返回指定用户的所有触发器。 |\
| |* 指定 id 时，此节点仅返回指定触发器的详细信息。 |\
| |::: |
| | | \
|用户id |使用触发器的扣子用户 ID，此触发器仅对该用户生效。低代码应用的系统变量 sys_uuid 可以用来标识用户，你可以使用变量节点获取系统变量 sys_uuid 的值，并赋值给设置定时触发器节点的用户id 参数。 |

### 输出 {#0b89f993}
查询定时触发器节点固定的输出参数为 ouputList，数组类型，表示触发器列表。其中包含每个触发器的 ID 等信息，结构体详细说明如下：
<!-- @cols-width: 168,492 -->
| | | \
|**参数** |**说明** |
|---|---|
| | | \
|triggerId |已创建的触发器 ID。 |
| | | \
|triggerName |已创建的触发器名称。 |
| | | \
|createTime |触发器的创建时间。 |
| | | \
|triggerTime |触发器的触发时间，展示为 Cron 表达式格式。 |
| | | \
|userId |触发器对应的用户 ID。 |

## 示例 {#db325c2a}
为一个低代码应用添加每日个性化书单推荐的功能，可以根据不同用户的偏好推荐好书、为每个用户设置触发器，更新推荐书单，用户可以主动查看自己更新后的每日书单。
主要功能及对应流程如下：
<!-- @cols-width: 126,373,356 -->
| | | | \
|**功能模块** |**说明** |**工作流示例** |
|---|---|---|
| | | | \
|更新推荐书单 |通过变量节点获取用户 ID 和读书偏好，通过数据库节点查看过去已经推荐过的图书名称，大模型根据读书偏好和已推荐的书单，生成新的推荐书单，并写入数据库中。 |![Image=1884x458](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/5d3805d6fe6e462cb49a1f4a5eda468f~tplv-goo7wpa0wc-image.image) |
| | | | \
|创建或更新用户触发器 |通过变量节点获取用户 ID，为用户设置个性化的触发器，绑定**更新推荐书单**的工作流，每天定时为每个用户更新书单。 |\
| |此工作流可以绑定用户界面中的某个按钮，用户单击按钮时触发工作流，创建触发器，每天定时更新书单。 |![Image=1606x236](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/52934ab8c42a420aa92e41a7c8424e8c~tplv-goo7wpa0wc-image.image) |
| | | | \
|查看每日书单 |通过变量节点获取用户 ID，根据用户 ID 在数据库中查询今日推荐书单。 |\
| |这个工作流可以绑定用户界面中的某个按钮，用户单击按钮时触发工作流，展示今日推荐书单。 |![Image=20000x3063](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/315cbd1d0fa449e7aaa35de260c20ae7~tplv-goo7wpa0wc-image.image) |
| | | | \
|查看触发器列表 |查看用户已创建的所有触发器列表。通过变量节点获取用户 ID，根据用户 ID 查询触发器列表。 |![Image=1614x232](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/43e9ac7ff3d64e8c87c04b203429ba25~tplv-goo7wpa0wc-image.image) |
| | | | \
|删除书单触发器 |不再需要获取每日书单时，可以删除书单触发器，每日书单不会定时更新。 |\
| |通过变量节点获取用户 ID，根据用户 ID 查询触发器列表、获取触发器 ID，根据用户 ID 和触发器 ID 删除指定用户的触发器。 |![Image=1613x213](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/42885eff68fe4b83b64ec0b2c2a11dcf~tplv-goo7wpa0wc-image.image) |\
| | | |