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。