自動化端點
最後更新
排程執行的端點。
Cron 與一次性任務合併為同一組介面。原本分離的
/v1/cron* 與 /v1/task* 已於 v0.33.6 由 /v1/schedule 取代，以 type=cron|task 區分。| Method | 路徑 | 說明 |
|---|---|---|
GET | /v1/schedule | local — 將 cron 條目與一次性任務合併成一個 schedules 陣列，各自標記 type=cron|task；?type= 可只取其一 |
GET | /v1/schedule/*skill | local — 讀取 scheduler skill（不存在回 404）：name（另以 skill 回傳同值）與 body，其中 body 自 v1.0.2 起是含 frontmatter 的原始 SKILL.md，不再是解析掉 frontmatter 的主體。files 以與 GET /v1/skill/*name 相同的規則附上該 skill 的 scripts/／references/／assets/ 內容。description 欄位已移除 |
POST PATCH | /v1/schedule | local — {type, name, content, expressions, session_id?}。建立（POST，名稱已被使用回 409）或更新（PATCH，不存在回 404）scheduler skill，並把整組條目重新綁到 type=cron|task；切換 type 會丟棄該 skill 在另一種型別下持有的條目。description 已於 v1.0.2 移除。content 若本身就以 --- frontmatter 開頭則原樣寫入；否則由 server 端補上最小的 ---\nname: <name>\n--- 標頭。name 為 1-64 個 A-Z a-z 0-9 _ - 字元。expressions（至少一筆）在 cron 為 cron 表達式，在 task 為未來的時間（+<duration>、YYYY-MM-DD HH:MM、RFC 3339，或當天的 HH:MM）。session_id 預設沿用該 skill 既有的 session，沒有則新建 chat- session。回傳 {type, name, session_id} |
DELETE | /v1/schedule | local — {skill, type?}。刪除某 skill 的條目（type 可縮限其一，省略則兩者皆移除），若無其他綁定則一併把 skill 移入垃圾桶；回傳 {ok, removed, trashed}，沒有任何條目被移除時回 404 |
POST | /v1/schedule/run | local — {session_id, skill}，皆必填。立即觸發一則排程，不等候執行即回 202 {ok, started:true} |