触发器与任务调度

触发器用于在无需人工对话的情况下，让智能体自动执行任务。常见场景包括：每天推送资讯、监控数据并告警、接收外部系统事件后调用插件或工作流。

---

触发器类型与权限

• 用户定时任务：终端用户在豆包等客户端中自行设置提醒，适用于广泛用户的简单计划。
• 开发者触发器：在编排页由开发者配置，包括：
  • 定时触发器：按 cron 计划执行。
  • 事件触发器：通过 Webhook 接收外部请求后执行。

部分能力对订阅套餐有要求，详见官方限制说明。

---

设置定时触发器

1. 在智能体编排页的「技能」区域点击 + 触发器 → 选择「定时触发」。
2. 配置执行计划：
   • 支持分钟 / 小时 / 日 / 周 / 月等粒度。
   • 可设置时区、开始与结束时间。
3. 选择执行方式：
   • 机器人提示：直接发送文本或调用知识库。
   • 插件 / 工作流：点击 + 选择目标插件或工作流，如有参数可在表单中设置或绑定外部输入。

---

设置事件触发器

1. 新增触发器时选择「事件触发」。
2. 系统会生成 Webhook URL 与 Bearer Token，用于外部系统请求。
3. 配置执行方式（提示词、插件或工作流），并为参数设置默认值或映射 Webhook 请求体字段。
4. 将 Webhook 信息提供给后台或业务系统。

请求示例：

curl --location --request POST 'https://api.example.com/trigger' \
  --header 'Authorization: Bearer ABCxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{"url":"www.example.com"}'

StatusCode = 0 表示调用成功；否则需根据返回体中的错误信息排查。

---

调试与运维

• 在编排页「预览与调试」→ 技能 → 触发器 中，可直接触发定时或事件任务进行测试。
• 事件触发器上线后，需通过实际 Webhook 请求验证。
• 若执行逻辑依赖插件/工作流，请确保提示词或参数设置明确。

---

常见问题

• 为什么触发器没有执行？
  检查计划时间与时区是否正确，事件触发器则需确认请求是否命中正确 URL。

• 如何保证安全性？
  使用 Bearer Token 校验；必要时在外部系统增加 IP 白名单或额外签名。

• 能否获取执行记录？
  在调试详情或日志面板查看运行情况，方便定位错误。

---