docs/usage/getting-started/task.zh-CN.mdx
任务(Task) 把你和 Agent 的对话变成可追踪的工作。不必实时聊天再到处复制结果,你可以写下需求、把它指派给一个 Agent,让 Agent 在后台为你完成。Agent 会回报进度、在完成后更新状态,并在你留下评论时继续跟进。
如果你用过 Linear 或 GitHub Issues,思维模型完全一致 —— 只是这里的执行人是 Agent,并且它会真的把活干完。
当你希望 Agent 做下面这些事情时,就适合开任务:
对于一次性的、很快能答完的问题,留在普通对话里就好。任何你原本会记在待办列表或工单里的事情,都建议开一个任务。
每个任务会在一组简单的状态之间流转:
| 状态 | 含义 |
|---|---|
| Backlog | 已创建,Agent 还没开始处理。 |
| In Progress | Agent 正在执行该任务。 |
| Pending Review | Agent 完成了工作,等待你验收结果。 |
| Done | 你已确认结果,任务关闭。 |
| Canceled | 在完成前你主动关闭了该任务。 |
Agent 会自动把任务从 Backlog 推进到 In Progress,再到 Pending Review。任务什么时候变成 Done,由你决定 —— 详见下方的 验收结果。
点击左侧导航中的 Tasks,进入当前工作区的任务列表。
在右上角点击 New Task。给任务起一个清晰的标题 —— Agent 会根据标题和描述来理解你的意图。
像给同事派活一样描述工作内容,包含必要的链接、文件或限制条件。你可以像在普通对话里一样粘贴图片、附加 Resource。
在 Assignee 下拉框中选择合适的 Agent。根据任务挑选能力匹配的 Agent —— 比如 Research Agent 适合阅读和总结,或者使用你自己创建的自定义 Agent。后续也可以重新分配。
选择 Run once 进行一次性运行,或选择 Repeat 设置为周期任务。详见下方的 一次性任务 vs. 周期任务。
点击 Create。任务会进入 Backlog 状态,Agent 很快就会开始执行。
</Steps> <Callout type="info"> 你也可以从任意聊天消息直接创建任务 —— 打开消息菜单选择 **Turn into Task**,对话上下文会自动带入。 </Callout>当任务进入 In Progress 后,Agent 会在任务内部持续记录进度 —— 每一步动作、每一次工具调用、每一个中间结果。你不需要盯着看,随时打开任务就能看到当前状态。
当 Agent 认为工作完成后,任务会进入 Pending Review 状态。打开任务详情页验收结果,你有两种选择:
Done 状态并归档。Pending Review 任务不会自动完成 —— 任务是否结束完全由你决定。
每个任务都有一条评论线索,可以用来:
Agent 会自动读取新评论并继续跟进,不需要单独的 "发送" 动作 —— 你的评论就是新的指令。
<Callout type="info"> 如果 Agent 正在执行某一步,你的评论会排在下一个检查点处理,避免中途打断它。 </Callout>Agent 在任务执行过程中创建的所有页面 —— 研究笔记、摘要、初稿,以及任何写入工作区的内容 —— 都会列在任务详情页的 Artifacts 区域。你可以直接打开、分享或继续编辑,全程不离开任务。
任务支持两种运行方式。
默认方式。Agent 立即执行任务、提交结果,然后把任务推进到 Pending Review 等待你确认。绝大多数不需要重复的需求都用这种。
把任务设置成定时计划,Agent 会按计划自动重新执行。每次运行的结果都会追加到同一个任务里,形成一份可对比的历史记录。
支持的周期:
你可以在任务详情页随时暂停、恢复或修改计划。暂停会保留历史;删除会同时清除任务及其所有运行记录。
下面这些场景特别适合做成任务: