PerchAI
使用 Perch

背景工作

長指令與委派出去的代理人會在背景執行,你同時還能繼續使用聊天,而其中一項完成後,Perch 可以自行把工作接續下去。

有些工作要花上幾分鐘:一套測試、一次建置、一次漫長的安裝,或是一件你寧可不要盯著看的工作。Perch 可以啟動它、放手不管,等它完成後再回來處理,而不是卡在那道指令裡,讓對話乾等。

在背景執行的有兩種不同的東西,值得分清楚。

背景指令

背景指令是 Perch 在你電腦上啟動、而且不等待的程式。回合會繼續往下走,而該指令在回合結束後仍會繼續執行。

Perch 用五項工具來操作它們:

工具作用
run_in_background以分離的工作形式啟動指令,並立刻回傳一個工作 id。
list_background_tasks列出這些工作與它們的狀態。
check_background_task在不阻塞的情況下讀取最新輸出。
wait_for_background_task阻塞直到它完成。
kill_background_task停止它。

harness 保證的事:

  • 紀錄能撐過重新啟動。 工作會保存在磁碟上,因此離開 CLI 或關閉應用程式都不會把它們跟丟。若 Perch 回來時某個工作的程序已經不在,它會被回報為狀態未知,而不是當成還在默默執行。
  • 輸出會被擷取到檔案。 Perch 會保存合併後的輸出,有容量上限;當某個工作寫出的內容超過上限時,會保留開頭與結尾。工具結果只顯示簡短的預覽,而不是整份紀錄。
  • 同時執行的數量有限。 一台電腦上能一起執行的背景工作數量有限。超過上限時,新的工作會被拒絕,直到有一個完成或被停止。
  • 一小時。 看門程序會停止已經執行一小時的背景工作。

直接用講的就行。「把測試套件放到背景跑,然後繼續」就夠了。

Perch 回頭處理已完成的工作

真正好用的地方,是背景工作結束時會發生什麼。Perch 可以自行開啟一個回合去讀結果並把工作接續下去,因此推動工作往前的是建置完成這件事,而不是你發現了之後說「好,然後呢」。

這只會在護欄之內發生:

  • 只在 Auto Review 與 Take the Wheel。 在 Default 下,Perch 絕不會自行開啟回合,因為 Default 的重點就是你在場逐步核准。
  • 快到微不足道的指令不算。 在幾秒內就結束的指令不會喚醒任何東西。否則一道快指令就會變成一個昂貴的迴圈。
  • 每個聊天都有硬上限。 在一個聊天中自行開啟的回合有上限,因此一個不斷重啟自己的工作不可能無止盡地轉下去。

對話紀錄會標示這些回合,所以你隨時都看得出來是 Perch 開啟的,而不是你。

背景代理人

背景代理人是把一整件工作交給協助者,而不是一道指令。/delegate <task>,或 /bg,會把範圍明確的工作交給一個自行執行的代理人,完成後結果會回到同一個聊天。

/delegate summarize every PDF in ./contracts and list the renewal dates

當工作能自成一體,而你寧可繼續做別的事也不想盯著看時,就用它。如果工作中途需要你提供輸入,或你想引導它,那就留在主工作階段。

在 CLI 中,/agents 列出這個聊天的代理人,/agents <id> 印出某個代理人的步驟與報告,/agents stop <id> 則會停止它。

代理人受到的限制與背景指令相同:有自己的步驟上限、30 分鐘的實際時間,以及 10 分鐘沒有輸出就算停滯。每份結果都會說明代理人為何停下,包括它碰到某個上限的情況。/delegate 需要一個持續開著的工作階段,因此在一次性的 perch run 中無法使用。

關於 Perch 在一個回合內啟動的協助者,以及子工作階段,請參閱子代理人。關於一整組成員共同處理一件工作,請參閱 Flock。