跳到內容

排程與背景工作

agent 平常是你寫了才回答。 有三種方式,能讓它在你不在頻道裡的時候做事:排程、委派的任務,和傳給你的私訊。

排程會在設定的時間叫醒 agent,用的是它自己寫給自己的提示詞,agent 的回答會貼在建立排程的那個頻道。 要建立排程,在那個頻道裡說:

每個工作日早上 9 點,在 notes 頻道貼一段簡短的摘要,說明筆記有哪些變動。
45 分鐘後提醒我寄發票。
每週一和週四下午 5 點半,問我完成了什麼。
工具 作用
schedule_create 用 title、prompt 和一種時間設定建立排程,可另外指定 precheck 和 time_limit_minutes。
schedule_list 列出這個頻道的排程、下次執行時間,以及 host 提供的預檢;給 id 則完整列出單一排程。agent 會看到自己在所有對話裡的排程,並標明各自在哪裡執行;也能用 agent 讀另一個 agent 的排程。
schedule_update 修改單一排程的標題、提示詞、時間、預檢或時間上限(precheck: null、time_limit_minutes: null 會拿掉它們)。執行中的那一輪可以用它更新自己的提示詞。
schedule_cancel 刪除一個排程;agent 可以取消自己在任何對話裡的排程。

owner 和 admin 能建立、修改、取消排程。任何說話的人都能列出排程。 agent 只能改自己的排程,不論是它的哪一段對話(Discord 或網頁 app)建立的;要改別人的,請那個 agent 去改。

時間設定是下列其中一種:

欄位 執行時機
in_minutes 一次,從現在起算幾分鐘後。
at 一次,在 YYYY-MM-DD HH:MM。
time 每天的 HH:MM。加上 every_days(1 到 365)可改成每隔幾天,從 start_date 起算;加上 weekdays 可指定星期幾。
  • 一個頻道最多 20 個排程,提示詞最多 8,000 個字元。
  • 第一次執行必須在 366 天以內。已經過去的時間會被拒絕。
  • 排程器每 30 秒檢查一次有沒有到期的排程。
  • 發現已經晚了超過 12 小時的執行,例如 bot 停機期間錯過的,會直接跳過,不會補跑。
  • 排程用建立者的層級執行,所以層級比較低的人不能改寫它。
  • 封存 agent 會取消它的排程。

排程的那一輪和任何一輪一樣,工作 10 分鐘就會被停下來,因為對話裡沒有人可以問要不要再給時間。 工作比較久的排程可以用 time_limit_minutes 設定自己的上限,範圍 1 到 240(四小時),這個排程的每次執行都適用,而且不會超過 host 的長時間執行上限。 替 agent 的房間開啟長時間執行,則是讓它所有的回合都這樣。 執行到上限被停下時,頻道會貼一則通知,說明停在哪裡,以及怎麼讓它有更多時間。

如果這一輪沒有東西要回報,可以什麼都不回答:頻道不會收到任何訊息,這一輪也算完成。 所以像「沒有進展就什麼都不要送」這種提示詞,照字面寫就可以。

預檢(precheck)是 host 在排程那一輪開始前先跑的便宜檢查。像每天的例行檢查,大多數日子的答案都是「一切正常」,有了預檢,這些日子就不必花一輪模型呼叫。 預檢由 host 的 plugin 以名稱註冊;schedule_list 會列出名稱和說明,agent 用 precheck 把它掛到排程上。

  • 預檢沒發現問題時,這一輪不會執行,可以改在頻道貼一則小字備註。
  • 發現問題時,這一輪照常執行,並把發現的內容接在提示詞後面。
  • 預檢失敗或逾時(預設 60 秒,預檢可以自訂)時,這一輪仍會執行,並帶上錯誤,讓 agent 去查。

schedule_list 和 /roundtable schedule list 的上次執行會顯示是哪一種情況,例如 skipped by precheck (HRV 52 ms, as usual.)。 掛上預檢的層級規則和修改排程相同。

如果 host 有啟用 pi-roundtable-sandbox 的預檢執行器,agent 也可以用 precheck_script 自己寫排程的預檢:一小段 JavaScript,透過 host 為這個排程開放的 MCP tools 讀取需要的資料,再回傳要不要叫醒。 腳本在沒有網路、碰不到 host 檔案的隔離容器裡執行,不會在 bot 自己的行程裡跑。 schedule_list 會說明怎麼寫、能呼叫哪些 tools;沒有執行器時,工具不會提供腳本這個選項。 腳本呼叫 tools 時,和 agent 自己呼叫一樣要遵守 hold 規則:腳本若會呼叫需要確認的 tool(例如寄信),存檔時要先經 owner 核准一次;之後每次執行,都只能呼叫存檔時記下的那些 tools。 註冊方式請看服務與 addon。

時間以 roundtable.config.ts 的 timeZone 為準,沒設定就是 UTC。 工具會把時區和目前時間告訴 agent,時間已經過去而被拒絕時,回應裡也會寫出這兩項。 見設定。

/roundtable schedule list 顯示所有頻道的排程。 /roundtable schedule cancel 取消一個排程,並有自動完成的清單可以選。 這個指令只有你能用,回應也只有你看得到。

agent 能用 delegate_task 把一大段研究交給背景 worker。它需要 title,以及一份獨立完整的 task,最多 4,000 個字元。

  • worker 只有網路搜尋和網頁閱讀的能力,也只看得到那份任務。
  • agent 繼續跟你工作。worker 回報時,報告會在那個頻道變成新的一輪,agent 再用它回答你。
  • Discord 允許的地方,頻道裡會開一個 thread 放這份任務。thread 以報告結尾;worker 失敗的話,則以錯誤結尾。
  • 一個頻道同時能跑 3 個委派的任務。
  • 跑了 20 分鐘的任務會被停掉,並回報為失敗。
  • 執行中的任務存在記憶體裡。重啟會把它們丟掉,頻道也不會再收到它們的回報。

worker 使用 delegation 設定裡的模型。沒設定的話,用 agent 的模型,thinking level 為 medium。 開 thread 需要 bot 有 Create Public Threads 權限;見設定 Discord bot。

notify(0.8 叫 notify_owner,到 1.0 之前仍可使用)會在工作來源那段對話所在的 surface 上通知你:從 web app 的 room 來,就是 web app Home 上的一則通知加上推播到你的裝置;從 Discord 來,就是一則 Discord 私訊。 agent 只在你要求通知或提醒時才用它,因為平常的回覆本來就會出現在對話裡。 只有你自己發起的那一輪能用它。

每週五下午 4 點檢查還沒完成的工作,把清單用私訊傳給我。

agent 送出的一切,都回到工作來源的那段對話,留在它的 surface 上。 在 web app room 建的排程就在那個 room 跑,它的報告和它發的通知都留在 web app;在 Discord 頻道建的就留在 Discord。 委派或寫程式任務的 thread 和報告、提問卡、逾時卡、agent 之間的訊息也一樣:message_agent 沒指定對話時,從 room 發出就送到對方的 room,從 Discord 發出就送到對方的 Discord 頻道。

只有在那段對話自己的 surface 聯絡不到你時(例如排程跑在一段沒有 surface 的對話裡,而這台主機上你沒有 web app),通知才會改走別的 surface,主機會記一筆 log,寫明兩個 surface。 web app 也可能把 Discord 已送達的通知推播到你的手機:這份回聲只給你本人,從不進到任何對話。