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