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

# 使用 Octop 定时任务自动执行重复性专家任务

> 设置 Octop 专家自动运行提示。使用 cron 表达式或自然语言触发器来自动化每日报告和提醒。

为您的 Octop 专家设置定时任务，让它们自动发送提醒、报告或定时执行其他任务，无需手动触发。

![定时任务](https://mintcdn.com/octop/P_aBdthWeK4YndCE/images/ui-tasks.png?fit=max\&auto=format\&n=P_aBdthWeK4YndCE\&q=85\&s=2686171225da04fcf06e49638b41be3f)

## 创建定时任务

在页面中打开**任务**，选择任务所属的专家，点击**创建任务**。

填写名称、调度、指令和任务类型后保存即可。

## 任务的四个要素

* **名称** —— 任务列表里的显示名。页面会让你填写。API 可省略，服务端会从指令推导。
* **调度** —— 任务何时触发（cron 表达式、间隔或一次性时间点）
* **指令** —— 发送给专家的提示词，上限 2000 字符
* **类型** —— **Agent** 由大模型处理指令并生成回复；**文本**则直接把指令作为普通消息推送，不经过大模型

## 触发格式

| 格式 | 示例 | 说明 |
| - | - | - |
| Cron 表达式 | `0 9 * * *` | 标准 5 字段 cron，每天 9 点触发 |
| 间隔 | `interval:30` | 从保存那一刻起每 30 分钟触发一次 |
| 一次性 | `date:2025-01-15T09:00:00` | ISO 8601 时间点，只触发一次 |

## 查看与手动执行

任务列表会显示每个任务的调度、类型、指令、上次执行时间和上次状态，便于确认任务是否按预期触发。每行还有**启用**和**立即执行**操作——**立即执行**会马上跑一次而不必等到下个调度点，是验证新任务最快的方式。

> [!NOTE]
>
> 定时任务触发时，专家会像处理普通消息一样处理指令——它可以调用技能、访问连接器，并将结果发送到其已配置的通道。

> [!TIP]
>
> CLI 创建与管理见[通道与定时任务](https://octop.mintlify.site/zh/cli/channel-cron-commands.md#octop-cron)。将定时任务与通道结合，可以实现每天自动推送报告到飞书或 Telegram。

> [!TIP]
>
> 设置 `OCTOP_DEFAULT_TIMEZONE` 环境变量，或在 `config.json` 中添加 `"default_timezone"`，可以控制 Octop 计算 cron 表达式时使用的时区。未设置时使用服务器系统时区。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.