OneCLI定時任務實戰(zhàn)如何讓AI Agent按計劃自動喚醒干活完整配置教程與避坑清單【免費下載鏈接】onecliOpen-source sandboxed agent harness for teams. Giving every employee a secured personal agent.項目地址: https://gitcode.com/gh_mirrors/on/onecliOneCLI 定時任務是這款開源沙箱 Agent 平臺的核心能力之一OneCLI 讓每位員工擁有一個安全的個人 AI Agent而它的「A schedule」機制能讓 Agent 按計劃自動喚醒干活——比如每天早上 9 點匯總收件箱、每小時巡檢一次線上服務。本文是一份面向新手的完整配置教程帶你用最少的代碼把 Agent 定時喚醒跑起來并附一份避坑清單。什么是 OneCLI 的定時任務Cron在 OneCLI 中Agent 不只是「問一句答一句」它是一件持久存在的資產有自己的沙箱、對話、記憶和技能還有一份日程表。平臺會在正確的時間點喚醒沙箱、把任務提示詞作為一輪對話發(fā)給 AgentAgent 干完活后把報告投遞回當初創(chuàng)建定時任務的那個聊天窗口。整個喚醒鏈路托管在控制面而不是沙箱里計劃存控制面定時任務行由 agent-cron-service.ts 統一管理沙箱重啟不影響計劃。Runner 輪詢觸發(fā)由 cron-fire-service.ts 在 Runner 每次輪詢時檢查到期任務并點火。報告自動送達每次運行在獨立對話中進行報告自動發(fā)回創(chuàng)建任務的聊天你不用守屏。兩種配置方法聊天里說一句話 / 控制臺可視化方法一直接在聊天里說推薦新手Agent 自帶三個平臺工具schedule_task創(chuàng)建、list_tasks查看、cancel_task取消工具契約定義在 crons.ts。你只需要用自然語言說“每天早上 9 點檢查支持郵箱把緊急事項匯總發(fā)給我?！盇gent 會調用schedule_task建好計劃。注意它必須有一個明確的 IANA 時區(qū)如Asia/Shanghai。如果你沒說時區(qū)Agent 會主動問你——這是刻意設計因為「14:00」沒有時區(qū)就沒有意義。方法二Dashboard 的 Schedules 頁面進入某個 Agent 頁面 →Schedules標簽 → 點New schedule會彈出一個配置對話框實現見 cron-dialog.tsx/w/[workspaceId]/agents/[agentId]/schedules/_components/cron-dialog.tsx?utm_sourcegitcode_repo_files)。需要填 4 個字段字段說明Name簡短可讀的名字會顯示在每份報告上What should it do?每次運行要執(zhí)行的任務指令Runs四種預設每天 / 每小時 / 指定時間執(zhí)行一次 / 自定義 cron 表達式TimezoneIANA 時區(qū)默認自動取你瀏覽器的時區(qū)保存后任務列表每一行會顯示cron 表達式、時區(qū)、下次觸發(fā)時間、上次運行結果以及三個操作Run now立即手動跑一次、編輯、暫停/恢復開關。常用定時任務類型速查預設本質上在拼標準 5 段 cron 表達式分 時 日 月 周每天 14:00→0 14 * * *?每小時第 0 分→0 * * * *工作日早會提醒→0 9 * * 1-5自定義欄填寫?一次性任務→ 用2026-09-27T09:00:00這樣的 ISO 本地時間到點觸發(fā)一次后任務自動標記為 Completed校驗由服務端 croner 引擎負責創(chuàng)建時就用「將來真實計算下次觸發(fā)的同一個對象」來驗證表達式不存在「保存成功但永遠不觸發(fā)」的行見 validations/crons.ts。避坑清單這些細節(jié)決定定時任務靠不靠譜? / ?? 對照檢查基本能避開所有新手坑?? 時區(qū)必填且必須是 IANA 名稱寫UTC、Asia/Shanghai這類名字寫中文或CST這類縮寫會被拒絕。?? 每個 Agent 最多 20 個定時任務這是可用性上限MAX_CRONS_PER_AGENT規(guī)劃時把大任務拆給不同 Agent。?? 任務可能在 5 分鐘內遲到平臺給每次觸發(fā)加了 0~300 秒的「只晚不早」抖動避免全公司「每天 9 點的日報」同時驚起一堆沙箱。別把它當 bug。?? 上一輪沒跑完時本輪會跳過結果記為skipped_busy下個周期自動重試。所以長任務比如跑半小時的爬取別配 15 分鐘一次的計劃。?? 連續(xù)失敗 5 次會自動停用任務不會無限報錯轟炸你行上會出現 Auto-disabled 徽標修復后手動打開開關即可恢復CRON_FAILURE_DISABLE_THRESHOLD。?? 創(chuàng)建者失去工作區(qū)權限后任務會因授權失效自動停用安全設計離職/調崗賬號的定時任務不會繼續(xù)持有「落腳點」。? 平臺停機期間的觸發(fā)會合并成一次補發(fā)按當前時間重新計算下一次觸發(fā)不會積壓一堆補跑。? 一次性任務觸發(fā)后是「完成」而非「故障」行上顯示 Completed 徽標屬正常終態(tài)。? 先用 Run now 驗證創(chuàng)建后點一下立即執(zhí)行確認報告能正常回到聊天窗口再放心交給計劃。? 任務名要描述性名字會拼在每一份自動報告的頭部Daily inbox check遠好于task1。想看源碼關鍵路徑在這里平臺工具與能力片段教 Agent 使用 schedule_task 的提示詞就在這里apps/sandbox-supervisor/src/capabilities/crons.ts計劃行服務創(chuàng)建/更新/停用、下次觸發(fā)計算packages/api/src/services/agent-cron-service.ts點火邏輯到期認領、授權復查、跳過與完成packages/api/src/services/cron-fire-service.ts參數校驗與上限名稱 100 字符、提示詞 1 萬字符packages/api/src/validations/crons.tsDashboard 調度面板apps/web/src/app/(dashboard)/w/[workspaceId]/agents/[agentId]/schedules/端到端行為驗證apps/hosted-e2e/tests/cron.test.ts小結OneCLI 定時任務的設計哲學是「計劃歸平臺執(zhí)行歸沙箱結果歸聊天」你只需說清「什么時間、做什么、哪個時區(qū)」喚醒、授權復查、失敗自愈都交給控制面。按上面的步驟配置一遍再對照避坑清單檢查一遍你的 AI Agent 就會像靠譜的同事一樣到點自己開工、干完自動匯報?！久赓M下載鏈接】onecliOpen-source sandboxed agent harness for teams. Giving every employee a secured personal agent.項目地址: https://gitcode.com/gh_mirrors/on/onecli創(chuàng)作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考