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

# 计划会话

> 按计划自动运行的周期性或一次性 Devin 会话

<Warning>
  **自动化现已成为按计划运行 Devin 的推荐方式。** [Automations](/zh/product-guides/automations) 支持计划触发器以及事件驱动触发器 (Slack、GitHub、Linear、webhooks) 、条件、调用限制等。如果你正在设置新的计划工作流程，请改用带有 **计划触发器** 的自动化。现有的计划会话将继续正常工作。
</Warning>

计划会话允许你创建可自动运行的 Devin 会话——既可以按周期性计划运行，也可以在特定日期和时间执行一次。你可以用它们来自动化处理重复性任务，例如每日报告、定期代码维护、常规数据分析等。

<div id="creating-a-scheduled-session">
  ## 创建计划会话
</div>

创建计划会话有两种方式：

<div id="from-the-input-box">
  ### 通过输入框创建
</div>

1. 在 Devin 输入框中输入你的提示
2. 点击输入框右侧的 **三点菜单** (⋯)
3. 选择 **Schedule Devin**
4. 系统会跳转到计划创建页面，你的提示会被自动填入

<div id="from-the-schedules-settings-page">
  ### 在 “Schedules” 设置页面中
</div>

1. 在侧边栏中进入 **Settings > Schedules**
2. 点击 **Create schedule**
3. 填写计划的详细信息

<div id="configuring-a-schedule">
  ## 配置计划
</div>

在创建或编辑计划时，您可以配置以下选项：

<div id="name">
  ### 名称
</div>

为你的计划设置一个具有描述性的名称，便于在列表中快速识别 (例如，“Daily CI Report” 或 “Weekly Dependency Updates”) 。

<div id="schedule-type">
  ### 调度类型
</div>

从两种调度类型中选择：

* **周期性** — 按基于 cron 的频率反复运行 (默认)
* **一次性** — 在特定日期和时间运行一次，然后会自动禁用

<div id="agent">
  ### Agent
</div>

选择用于运行预定会话的 Agent 类型：

* **Devin** — 标准 AI 软件工程师 (默认)
* **Data Analyst** — 针对数据分析和查询优化
* **Advanced** — 用于 playbook 和会话分析

<div id="playbook-optional">
  ### Playbook (可选)
</div>

为预定会话关联一个 [playbook](/zh/product-guides/using-playbooks)。每当计划运行时，都会应用该 playbook，从而确保执行行为的一致性。

<div id="repositories-optional">
  ### 仓库 (可选)
</div>

为计划会话选择一个或多个要使用的仓库。选择仓库后，它们会作为提示包含在会话提示中，以便 Devin 知道应重点关注哪些仓库。留空则让 Devin 根据提示自行确定相关仓库。

<div id="frequency-recurring-schedules">
  ### 频率 (重复计划)
</div>

对于重复计划，你可以设置计划任务的运行频率。频率编辑器支持两种模式：

**可视化模式** 提供预设选项：

* **每小时** — 每 N 小时运行一次
* **每天** — 每天在特定时间运行
* **每周** — 在选定的星期几的特定时间运行

<Tip>时间会以你的本地时区显示，但在内部会以 UTC 存储。编辑器会自动处理时区转换。</Tip>

**自定义模式** 允许你直接输入标准的 cron 表达式 (例如，`0 9 * * 1-5` 表示在工作日的 UTC 时间上午 9 点运行) 。这为配置复杂计划提供了完全的灵活性。

<div id="run-at-one-time-schedules">
  ### 运行时间 (一次性计划)
</div>

对于一次性计划，选择会话应运行的日期和时间。时间将按照你的本地时区输入，并自动转换为 UTC。一次性计划必须设置在将来的时间点。

一次性计划执行后会自动被禁用。该计划及其历史会话记录会被保留，以便审计。

<div id="email-notifications">
  ### 邮件通知
</div>

控制你接收计划会话运行相关邮件通知的时间：

* **始终** — 每次运行后都会收到通知
* **仅在失败时** — 只有当计划会话失败时才会收到通知 (默认)
* **从不** — 不会收到任何通知

<div id="slack-notifications">
  ### Slack 通知
</div>

你可以选择将有关**计划会话运行**的通知发送到 **Slack 频道**。配置后，当计划运行时，Devin 会将更新发布到所选频道。这需要在你的组织设置中连接 Slack 集成。

<div id="run-as">
  ### 运行身份
</div>

默认情况下，由计划创建的会话会归属于最初创建该计划的用户。编辑计划时，你可以更新此设置，使后续运行改为归属于你。当计划所有权发生变更时，这项设置很有用——新所有者会收到通知，相关会话也会显示在其账户下。

<div id="prompt">
  ### Prompt
</div>

编写每次计划任务运行时 Devin 将遵循的指令。这与您在开始常规 Devin 会话时输入的提示内容相同。

<div id="managing-schedules">
  ## 管理计划
</div>

前往 **Settings > Schedules** 查看所有已排程的会话。列表会显示每个计划的名称、执行频率、上次运行时间和当前状态。

<div id="status">
  ### 状态
</div>

每个计划具有以下三种状态之一：

* **Active** — 该计划已启用，并将在下一个预定时间点运行
* **Paused** — 该计划已禁用，在重新启用前不会运行。一旦性计划在执行完成后会自动暂停。
* **Error** — 该计划连续执行失败

<div id="editing-a-schedule">
  ### 编辑计划
</div>

点击列表中的任一计划即可查看其详细信息。点击 **Edit** 可修改其配置，包括名称、提示、Agent、playbook、仓库、频率、通知设置、run-as 用户，以及其当前是启用还是暂停状态。

<div id="pausing-and-resuming">
  ### 暂停和恢复
</div>

你可以通过编辑计划，将 **Status** 开关切换为 **Paused** 来暂停计划。已暂停的计划在重新启用之前不会创建新的会话。将其切换回 **Active** 即可恢复。

<div id="deleting-a-schedule">
  ### 删除计划任务
</div>

在计划任务详情页点击 **三点菜单**，然后选择 **删除**。这将永久删除该计划任务。由该计划任务创建的历史会话不会受到影响。

<div id="viewing-past-sessions">
  ## 查看过去的会话
</div>

每个日程详情页面都有一个 **Past Sessions** 选项卡，列出该日程创建的所有 Devin 会话。点击任一会话即可进入该会话的完整视图。这对于回顾结果、排查故障或审计该日程在一段时间内的执行情况非常有用。

<div id="use-cases">
  ## 使用场景
</div>

以下是一些使用 Scheduled Sessions 的常见方式：

* **每日站会报告** — 每天早晨汇总最近的 PR、问题或提交
* **定期依赖更新** — 每周检查并应用依赖更新
* **定期数据分析** — 定期基于你的数据生成报告或仪表盘
* **常规代码维护** — 按计划运行 lint 修复、无用代码清理或测试覆盖率检查
* **监控与告警** — 定期检查系统健康状况或审查日志以发现异常