---
title: 定时任务
description: 了解如何使用定时任务，包括创建、编辑、删除等。
tags:
  - LobeHub
  - CronJob
  - 定时任务
  - 创建
  - 编辑
  - 删除
---

# 定时任务

定时任务是定期在云端执行的任务。简单来说，你可以让 Agent 定期根据你的 Prompt 去执行任务 —— 例如定期检查社交媒体内容并发送通知。无需反复手动触发同一工作流，设置一次即可按计划自动运行 —— 每天、每周或每小时均可。

## 创建任务

在 Agent 会话页面左侧面板找到定时任务，点击 `添加定时任务` 开始创建任务。

![创建任务](/blog/assets3059f679eef80c5e777085db3d2d056e.webp)

### 配置字段说明

**任务名称** — 为任务起一个描述性的名称，方便一眼识别：

- ✅ "每日市场摘要 - 上午 9 点"
- ✅ "每周竞品分析"
- ❌ "任务 1"

**任务内容** — 填写每次触发时 Agent 需要执行的 Prompt 或指令。内容要具体完整 —— 这段提示词会在每次计划执行时原样运行。例如：

```
分析今日科技新闻热点并总结：
1. 主要产品发布
2. 融资公告
3. 行业趋势
以简明执行摘要的形式输出。
```

**执行频率** — 选择任务的运行频率：

- **每天** — 每天在指定时间执行
- **每周** — 每周指定星期的指定时间（可选多天）
- **每小时** — 每隔 1、2、6、12 或 24 小时执行

**时间与时区** — 指定具体执行时间和时区，确保任务在正确的本地时间运行。时间采用 24 小时制。对于跨地区团队，时区设置尤为重要。

**最大执行次数** — 可选设置任务的总执行次数上限。长期任务无需限制；对于限时活动（如 30 天），可设置为 30，任务在达到上限后自动停用。

创建完成后，你可以随时修改定时任务的配置。

## 计划配置示例

**每日晨报：**

- 频率：每天 08:00（你的时区）
- Prompt："总结昨日的关键指标，并列出今日优先事项。"

**每周计划会议：**

- 频率：每周一 09:00
- Prompt："回顾上周进展，制定本周优先级列表。"

**每小时监控：**

- 频率：每 2 小时
- Prompt："检查是否有关键告警或异常，并汇总发现。"

**月度复盘：**

- 频率：按月，可将最大执行次数设为每月 1 次，或配合特定日期使用
- Prompt："分析本月绩效数据，生成执行报告。"

## 管理任务

### 查看执行历史

每次定时执行都会在该 Agent 的对话历史中创建一条记录，并标注任务名称和时间戳。你可以查看输出内容、核查错误并追踪历史结果。

### 编辑计划

点击定时任务即可修改 —— 更新 Prompt、调整频率或时间、修改时区。更改在下次计划执行时生效。

### 暂停任务

如果暂时不需要某个定时任务，可以关闭启用状态。关闭后，任务不再自动执行，执行计划和 Prompt 配置会保留。恢复启用后，该任务将继续执行。

![暂停任务](/blog/assets636c78daf95c590cd7d80284c68eb6d9.webp)

### 删除任务

如果不再需要某个定时任务，可以将其删除。删除后，执行计划和 Prompt 配置一并移除，系统将不再触发后续执行。历史对话记录会保留。

## 最佳实践

**编写清晰、自包含的 Prompt** — 定时任务的 Prompt 运行时没有任何历史对话上下文，Agent 所需的所有信息都必须包含在 Prompt 中：

- ✅ "搜索过去 24 小时内发布的新能源汽车相关新闻，总结前 3 条重要进展。"
- ❌ "按我们讨论的那样检查新闻。"（计划运行时 Agent 无法访问历史对话）

**选择合适的频率** — 频率应与所监控信息的实际节奏匹配。对每日新闻进行每小时监控是多余的开销；对实时指标进行每周报告会漏掉重要信息。

**使用描述性任务名称** — 在名称中体现用途和计划："每周竞品分析 - 周一上午 9 点" 远比 "任务 2" 更实用。

**实验时设置最大执行次数** — 测试新定时任务时，将最大执行次数设为 5–10，避免提示词效果不符合预期时无限运行。

**时区意识** — 务必设置正确的时区。"09:00" 默认相对于服务器时区，可能与你的本地时间不同。时区配置错误是导致执行时间意外的常见原因。

## 使用场景

### 定期检查社交媒体内容并发送通知

设置定时任务，周期性检查指定平台或关键词相关的社交媒体内容。任务会自动抓取最新动态，筛选符合条件的信息，并在检测到重要更新时生成摘要。适合品牌舆情监测、竞品动态跟踪、创作者内容更新提醒等场景。

### 周期性生成总结与报告

对于需要定期复盘的工作 —— 数据分析、项目进展跟踪或内容表现评估 —— 可以通过定时任务自动完成汇总和分析。任务在指定时间收集相关信息，输出结构化结论，帮助你持续掌握趋势变化。

### 定时提醒通知

提前设定需要提醒的事项 —— 重要节点、周期性检查任务或待处理工作等 —— 让 LobeHub 自动生成提醒信息并通过邮件等方式通知，无需手动触发。

## 故障排查

**任务未在预期时间执行** — 检查时区设置。计划时间相对于已配置的时区，而非你当前的本地时区。同时确认任务处于 "已启用" 状态。

**执行时间出现意外** — 核查是否在 24 小时制中混淆了上下午（如 17:00 = 下午 5 点，而非上午 5 点）。

**输出质量不佳** — 定时任务的 Prompt 在无对话上下文的情况下运行。请将 Prompt 改写为完全自包含的形式，包含所有必要的背景信息、数据来源和格式要求。

**执行次数过多** — 实验新任务时设置 "最大执行次数" 上限。如果任务已超出预期次数，可删除后重新创建。

<Cards>
  <Card href={'/zh/docs/usage/agent/web-search'} title={'网络搜索'} />

  <Card href={'/zh/docs/usage/getting-started/agent'} title={'助理'} />
</Cards>
