task Power

管理个人待办、Agent 工作、收件箱事项和时间安排

task 用同一套任务记录事情、执行工作并安排重复触发。TaskPower 只负责领域能力,Desktop App 原生提供收件箱、待办和日历入口;Agent 可以在聊天中创建和处理同一份任务。

任务身份

每件事拥有稳定 task_id。标题可以修改,也允许同名。create 返回 ID,list 返回任务 ID 和工作属性;后续操作优先使用 ID。

现有动作的定位参数名为 title,它可以接受稳定任务 ID,也可以接受唯一标题。同名标题无法确定目标时会明确报错。

常用动作

动作用途
create创建个人待办、Agent 或脚本任务。
list查看当前 Agent 的任务及个人待办。
update修改标题、内容或执行安排。
run启动一次 Agent/脚本执行,可用 occurrence_id 重试周期发生项。
history / run_detail查看执行记录与产物。
inbox查看待整理任务和未处理事项;读取不会完成事项。
work整理、开始、完成、重开、验收、要求修改或处理指定事项。
status / enable / disable调整自动调度启停,不改变工作完成状态。
delete删除任务及执行历史;运行中拒绝删除。

创建个人待办:

{ "title": "准备周五演示", "kind": "self" }

创建定时 Agent 工作:

{
  "title": "生成日报",
  "kind": "agent",
  "when": "0 9 * * *",
  "description": "汇总当天进展",
  "body": "读取项目记录,输出进展、阻塞和下一步。最终回复直接输出日报正文。"
}

处理收件箱中的验收请求,需要原任务和事项 ID:

{ "task_id": "task_example", "command": "accept", "item_id": "review:example" }

仅在用户明确确认结果后验收;Agent 不应自行批准自己的交付。

工作与执行

kind=self 由用户完成,到时产生提醒,不需要 Agent 或 Workspace。Agent/脚本任务按定义绑定的执行目标运行。一次性 Agent 工作执行成功后等待人工验收;周期工作默认按每次成功结果完成,可在任务详情开启逐次验收。

when 支持 @manual、time:<带时区的 ISO 时间> 和 Cron。计划时间与截止日期不同:截止日期不会触发执行。周期任务每次发生单独记录,完成本次不结束周期。

自动调度依赖运行中的 City。错过的一次性计划进入收件箱;离线周期触发不集中补跑。审批与补充问题仍在原执行会话处理;运行中的任务暂不支持编辑或取消。

从聊天创建 Agent 工作时,结果可返回创建任务的原会话;修改执行目标不会移动该交付会话。没有创建会话的任务在执行历史查看结果。向外部聊天发送内容需明确要求执行 Agent 调用 Messenger。

使用界面与时间安排的详细说明见 Task Power。