CCE Agent 支持按照预设时间自动执行查询、巡检等任务，并通过 IM 渠道推送运行结果，帮助您定期了解集群状态，无需每次手动发起对话。 本文介绍定时任务的创建、管理及运行结果查看方法。

前提条件

• 已开通并能够正常使用 CCE Agent，且具有任务所涉及集群及资源的访问权限。
• 如需通过飞书接收运行结果，已完成通知渠道配置，并将机器人添加到目标群组。具体操作请参见 [IM通知渠道（飞书）配置]。仅在控制台查看结果时，无需配置 IM 渠道。

使用限制

• 当前定时任务支持资源查询、集群巡检和诊断等只读操作。
• 任务最小执行间隔为 10 分钟。需要更高频率的监控和告警时，建议使用监控告警服务。
• 同一定时任务不重复并发执行。上一次运行尚未结束时，后续触发默认跳过，可在运行记录中查看。
• 每个定时任务最多添加 5 个 IM 通知渠道。

创建定时任务

您可以在控制台填写任务配置，也可以通过自然语言对话创建定时任务。

通过控制台创建

1. 登录 容器引擎 CCE 控制台。
2. 在左侧导航栏选择 CCE Agent，单击 定时通知，进入 定时任务 页面。
3. 单击 新建定时任务，在弹出的 创建定时任务 窗口中填写以下参数。

参数	说明
任务名称	必填，长度为 1～32 个字符，支持中文、大小写字母、数字、空格、短划线（-）和下划线（_）。首尾空格自动去除，不支持其他特殊字符。建议使用便于识别执行对象及用途的名称，例如“生产集群每日巡检”。
计划时间	必填，默认选择“每天”。根据需要设置执行周期和时间，也可以使用固定间隔或 Cron 表达式配置执行计划。固定间隔默认 30 分钟，必须为大于等于 10 的正整数分钟。默认时区为 Asia/Shanghai，也可选择 UTC，请根据所选时区设置执行时间。
任务指令	必填，使用自然语言描述执行对象、检查内容和结果要求。建议写明地域、集群名称或 ID，避免执行对象不明确。
开通 IM 渠道	默认关闭。开启后，选择已配置的 IM 渠道及接收结果的群组；单击“添加渠道”可继续添加，最多 5 个。若尚未配置渠道，请先前往“IM渠道”页面完成配置。

任务指令示例：

巡检华北-北京地域的 prod-cluster 集群，检查节点状态和异常 Pod，汇总发现的问题、影响范围及排查建议。若未发现异常，请明确说明检查结果。

4. 如需接收通知，开启 开通 IM 渠道，选择通知渠道，并在右侧选择或输入群组 ID。请确认机器人已加入目标群组。
5. 单击 新建任务。创建成功后，任务状态为 启用中，系统按照配置的计划自动执行。
6. 返回任务列表，核对 触发方式 和 下次运行时间。建议单击 立即执行 验证任务指令及通知配置是否符合预期。

说明：不开启 IM 渠道不影响任务执行，运行结果仍可在控制台查看。

通过自然语言创建

1. 进入 CCE Agent，单击 新建对话。
2. 输入任务的执行对象、执行时间和任务内容，例如：

每天北京时间 09:00 巡检华北-北京地域的 prod-cluster 集群，检查节点状态和异常 Pod，汇总异常及排查建议。

3. 如果缺少目标集群、执行频率等关键信息，根据 Agent 的追问补充说明。
4. 信息完整后，Agent 创建任务并返回任务概要。您可进入 定时通知 页面，核对任务名称、触发方式及状态。
5. 如需配置结果推送，可在任务列表单击 更多 > 编辑，选择 IM 渠道和接收群组。

说明：自然语言创建任务时，信息完整后将直接创建，无需再次填写表单确认。请在对话中明确执行对象和时间要求，并核对创建结果。

查看定时任务

进入 CCE Agent > 定时通知，在定时任务列表中查看任务信息。

列表项	说明
任务名 / ID	任务名称及唯一标识。单击任务名称可进入任务详情。
触发方式	任务配置的执行周期或触发规则。
下次运行时间	任务下一次计划执行的时间。
最近结果	最近一次运行的结果。详细执行过程请在运行记录中查看。
状态	“启用中”表示任务按计划执行；“已暂停”表示任务暂停自动触发。
操作	支持立即执行、暂停或恢复，以及通过“更多”进行编辑、查看运行记录和删除。

您可以在列表上方输入任务名称或任务 ID 进行搜索，或单击刷新按钮更新列表。

管理定时任务

立即执行

创建任务后，您可以手动执行一次，验证任务指令和通知配置。

1. 在定时任务列表中找到目标任务，单击操作列的 立即执行。
2. 系统提示已触发任务执行后，通过 更多 > 查看运行记录 查看本次执行结果。

说明：立即执行会发起一次手动运行，不修改已配置的执行周期。对于已暂停的任务，立即执行会将任务恢复为“启用中”；如需继续暂停自动执行，请在验证后再次暂停。

暂停与恢复

集群维护或暂时无需自动巡检时，您可以暂停任务，后续再按需恢复。

1. 在定时任务列表中找到目标任务，单击 暂停，任务状态变为 已暂停。
2. 需要继续按计划执行时，单击 恢复，任务状态变为 启用中。

说明：暂停后不再触发新的定时运行，正在进行的运行不受影响。恢复后，任务按照配置的计划继续执行。

编辑任务

1. 在定时任务列表中找到目标任务，单击 更多 > 编辑。
2. 根据需要修改任务名称、计划时间、任务指令及 IM 通知配置。
3. 保存配置，返回任务列表核对修改结果。

说明：修改仅对后续运行生效，不影响正在进行的运行。

删除任务

1. 在定时任务列表中找到目标任务，单击 更多 > 删除。
2. 核对确认窗口中的任务名称，确认后删除任务。

注意：删除后任务不可恢复，系统不再按该任务的计划发起运行。若任务正在执行中，暂不允许删除，请等待本次运行结束后再操作。临时停用建议使用“暂停”。

查看运行结果

查看运行记录

1. 在定时任务列表中，单击目标任务名称，或选择 更多 > 查看运行记录。
2. 在任务详情的 运行记录 页签查看历次运行信息，包括开始时间、耗时、触发方式、运行结果及通知状态。
3. 单击目标记录的 查看运行详情，打开对应的运行会话，查看 Agent 的执行过程、结果摘要及失败原因。

运行结果说明如下：

结果	说明
成功	本次任务执行成功。请进入运行详情查看具体结论。
失败	本次任务执行失败。请查看失败原因，检查资源访问权限及任务指令，处理后可通过“立即执行”再次验证。
跳过	本次未执行。例如，上一次运行尚未结束时到达下次触发时间，系统默认跳过本次触发。

说明：“成功”表示任务执行成功，不代表集群没有异常。是否存在异常，请以运行详情中的巡检或诊断结论为准。运行结果与通知送达状态分别展示，通知发送失败不等于任务执行失败。

通过 IM 接收结果

配置 IM 渠道后，任务运行完成时，系统向配置的接收目标推送结果通知。您可以在通知中查看结果状态和结论摘要，并通过运行详情入口回看执行过程。

如果未收到通知，请先在控制台检查运行记录及通知状态，再核对渠道是否启用、机器人是否已加入目标群组，以及群组 ID 是否正确。即使通知未发送成功，仍可在控制台查看运行结果。

查看变更历史

在任务详情中切换至 变更历史 页签，可查看任务的操作时间、操作人、变更类型及变更内容，用于追溯任务配置与状态的调整。

常见问题

问题	处理方法
创建任务时没有可选的 IM 渠道怎么办？	进入“IM渠道”页面配置通知渠道，完成后返回任务配置窗口选择。配置方法请参见《IM通知渠道（飞书）配置》。
任务的执行时间与预期不一致怎么办？	核对计划时间和时区。默认时区为 Asia/Shanghai；如选择 UTC，请按照 UTC 时间设置，并核对列表中的下次运行时间。
任务显示成功，为什么结果中仍有异常？	成功表示任务执行成功，巡检发现的节点、Pod 等异常会体现在结果内容中，请查看运行详情。
任务运行完成，但未收到飞书通知怎么办？	先确认任务已开启 IM 渠道并选择正确群组，再查看通知状态，检查渠道启用状态、机器人入群情况及飞书应用权限。
为什么某次运行被跳过？	查看上一次运行是否仍未结束。同一任务不重复并发执行，可根据实际耗时适当延长执行间隔。
为什么无法删除任务？	正在执行的任务暂不允许删除，请等待本次运行结束后重试。