PerchAI
使用 Perch

雲端代理

在私有雲端工作區執行 Perch 任務,關閉分頁後仍會繼續。從網頁、手機或 Slack 啟動,指定 GitHub 儲存庫,再審閱它推送的分支。Pro 測試版功能。

測試版

每個 Pro 帳號都已啟用雲端代理。如果你在選擇訊息執行位置的選單看到 Cloud,就代表已為你啟用。

雲端代理與你在桌面版使用的是同一個 Perch 代理,只是在私有雲端工作區執行,而非你的電腦。工作區有自己的檔案與終端機。關閉分頁、結束應用程式或收起手機後,它仍會繼續工作;回來時,對話串中的結果會等著你。

開始雲端工作階段

在網頁開啟 Perch Terminal

前往 chat.perchai.app,從 Perch AI 切換至 Perch Terminal,或直接開啟 chat.perchai.app/agents/desktop。任何瀏覽器都可使用,包括手機上的瀏覽器。

選擇 Cloud

訊息輸入區的第一個膠囊按鈕會顯示下一則訊息的執行位置。開啟並選擇 Cloud。在 Perch Desktop,相同選單會提供你的電腦與 Cloud。

任務需要時選擇儲存庫

進行程式碼工作時,從旁邊的膠囊按鈕選擇 GitHub 儲存庫與分支。研究、寫作或其他不涉及儲存庫的工作,則維持 No repository。

描述任務並送出

像向同事交代工作一樣描述:要改什麼、如何檢查,以及希望取得什麼。程式碼工作適合以「接著執行測試,並推送到新分支」結尾。

送出之後會發生什麼

第一則訊息會為工作階段啟動私有沙箱。對話串中的 Session 列會顯示準備狀態,需耗時數秒。如果在回合結束後不久傳送後續訊息,Perch 會重用仍待命的工作區,讓下一個回合更快開始。

之後,執行過程會即時串流至對話串:Perch 的思考、執行的每個指令與修改的每個檔案。對話串在所有開啟的介面都會即時更新,因此你可以在手機開始工作,再在桌面版看它完成。

你可以關閉所有介面。執行不依賴任何裝置保持開啟。

在手機上,將 Perch 加入主畫面。使用 Pro 時,執行需要你的核准或已完成,都可以通知你。

處理 GitHub 儲存庫

第一次選擇儲存庫時,Perch 會要求連接 GitHub:

  1. 在訊息輸入區選擇 Connect GitHub。
  2. Perch 會顯示一組簡短代碼。選擇 Open GitHub,輸入代碼,並核准儲存庫存取權。
  3. 核准後,Perch 可以複製你有推送權限的儲存庫、在其中提交,並推送分支。

執行期間,Perch 會在你所選分支的複製版本中工作,並將成果推送到以 perch/ 加上簡短識別碼命名的新分支。不會替你合併任何內容。

若要審閱成果,請開啟對話串的 Changes 面板。它會列出每個變更檔案與差異。你可以在此使用 Create PR 或 Create draft PR;建立 pull request 後,View PR 會帶你前往 GitHub 上的該請求。

已連接的工具

在 Settings › Connections 連接的遠端 MCP 伺服器可供雲端工作階段使用,讓執行能讀取你現有系統中的資料。

本機 MCP 伺服器,也就是在電腦的 ~/.perch/mcp.json 設定的伺服器,則無法使用。雲端工作區無法連到你的電腦。需要本機檔案、本機應用程式或本機伺服器的任務,應改在電腦上執行。

步驟需要你的核准時,對話串會提出要求並等待,與桌面版相同。從你開啟的任何畫面回覆即可。

Slack

不必開啟 Perch,也能交付任務。

  1. 在網頁版 Perch Terminal,前往 Settings › Connections,選擇 Add to Slack。
  2. Perch 要求時,將 Slack 帳號連結至 Perch 帳號。
  3. 傳送私訊給 Perch,或在頻道中提及它。

每則訊息都會以雲端工作階段執行,答案會回到相同的 Slack 對話串。一個 Slack 對話串對應一個 Perch 對話串,也會出現在對話串清單,讓你之後能在 Perch Terminal 繼續。

如果步驟需要核准,Slack 會提示你開啟 Perch 回覆。目前尚不支援在 Slack 內核准。

用量與上限

  • 模型用量與其他聊天一樣,計入方案的一般上限。
  • 雲端工作區時間每個計費週期上限為 30 小時。Settings › Usage › Cloud agents 會顯示已用時間。達到上限後,直到下一個週期開始前,都無法啟動新的雲端執行。
  • 在你自己電腦上執行的訊息不會計入工作區時間。

安全

每個工作階段都在獨立隔離的沙箱中執行,與其他使用者的沙箱分開。只有連線的短期存取 token 會進入工作區;長期 token 會留在 Perch 伺服器上。

疑難排解

我在選單中看不到 Cloud。 雲端代理包含在 Pro 中。請確認已登入 Pro 帳號。

我的儲存庫不在清單中。 Perch 會列出你的 GitHub 帳號有推送權限的儲存庫。組織的儲存庫可能需要組織先允許 Perch 的 GitHub 存取。選擇 Reconnect GitHub 重新登入。

Perch 不啟動雲端執行,並說工作區時間已用完。 你已用完此週期的 30 小時。在自己電腦上執行的訊息仍可使用,內含用量會隨計費週期重設。