任务
任务是可追责工作的单位：Agent 处理的任何事情都会成为任务，你分配给同事的任何工作也会成为任务。一个任务包含状态、优先级（1–5）、负责人（某个人、某个指定 Agent，或在未分配时的主 Agent）、截止时间、评论、附件、子任务，以及——当由 Agent 运行时——完整的执行记录。
创建任务
- 看板：Tasks → New Task。
- 聊天：向 Agent 提出请求——"创建一个明天的任务，跟进 Hayes 的预订"。
- 渠道：入站消息（邮件、WhatsApp 等）会在其路由到的工作区中创建任务。
- 自动化与工作流：定时任务和工作流运行会创建它们所处理的任务。
- 预订链接：确认的预订会成为一个任务。
状态与看板
任务状态：created、proposed、pending、scheduled、in_progress、waiting_on_customer、on_hold、blocked、completed、cancelled、failed——并强制执行合法的状态转换（非法转换返回 409）。GET /api/v1/tasks/constants 返回完整的状态机。
看板将状态分为五列：
| 列 | 状态 |
|---|---|
| 待办 | created, pending, proposed |
| 已排期 | scheduled |
| 进行中 | in_progress |
| 需要关注 | waiting_on_customer, on_hold, blocked, failed |
| 已完成 | completed, cancelled |
拖拽卡片即可变更状态。看板与列表模式、可见列以及列顺序都是按用户保存的偏好，并跨设备同步。内置日历标签页和 CSV 导入。集合（带图标和颜色的分类）可在整个看板上对任务分组。
任务详情
任务页面展示：属性（状态、优先级、负责人、截止时间、分类、请求者）、Markdown 描述、评论（Markdown + 附件；对等待中任务的评论会将其恢复，@ 提及某个 Agent 会将其派发）、子任务、生成的输出文件，以及执行时间线——来自 Agent 运行的计划步骤、工具调用和状态变更。
如果在创建时就分配了 Agent，运行会立即开始。POST /api/v1/tasks/{task_id}/retry 重新运行失败的任务（复用或重新生成其计划）；等待你决定的审批步骤可以直接在任务中处理——参见人工审批（HITL）治理。
交付检查与恢复
对于由协调器管理的任务，完成检查会核对提交的文件及其知识库记录。文件必须可访问，并与相应步骤关联；仅仅存在该文件，并不能证明其内容符合请求。可纠正的审核错误会返回同一个 Agent 执行循环。审核错误本身不会授权重复已经完成的文件写入步骤。
如果旧任务在交付审核期间错误地暂停，可调用 POST /api/v1/tasks/{id}/resume-delivery-review，并提供准确的 expected_plan_id 和 expected_state_version 来恢复。服务器会在恢复审核前检查原运行、已完成步骤、文件、待处理决定和操作结果。发生冲突时请求会被拒绝；此端点既不会批准待处理操作，也不会将任务标记为完成。常规任务重试和审批控件仍分别处理。
在 Manor 之外共享工作
无需认证、以访问码限定范围的任务端点，让外部协作者不必注册账号也能更新任务：为任务生成一个会话访问码后，持码者可以查看任务、更新状态、完成任务或留下客户评价（/api/v1/public/task/...，访问码 7 天后过期）。
SLA 策略
定义 SLA 策略（/api/v1/tasks/sla-policies）并将其附加到任务上；违约会在任务和报表中显现。
API 摘要
| 端点 | 用途 |
|---|---|
GET /api/v1/tasks、POST /api/v1/tasks | 列表（支持状态/工作区/分类筛选）与创建 |
GET /api/v1/tasks/board | 带计数的看板分组 |
GET/PUT /api/v1/tasks/board-preferences | 按用户的看板偏好 |
POST /api/v1/tasks/{id}/move | 状态转换（带校验） |
GET/PUT/DELETE /api/v1/tasks/{id} | 读取 / 更新 / 删除 |
POST /api/v1/tasks/{id}/retry、/hitl-response、/approval | Agent 运行控制与审批 |
GET/POST /api/v1/tasks/{id}/logs、/attachments、GET /{id}/history | 评论、文件、审计 |
GET/POST /api/v1/tasks/categories | 集合 |
GET/POST /api/v1/tasks/templates、POST .../{id}/instantiate | 支持 {{variable}} 渲染的任务模板（仅 API 提供） |