使用空間
本指南說明如何使用空間。空間是 Control Center 中的訊息介面:一個以工作區為範圍的房間,有一名或多名參與者(你及/或代理),並為每個建立時所對應的程式庫擁有一份寫入時複製 worktree。
一對一和多名代理的房間都只是空間,差別僅在於參與者的多寡。唯一的例外是代理彼此對話時所開啟的空間——見下文代理對代理的空間。
建立空間
標題為「建立空間」的章節- 前往空間
- 點擊「空間」標題旁的 + 按鈕
- 為它取一個名稱——必填。名稱留空會被拒絕;對話框會保持開啟
- 可選擇從工作區加入代理
- 當工作區有任何程式庫時,選擇這個空間要為哪些程式庫佈建 worktree。預設會全部選取;取消選取每一個程式庫會建立一個甚麼都沒有檢出的空間
- 確認
空間以工作區為範圍:你只會看到目前工作區的代理,而空間永遠不會呈現另一個工作區的資料。
每個程式庫都會檢出至該空間內的 repos/<name>/。隨附自身代理技能的程式庫,會把這些技能提供給在其中工作的代理——同一時間只會有一套程式庫的技能,代理轉到別處時便會替換。在輸入框中,你可以用 /skill:<repo>:<name> 觸達其中任何一項。參見以程式庫為界的技能。
這個介面位於 /workspaces/<id>/spaces,而單一空間位於 /workspaces/<id>/spaces/<spaceId>。
設定空間的模式
標題為「設定空間的模式」的章節新空間會以預設模式開始。請從輸入框工具列最左側的模式下拉選單更改——不是從建立對話框(它沒有模式欄位),也不是從空間標頭。
| 模式 | 效果 |
|---|---|
| 代理 | 完整存取權。預設值;內部為 chat,在下拉選單中標示為「代理」 |
| 計劃 | 只讀與研究;交付物是一份具型別的計劃 |
| 編排 | 只讀與研究,外加一個 propose_orchestration 動詞;計劃只在你核准後才執行 |
Shift+Tab 可在計劃與代理模式之間切換,而毋須開啟下拉選單。
第四種模式 審查 確實存在,但下拉選單並不提供——它會自動套用至 PR 審查空間。
模式儲存在空間上,因此同一個代理可以在一個空間處於計劃模式,而在另一個空間處於代理模式。空間內的每則對話都共用該空間的模式。
完整模型參見模式。
管理參與者與個別代理的自主程度
標題為「管理參與者與個別代理的自主程度」的章節點擊空間標頭中的人物圖示,開啟管理參與者。對於空間中已有的每個代理,你可以:
- 將它移出空間
- 為它設定在此空間的自主程度:預設、僅提出建議、經核准後行動或自由行動
自主程度旋鈕按每個(空間、代理)分別設定,因此你在某個房間信任的代理,可以在另一個房間被限制為僅提出建議。
對訊息表達反應
標題為「對訊息表達反應」的章節將游標移到訊息上,然後點擊微笑圖示,即可開啟表情反應面板。它是一組固定的六款:👍 👎 🎉 ❤️ 👀 ✅。沒有自由的表情符號選擇器——點按其中一款就會為你切換它,而彙總後的晶片會出現在訊息下方。
開啟對話
標題為「開啟對話」的章節一個空間可以同時承載多則對話,而它們是平級對等的——沒有主要的一則。空間永遠會保留至少一則進行中的對話:你不能封存最後一則作用中的對話,而開啟一個尚未有任何對話的空間,會建立一則未命名的常設對話。
對話會顯示為編輯器分頁,而當超過一則時,也會在側邊欄中顯示為空間底下的巢狀列。新對話位於編輯器的新增分頁選單中,會建立一則未命名的對話,且不會提示輸入標題——標題模型會依第一則訊息為它命名。用它來以同一個代理和 worktree 執行並行工作。
每則對話都保有自己的訊息記錄與代理工作階段,同時共用該空間的 worktree 及其模式。關閉分頁會將它隱藏;封存對話(側邊欄列或聊天分頁的右鍵選單)只會封存該則對話。
開始討論串
標題為「開始討論串」的章節將游標移到任何訊息上,然後選擇開始討論串。這會開啟一則錨定於該訊息的對話:錨點會以一行內容播下新對話代理上下文的種子,而上層對話的歷史不會被複製。
討論串一旦有回覆,它所依附的訊息下方就會長出一列——發言者的頭像、回覆數,以及最後一則回覆的時間。那一列就是回去的路:點擊它會開啟(或聚焦)該討論串的分頁。這是討論串在其分支出來的訊息流中留下的唯一痕跡,這也是它存在的原因。
討論串的分頁標題為 Thread: <name>,並帶有分支圖示,因此同一個空間上的兩個分頁永遠不會彼此混淆。
討論串永遠不會巢狀——錨定到已經位於某個討論串內的訊息會被拒絕。對話標頭會連結回錨點訊息。刪除錨點訊息會刪除該討論串,而封存上層對話不會阻擋它既有的討論串。
讀取狀態
標題為「讀取狀態」的章節已讀標記以空間為範圍,而不是以對話為範圍:開啟空間中任何一則對話都會清空整個房間。未讀仍會彙總空間的所有對話,包括討論串。當對話列在空間底下時,未讀圓點會落在有未見工作的那則對話上,而不是上層列上。
代理對代理的空間
標題為「代理對代理的空間」的章節代理為了彼此對話而開啟的空間,會在側邊欄中獨立歸於代理之下,預設收合並以淡化方式呈現。它們永遠不會增加你的未讀徽章——代理之間的閒聊在設計上就是安靜的,而不是靠一個你得自己去找的設定。
空間的種類是五個值之一:topic(你建立的任何空間的預設值)、agentPeer、system(由管線管理)、pr(當 PR 介面需要 worktree 錨點時建立,並在它有訊息之前從側邊欄隱藏),以及 slack(由聊天橋接為 Slack 討論串或機械人私訊建立,並視作一般的人類對話)。