自动化任务

了解如何设置和管理定时执行的任务

自动化任务

自动化任务功能让您可以设置按计划自动执行的任务。本文档介绍自动化任务的配置和使用方法。

功能概述

自动化任务可以：

• 按固定时间间隔执行
• 在指定时间点执行
• 使用 Cron 表达式配置
• 自动触发 AI Agent 执行
• 响应系统事件自动触发（事件回调）

使用场景

定期报告

每天/每周自动生成报告：

每周一 9:00 生成项目进度报告

数据同步

定时同步数据：

每小时同步一次数据统计

提醒通知

定期提醒：

每天 17:00 提醒整理当日工作

自动维护

定期执行维护任务：

每周日凌晨清理临时文件

事件驱动自动化

当系统内发生特定事件时，自动触发 Agent 处理：

当新任务创建时，自动分析任务优先级并添加标签
当对话出错时，自动通知管理员并记录错误日志
当成员加入工作空间时，自动发送欢迎消息

详细说明请参考 事件回调 Hook

任务类型

系统支持三种任务类型：

事件回调类型的详细配置和使用请参考 事件回调 Hook

创建自动化任务

步骤 1：进入任务管理

1. 进入工作空间
2. 点击侧边栏"任务"
3. 切换到"自动化任务"标签

步骤 2：新建自动化任务

点击"新建自动化任务"按钮。

步骤 3：配置任务

填写任务配置：

步骤 4：保存并启用

1. 检查配置
2. 点击保存
3. 确保任务状态为"启用"

执行计划配置

简单模式

使用预设的时间选项：

高级模式（Cron 表达式）

使用 Cron 表达式进行精细配置：

分钟 小时 日 月 周几

Cron 示例

Cron 字段说明

任务内容

文本指令

直接输入要执行的指令：

请生成本周的项目进度报告，包含：
1. 完成的工作
2. 进行中的任务
3. 下周计划

使用模板

可以使用变量模板：

请生成 {{date}} 的数据统计报告

支持的变量：

管理自动化任务

查看任务列表

在"自动化任务"标签查看所有自动化任务：

启用/禁用任务

点击状态开关启用或禁用任务。

禁用的任务：

• 不会按计划执行
• 配置保留
• 可以随时重新启用

编辑任务

1. 找到目标任务
2. 点击编辑按钮
3. 修改配置
4. 保存

删除任务

1. 找到目标任务
2. 点击删除按钮
3. 确认删除

手动执行

可以手动触发任务执行：

1. 找到目标任务
2. 点击"立即执行"按钮
3. 任务开始执行

执行历史

查看历史

点击任务名称查看执行历史：

历史保留

执行历史默认保留 30 天。

最佳实践

1. 合理安排执行时间

• 避免高峰时段
• 考虑时区差异
• 错开多个任务的执行时间

2. 控制执行频率

✅ 合理：每天 1 次、每周 1 次
❌ 过于频繁：每分钟执行

3. 清晰的任务内容

✅ 好：
请生成本周（{{date}}）的销售报告，包含：
- 总销售额
- 同比增长
- TOP 10 产品

❌ 不好：
生成报告

4. 监控执行结果

• 定期检查执行历史
• 关注失败的任务
• 及时调整配置

限制说明

执行频率限制

• 最小间隔：5 分钟
• 每天最多执行：288 次（每 5 分钟一次）

执行超时

• 单次执行最大时长：10 分钟
• 超时任务会被标记为失败

常见问题

Q：自动化任务没有执行怎么办？

A：检查以下几点：

• 任务是否已启用
• Cron 表达式是否正确
• 是否超过配额限制

Q：可以设置一次性任务吗？

A：可以。创建任务时选择"一次性任务"类型，设置执行时间即可。

Q：可以根据事件自动触发任务吗？

A：可以。创建任务时选择"事件回调"类型，配置监听事件和触发条件即可。详见 事件回调 Hook。

Q：任务执行失败会重试吗？

A：会。可以在高级配置中设置最大重试次数和重试间隔。

Q：如何临时暂停任务？

A：使用禁用功能临时暂停任务，需要时再启用。

Q：事件回调任务监听了多个事件，一次操作只触发多次自动化任务吗？

A：不会，只会触发一次。因为有系统有内置的操作级去重机制。当一次操作（如修改任务状态）同时产生多个事件（如 task.updated 和 task.status_changed）时，系统会自动识别它们来自同一次操作，确保每个回调任务只执行一次，避免重复处理。详见 事件回调 Hook。

Q：跨工作空间的事件会触发回调任务吗？

A：不会。事件回调任务只响应同一工作空间内产生的事件，不同工作空间之间的事件互相隔离。

相关文档

• 任务管理
• 事件回调 Hook
• AI 对话
• 快捷命令