任务
Task 用来持续跟进一件要做的事。它保存标题、状态等结构化信息,不会因为创建了记录就启动工作,也不会到截止时间自动提醒。
从创建到完成
创建时把目标说清楚:
创建一个高优先级任务:在 2026-12-01T18:00:00+08:00 前确认出行证件,标签 travel。返回任务 ID。
标题必填;说明、优先级、截止时间、标签和 metadata 按需添加。之后使用返回的任务 ID 更新,标题能唯一定位时也可以先让 Anyy 查找:
把任务 TASK_ID 改成 blocked,说明正在等材料,并提高到 urgent。
清除任务 TASK_ID 的截止时间,把标签替换为 travel 和 documents。
完成任务 TASK_ID,备注:材料已核对。
完成后会保存完成状态与可选备注。更新至少要提供一个修改字段。用 ID 操作前先核对事项,尤其是存在相近标题时。
查看还要做什么
列出本周五前到期的 urgent 任务。
查找带 travel 标签、提到证件的事项,已完成的也包括。
可按状态、优先级、截止时间前后、文本和标签筛选。默认列表只包含 pending、in_progress、blocked;需要完成历史时明确要求包含已完成项。cancelled 要通过状态单独查询。默认返回 20 条,最多 50 条。
字段和状态怎么用
| 字段 | 可用值或限制 |
|---|---|
| Status | pending、in_progress、blocked、completed、cancelled |
| Priority | low、normal、high、urgent |
| Due time | 带时区的 RFC 3339 时间 |
| Title | 最多 240 字符 |
| Description | 最多 4,000 字符 |
| Labels | 最多 20 个,每个最多 48 字符;转为小写并去重 |
任务变更有审计,按当前运行作用域解析;Role 和 Workspace 可能影响哪些记录可见、可修改。
和执行、自动化有什么不同
- Task ID 标记待办,不代表一次正在运行的 Agent 工作。
- Execution 是实际执行过程。
- 后台 Job 在独立会话中继续工作,使用自己的 Job/Run 标识和状态。
- Cron Job 保存计划,每次触发再产生运行记录。
如果既要跟进完成情况,又要在某个时间提醒或执行,应分别创建 Task 和定时自动化。耗时工作要转到后台时,使用后台 Job。