logo
開發者文件
搜尋
定時任務 NEW

定時任務 NEW

概述

定時任務(Scheduled Tasks)讓 Agent 自動定期執行預設任務 —— 無需你手動啟動對話。桌面 APP 獨有功能。

典型情境:

  • 每天 9:00 抓取 5 個競品官網,對比變化,發到釘釘
  • 每週一 18:00 從 Gmail 搜尋本週所有「合約」相關郵件,彙總成 Excel 並寄給老闆
  • 每 30 分鐘檢查一次郵件,如有緊急郵件發微信通知我
  • 每月 1 日產生上月的團隊工作總結報告

截圖位置


入口

桌面 APP → 左側設定選單 → 定時任務


三種排程模式

模式 英文標識 說明 設定
一次性 at 指定時間點執行一次 選擇日期時間
週期 interval 按固定間隔重複執行 間隔數 + 單位(分鐘/小時/天)
Cron cron 標準 Cron 表達式 5 欄位 Cron(如 0 9 * * 1 = 每週一 9:00)

常用 Cron 表達式

表達式 含義
0 * * * * 每小時整點
0 9 * * * 每天 9:00
0 9 * * 1 每週一 9:00
0 0 1 * * 每月 1 日 0:00
*/15 * * * * 每 15 分鐘
0 9-18 * * 1-5 工作日 9:00-18:00 每小時

執行模式

建立任務時選擇執行方式:

模式 說明
normal 每次執行共用同一個持久工作階段
isolated 每次執行都新建獨立工作階段,互不干擾
persistent 持久工作階段,保留歷史上下文
selected 使用指定的既有工作階段

選擇建議

  • 彼此獨立的任務(如每日監控) → isolated
  • 希望 Agent 記住之前的結果(如持續跟進的專案) → persistent
  • 需要複用既有工作階段的上下文 → selected

通知設定

任務執行完成後可以透過多種管道通知你:

通知管道 要求
Telegram 需先設定 Telegram 管道
釘釘 需先設定 DingTalk 管道
飛書 需設定飛書 webhook
企業微信 需設定企業微信 webhook
Slack 需先設定 Slack 管道
Teams 需先設定 Teams 管道
Discord 需先設定 Discord 管道
郵件 填寫收件信箱

管道設定詳見 渠道配置

通知內容:任務執行狀態(成功/失敗)+ 簡要摘要或完整輸出


任務詳情頁

每個任務的詳情頁包含:

區域 內容
基本資訊 名稱、描述、建立者、建立時間
排程設定 模式(at/interval/cron)+ 參數
執行模式 normal / isolated / persistent / selected
任務 Prompt Agent 每次執行的指令內容
通知設定 啟用的通知管道列表
執行狀態 nextRunAtMslastRunAtMslastStatuslastDurationMs、連續失敗次數
執行歷史 每次執行的獨立記錄(狀態、開始時間、持續時長、錯誤日誌)

執行歷史(AllRunsHistory)

每個任務都有獨立的執行歷史表:

說明
執行時間 該次執行的開始時間
狀態 成功 / 失敗 / 逾時 / 中斷
持續時長 執行所用時間
結果摘要 輸出的前若干字元
錯誤資訊 失敗時的錯誤堆疊(可展開)

支援按時間、狀態篩選。


操作指南

建立一個定時任務

  1. 開啟 APP → 設定 → 定時任務
  2. 點擊 + 新建任務
  3. 填寫基本資訊:
    • 名稱:如「每日競品監控」
    • 描述:簡要說明
  4. 選擇排程模式
    • 一次性:選日期時間
    • 週期:輸入間隔數和單位
    • Cron:填寫 Cron 表達式
  5. 填寫任務 Prompt
    請抓取以下 3 個競品官網的首頁, 對比它們昨天和今天的變化(新產品、新公告、新定價), 輸出變化摘要: - 竞品 A: https://... - 竞品 B: https://... - 竞品 C: https://...
                          
                          請抓取以下 3 個競品官網的首頁,
    對比它們昨天和今天的變化(新產品、新公告、新定價),
    輸出變化摘要:
    - 竞品 A: https://...
    - 竞品 B: https://...
    - 竞品 C: https://...
    
                        
    此代碼塊在浮窗中顯示
  6. 選擇執行模式(通常選 isolated
  7. 設定通知管道(如釘釘)
  8. 儲存

手動觸發一次

在任務列表點擊任務列的 立即運行 按鈕,可以手動觸發一次執行(不影響下一次預定執行時間)。

暫停 / 恢復任務

任務詳情頁有 啟用/禁用 開關。禁用後任務停止排程,但保留設定,可隨時恢復。


組織隔離

定時任務按 orgId 隔離 —— 你只能看到自己所在組織的任務。切換組織時,任務列表也會切換。

帳號切換影響:如果目前登入使用者變更(跨帳號切換),工作階段中的任務不會終止,但後續執行時會校驗歸屬。


常見問題

定時任務能執行有權限彈窗的工具嗎

任務執行時會觸發工具權限彈窗。如果此時你在 APP 前台,可以回應;如果無人回應,系統按以下規則處理:

  • 同帳號:如果 APP 在線,彈窗會顯示,使用者可回應
  • 跨帳號 enterprise 情境:5 分鐘無回應則預設拒絕

為避免阻塞,建議:

  1. 將定時任務常用的 Bash、Web Fetch 等工具設為 P0(APP 自動執行)
  2. 使用「總是允許」選項把常用命令加入白名單
  3. 运行时安全 中針對性設定

任務執行失敗怎麼辦

查看任務詳情頁的執行歷史 → 失敗記錄 → 錯誤資訊。常見原因:

  • 模型 API Key 過期:去「模型」頁重新設定
  • 網路問題:工具可能無法存取外網
  • 權限逾時:參考上一問
  • LLM 限流:增加重試間隔或改用更高配額的模型

連續失敗達到閾值時,任務會自動暫停並發通知。

APP 關閉了任務還會執行嗎

不會。定時任務需要 APP 在線才能觸發。如果你需要 7×24 執行,請:

  1. 讓 APP 常駐執行(macOS 背景執行 / Windows 系統匣)
  2. 考慮用一台一直開機的備用機部署 APP

能否和 Work 的 "scheduled-task" 技能配合使用

可以。Work 對話中如果啟用了 scheduled-task 技能,Agent 可以在對話中代你建立定時任務。例如說「每天 9 點幫我抓取這 3 個網站」,Agent 會呼叫 scheduled-task 技能自動建立一個任務。


相關文件