所有頁面
本頁內容

Agent session 0.9.7 新增

啟用 agent session 後,agent 可以把部分任務交給同一個中繼上的其他 session。它會啟動這些 session、給每個 session 一則提示、等待它們,並讀取它們的回答。它啟動的每個 session 都是你清單中的一般對話:你可以開啟它、跟著閱讀、回答它的提問,也可以停止它。

典型用途:

  • 拆分工作。「每個套件各啟動一個 session,更新它的相依套件並執行測試,然後告訴我哪些失敗了。」
  • 取得第二意見。「開始之前,先讓一個使用其他模型的 session 審閱這份計畫。」
  • 使用其他供應商。「讓一個 Cursor session 撰寫 migration,再由你自己檢查它的結果。」
  • 在其他資料夾工作。「在 docs 儲存庫中啟動一個 session,讓它更新安裝頁面以配合變更。」

這不需要第二個中繼。若要使用另一個中繼上的 session,兩個中繼必須先配對;請見指定中繼。

啟用 #

預設為關閉。

  1. 開啟 Settings → Relays(設定 → 中繼)。
  2. 在 Agent sessions(Agent session)下,開啟 Agents may start and use sessions on this relay(agent 可在此中繼上啟動並使用 session)。

此功能需要中繼上至少有一個已啟用的供應商。從那時起,此中繼上的 agent 就能列出並讀取這裡的每個 session、對其中一個下提示、啟動 session、等待它、回答它的提問、停止它的回合以及封存它。關閉開關後,中繼就再次對它們關閉。

已經開啟的對話

一個 session 會在它的 agent 處理程序啟動時,得知自己有哪些工具。在你開啟開關之前就已在執行的對話,可能要等它的 agent 重新啟動後才能啟動 session:對話 ⋯ 選單中的 Kill session(強制結束 session)可以做到這點,中繼重新啟動也可以。

核准卡片 #

對話中的 agent 第一次想啟動 session 時,必須先徵求你的同意。該對話中會出現一張核准卡片,列出供應商、資料夾或儲存庫,以及提示:

This agent wants to start sessions on this relay (claude, the default folder).
Sessions it starts use this relay's accounts.
你的選擇 會發生什麼
Allow(允許) session 會啟動。此對話的 agent 之後可以再啟動更多 session,不必再次詢問,中繼重新啟動後也一樣。
Deny(拒絕) 只拒絕這一次呼叫。

0.9.16 新增 當 agent 為新 session 指定了一個 session 群組時,卡片的詳細資訊列會顯示它要放到哪裡,例如 Group: Release 2.4 (grp_…)。群組會在卡片出現之前先查詢;不存在的群組會直接被拒絕,不會顯示卡片。

核准屬於對話,而不屬於中繼:其他對話中的 agent 必須自己另外徵求核准。

在 ask 和 plan 中繼模式下,你會更常被詢問。在這些模式中,每個會改變某些東西的動作都會先詢問:啟動 session、對 session 下提示、回答它的提問、0.9.16 新增 變更它的設定、停止以及封存它。

規則 #

規則
最多 4 個同時工作 在一個對話的 agent 所啟動的 session 中,最多 4 個可以同時有排入佇列或正在執行的回合。第五個會被拒絕,直到其中一個完成為止。
只有一層 由 agent 啟動的 session 本身不能再啟動 session,0.9.16 新增 除非你為該 session 允許這麼做(見下文)。
不能作用於自己 agent 不能對它所在的對話下提示、停止、封存、等待或回答,0.9.16 新增 也不能變更它的設定。
0.9.16 新增 變更設定 agent 可以自由變更由它自己的對話所啟動之 session 的設定。其他任何 session,不論是你的還是其他 agent 的,每個對話都需要你按一次 Allow。請見 update_session。
30 則提示後會詢問你 當 agent 已向其他 agent 傳送 30 則提示,而中間你沒有傳送任何訊息時,下一則提示會用卡片詢問你。Allow 會重新開始計數。0.9.16 新增 只有你自己寫的訊息才算是你的:中繼事件、用量上限後的接續訊息,以及重新啟動後的註記都不會重設計數。傳到其他 session 的排程提示也會計入。
你的帳戶 agent 啟動的 session 會使用此中繼的供應商帳戶執行,並計入這些帳戶的用量。
不會自動幫你清理 中繼從不會自行封存這些 session。它們會留在你的清單中,直到你封存或刪除它們,或由 agent 封存其中一個。

讓已啟動的 session 啟動 session 0.9.16 新增 #

由 agent 啟動的 session 不能自行啟動 session。若要為某個這樣的 session 解除這項限制,請開啟它的 🧠 對話框,並開啟 Agents in this conversation may start sessions (even though an agent started it)(允許此對話中的 agent 啟動 session,即使它由 agent 啟動)。這個開關只會在由 agent 啟動的 session 中顯示。

其他規則仍然適用:最多 4 個同時工作、第一個 session 需要你的 Allow,以及 Agents may start and use sessions on this relay。只有你能設定這個開關:agent 不論來自此中繼還是配對的中繼,都會被拒絕。agent 在 list_sessions 和 read_session 中會看到它是 "mayCreateSessions": true。

Agent 可以啟動什麼 #

可以是中繼上任何已啟用供應商的 session:GitHub Copilot、OpenAI、Claude、Claude API、Cursor、Grok、DeepSeek 或 Claude Cloud。OpenAI Image 對話無法用這種方式啟動。

  • 在資料夾中。 agent 可以指定工作資料夾。如果沒有指定,session 會使用中繼的預設資料夾。
  • 在儲存庫中(Claude Cloud)。 雲端 session 使用 GitHub 儲存庫(可選擇指定分支),而不是資料夾。它會在 Anthropic 的沙箱中,於全新複製的儲存庫上工作,因此 agent 必須告訴它要在哪個分支上工作,並要它推送變更。

agent 也可以選擇模型、中繼模式和 reasoning effort。它沒有指定的部分,會沿用它所在的 session。

新的 session 對啟動它的對話一無所知。它只會收到 agent 為它撰寫的提示。如果某個已啟動的 session 似乎缺少上下文,就該從這裡著手:開啟它並閱讀第一則訊息。

你會看到什麼 #

  • 在對話清單中,由 agent 啟動的 session 會帶有 via agent · "title"(經由 agent · 「title」),其中是 agent 所在對話的標題。同一行也會出現在標題列中 session 標題的下方;點選它會開啟那個對話。
  • 0.9.11 新增 在群組中。 該 session 會縮排顯示在啟動它的對話下方,位於一個 session 群組中,群組的標題列會彙總哪些正在執行、哪些在等你。0.9.16 新增 如果 agent 指定了既有的群組,session 就會改放在那個群組中。
  • 在訊息上,agent 傳送的提示會帶有一個徽章,上面有相同的標記和 agent 的模型,讓你能和自己的訊息區分。
  • 在 agent 的回覆中,每次呼叫都會顯示為一行帶 🛰️ 的活動列:動作以及它送往的 session。
  • 提問。 如果已啟動的 session 提出問題,它的卡片會照常在該 session 中等待。啟動它的 agent 會被告知這個提問;它被指示要把問題轉給你,而不是自己回答,除非你告訴過它可以自行決定。

Agent 會等多久 #

agent 對 session 下提示後,會等待回覆一段時間,時間到了就取得當下已有的內容;之後它可以再次等待。開關下方的滑桿 Longest wait per tool call(每次工具呼叫的最長等待)設定單次等待的最長時間:預設 10 分鐘,範圍為 2 到 60 分鐘。

當此中繼的 agent 等待配對中繼上的 session 時,這個上限同樣適用,因此無論開關是否開啟,都可以調整滑桿。

等待中的回合仍會計入 Settings → General(設定 → 一般)下的 Max turn duration(回合最長時間)。對於耗時超過一個回合應有長度的工作,agent 可以改為監看這些 session,並在它們完成時被喚醒。

依供應商 #

供應商 可以啟動並使用其他 session 可以由 agent 啟動
Claude 是 是
GitHub Copilot 和 OpenAI,兩種引擎皆可 是 是
Cursor 是 是
Grok 是 是
DeepSeek 0.9.17 新增 是 是
Claude Cloud 否:中繼的工具無法進入雲端沙箱 是,使用儲存庫而不是資料夾
OpenAI Image 否 否

除此之外,agent session 在所有供應商上的運作方式都相同。

無法正常運作時 #

發生什麼情況 原因與處理方式
agent 說它沒有可用的工具 開關是關閉的,或對話的 agent 在你開啟開關之前就已啟動。請見啟用。
agent 回報 REMOTE_RELAY_SESSION_LIMIT 它有四個 session 仍在工作。它必須等其中一個完成。
agent 回報 REMOTE_RELAY_NESTED_SESSION 這個 agent 本身就在一個由 agent 啟動的 session 中執行。只有你自己的對話中的 agent 才能啟動 session。
agent 回報 REMOTE_RELAY_PROVIDER_UNAVAILABLE 它要求的供應商在此中繼上未啟用。0.9.18 新增 若是計費切換,也可能是:Claude API 或 Claude 尚未設定,或已達本月的上限;remoteCode 會指出是哪一個。
agent 的回合在等待時結束 等待時間超過了 Max turn duration。請它使用較短的等待時間,或改為監看這些 session。

所有錯誤碼都列在錯誤中。