建立並設定代理
本指南說明如何把代理加入工作區，並把它設定到真正可以執行的程度。
每個工作區在建立時都會預置五個代理——一名 CEO，再加上 qa、architect、engineer 和 librarian——因此你通常在尚未設定任何代理之前就已經擁有它們。以下步驟對預置代理和新建代理同樣適用。
開始之前
標題為「開始之前」的章節- 你已身處某個工作區之內。整個介面位於 設定 → 工作區 → 代理（
/settings/workspace/agents）。 - 代理需要一個後端。你可以在 設定 → 伺服器 → 模型供應商 下為內建執行框架連接一個供應商，也可以在託管
cc_server的機器上安裝 Claude Code CLI。 - 如你想讓代理帶有技能，請先在 設定 → 工作區 → 技能 下安裝它們。代理表單只讓你切換工作區中已存在的技能。
加入代理
標題為「加入代理」的章節- 開啟 設定 → 工作區 → 代理。
- 點擊 新增代理。
這裏不會出現對話方塊，也沒有角色選擇器。系統會立即建立一個名為「未命名代理」的代理，並在右側的詳情面板中選取它。
你現在應該可以在左側的名冊中看到「未命名代理」，其詳情面板的 設定 分頁已開啟，而 名稱 欄位中包含「未命名代理」。
為它命名
標題為「為它命名」的章節- 名稱——用於 @提及的簡短識別碼，例如
alice。提及解析會比對@及其後緊接的字詞字元，因此含有連字符、點號或空格的名稱永遠無法被提及。 - 標題——供人閱讀的標籤，例如「資深程式員」。
- 系統提示——可選的額外指示，會以「Agent instructions」區段的形式注入；它們不會取代組裝後提示的其餘部分。
點擊表單底部的 儲存變更。本頁上的每個欄位都由這一個按鈕儲存。
為它設定配接器和模型
標題為「為它設定配接器和模型」的章節配接器 下拉式選單會列出伺服器主機實際擁有的執行器。內建配接器一定會被找到（它就是伺服器本身）。只有在該主機上偵測到 Claude Code CLI 時，Claude Code 才會出現：
| 配接器 | 後端 |
|---|---|
| Control Center（內建） | 行程內的代理迴圈——無需外部 CLI |
| Claude Code | claude -p --output-format stream-json |
只有內建配接器會強制執行模式、執行中引導、暫停與恢復、完成契約和子代理。Claude Code 這些一樣都沒有。Cursor、Codex 以及其他模型供應商都掛接在內建配接器上，而不是作為獨立的執行器。
模型 下拉式選單由你所選的配接器決定。對於內建配接器，清單即時來自你在 設定 → 伺服器 → 模型供應商 下已連接的供應商，因此沒有儲存憑證的供應商會貢獻零個模型。
新增技能
標題為「新增技能」的章節技能 是一個晶片選擇器，涵蓋此工作區中已安裝的技能包。點按晶片即可切換；勾號標記表示已選取的項目。如果工作區沒有任何技能，該欄位會顯示「No skills available. Create skills in Settings → Skills first.」
你在這裏無法挑選程式庫自帶的技能。隨附技能的程式庫（技能位於 .agents/skills/、.claude/skills/ 或 .opencode/skills/）會自動把它們貢獻給在該程式庫中工作的任何代理，而當它轉到另一個程式庫時，這些技能就會被替換——詳見 以程式庫為界的技能。
設定匯報關係與人設
標題為「設定匯報關係與人設」的章節- 直屬主管——按名稱挑選另一個代理。這會建立頁首 組織圖 按鈕所顯示的匯報樹。它並不是團隊負責人在委派時使用的名冊——那名冊來自團隊的成員及其技能。
- 人設——塑造語氣與行為的自由文字，例如：「偏好簡單、易讀的解決方案。為所有新程式碼撰寫測試。」
調整執行參數
標題為「調整執行參數」的章節- 推理力度——可選項來自所選模型本身公布的等級：Low / Medium / High，在 OpenAI 風格的模型上還有 Extra High，在 Claude 風格的模型上則有 Extra High + Max。當所選模型未宣告任何思考等級時，此欄位會完全隱藏，並採用模型自身的預設值。
- 上下文視窗大小——每次更換模型時，都會以該模型的上下文視窗預先填入，並為模型預設值、200k、500k 和 1M 提供一按即選的晶片。你在選定模型之後輸入的值會一直生效，直到下一次更換模型。
- 靜音逾時（分鐘）——在這麼長時間沒有輸出之後終止執行。留空則使用按模式設定的預設值。
授予權限
標題為「授予權限」的章節代理沒有自己的權限開關。它能推送、開啟、合併或存取甚麼，由 設定 → 工作區 → 代理權限 中的動作規則決定，你可以在那裡把規則限定到這個代理。預設情況下，推送、pull request、審查或合併以及寫入追蹤器都會先逐項詢問你，網絡存取則是允許的。
代理的 GitHub 權杖一律是唯讀的。推送會經由 Control Center，它在轉送前會詢問推送到遠端規則。每條規則如何作用於一次執行，請參見設定沙箱政策。
驗證它能執行
標題為「驗證它能執行」的章節- 開啟 設定 → 伺服器 → 模型供應商，確認你所選的配接器回報的是已安裝的版本，而不是「找不到」。點擊 重新整理 可重新探測——探測在託管
cc_server的機器上執行，而不是在你正在查看的這部機器上。 - 開啟一個包含該代理的空間並向它傳送訊息，或者在現有空間中 @提及它。
- 回到 設定 → 工作區 → 代理，選取該代理並開啟其 日誌 分頁。應該會出現一筆執行記錄，附有狀態徽章、時長、開始時間，以及它所使用的配接器。檢視 會開啟該次執行的事件串流。
如果完全沒有出現任何執行記錄，請按 診斷代理 逐步排查。
刪除代理
標題為「刪除代理」的章節在名冊中選取它。在 設定 分頁上，捲動到表單底部的 危險區域，然後點擊 刪除。