
# 定时任务
通过创建定时任务，让系统按照设定时间或频率自动执行预设操作并输出执行结果，全程无需人工干预，助您轻松解放双手。
#### 约束与限制
表1约束与限制 
| 限制类别       | 具体限制                                                                                                |
|:---|:---|
| 并行任务数量限制   | 单个项目最多支持同时启用3个定时任务。                                                                                 |
| 定时任务时间范围限制 | 创建定时任务时，设定的执行时间区间不得超过7天（含起始日）。                                                                      |
| 存储方式       | 本地存储。 存储在"%USERPROFILE%/.codeartsdoer/codearts-data/cron"目录下。 |
| 运行约束       | 定时任务仅在**电脑保持唤醒并启动客户端时**运行。                                                                          |
   
#### 通过对话创建定时任务
1. 参考[开启Space模式](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0006.html#codeartsagent_ug_0006__section183281754460)操作，进入码道Agent Space。
2. 单击"定时任务"，进入"定时任务"页面。
3. 单击"通过对话创建"，进入AI对话窗口。
4. 在输入框中输入创建定时任务的指令，单击发送图标 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002694315204.png)。
   
   ```
   我想要创建一个定时任务。
   任务内容是：自动扫描项目代码，精准识别语法错误、编码规范违规、逻辑缺陷及基础安全隐患
   执行时间是：每天早上8点
   ```
   
   
5. 定时任务创建完成后，返回定时任务页面，可查看到已创建的定时任务。 
   图1查看定时任务   
   ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002714544066.png "点击放大")
   
   
 
#### 手动创建定时任务
1. 参考[开启Space模式](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0006.html#codeartsagent_ug_0006__section183281754460)操作，进入码道Agent Space。
2. 单击"定时任务"，进入"定时任务"页面。
3. 单击"手动创建"或"立即创建"，进入"创建定时任务"页面。
4. 设置定时任务参数，单击"确定"，完成任务的创建。 
   表2定时任务参数说明 
   | 参数    | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
   |:---|:---|
   | 名称    | 新建定时任务的名称，便于后续管理和识别任务用途。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   | 项目文件夹 | 定时任务所属的项目，不支持修改。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
   | 提示词   | 请输入创建定时任务的具体指令，例如"整理本月销售数据并生成报表"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
   | 执行频率  | 定义任务多久执行一次。 - 每天：定时任务每天在固定时间执行一次，例如"每天早上8:00执行一次数据备份"。  - 每周：任务每周在指定星期几的固定时间执行，例如"每周一上午9:00发送周报邮件"。  - cron表达式：使用标准的Cron语法定义复杂的执行时间规则。  - 间隔触发：按固定的时间间隔重复执行任务，例如"每3小时执行一次"，将在0、3、6、9、12、15、18、21点执行。   |
      
   
   
5. 返回定时任务页面，在定时任务列表中可查看到已创建的定时任务。 
   定时任务默认处于启用状态，即状态为"生效中"。
   
   
 
#### 管理定时任务
表3管理定时任务 
| 操作         | 具体步骤                                                                                                                                                                                                                                                                                                                       |
|:---|:---|
| 开启/禁用定时任务  | 在"定时任务"页签中，单击定时任务前的 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002724114593.png)/![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002724274533.png)，即可启用或禁用定时任务。 **单个项目最多支持同时启用3个定时任务。如果需要启动新任务，请先停止当前已启用的任务，再启动目标任务。** |
| 执行定时任务     | 在"定时任务"页签中，单击立即执行图标 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002694315206.png)，即可立即执行定时任务。 **执行定时任务前，请确保定时任务已启用。**                                                                                                                             |
| 编辑定时任务     | 在"定时任务"页签中，单击已创建的定时任务，即可进入编辑定时任务页面，对已创建的定时任务进行修改。                                                                                                                                                                                                                                                                          |
| 删除定时任务     | 在"定时任务"页签中，将鼠标悬浮在 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002694475080.png)上，选择删除，即可立即删除定时任务。 该定时任务从列表中移除，表示成功删除定时任务。 注意： 定时任务删除后不可恢复，请谨慎操作。                                                            |
| 查看定时任务执行记录 | 在"执行记录"页签中，设置开始时间和结束时间后，即可筛选并查看该时段内所有定时任务的执行详情，包括**已完成** 、**等待中** 及**执行中**三个状态。                                                                                                                                                                                                                                            |
   
