定时任务

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

定时任务

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

功能概述

定时任务可以：

• 按固定时间间隔执行
• 在指定时间点执行
• 使用 Cron 表达式配置
• 自动触发 AI Agent 执行

使用场景

定期报告

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

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

数据同步

定时同步数据：

每小时同步一次数据统计

提醒通知

定期提醒：

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

自动维护

定期执行维护任务：

每周日凌晨清理临时文件

创建定时任务

步骤 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：目前不会自动重试，您可以手动执行或等待下次计划执行。

Q：如何临时暂停任务？

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

相关文档

• 任务管理
• AI 对话
• 快捷命令