任務
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。