子智能體

ChatGPT Work 向符合條件的帳戶開放子智能體工作流程及其活動資訊。

當前 Codex 版本預設啟用子智能體工作流程。子智能體活動 會顯示在 ChatGPT 桌面應用、Codex CLI 和 IDE 擴充套件中。

在 ChatGPT Work 中，請要求 ChatGPT 將獨立的工作委派給子智能體。 這些智能體在 ChatGPT 的託管環境中執行，聊天中會顯示它們的 活動和結果。在大多數智慧級別下，你需要明確要求 委派工作。使用 Ultra 時，如果並行智能體能顯著提升速度或質量， ChatGPT 可以主動委派工作。

在應用聊天中，請 Codex 將相互獨立的工作部分委派給 子智能體。當前本機 Codex 版本會在你直接提出要求，或適用的 AGENTS.md 或技能指令要求委派時執行委派。應用會顯示每個 子智能體執行緒，方便你檢查其工作以及傳回給主聊天的摘要。

在互動式 CLI 會話中要求 Codex 使用子智能體。Codex 也可以遵循 適用的 AGENTS.md 或技能中要求委派任務的指令。使用 /subagents 可在智能體執行緒執行期間檢視並切換執行緒。主 執行緒會將子智能體的結果彙總到最終回覆中。

在 IDE 聊天中，請 Codex 將相互獨立的工作部分委派給子智能體。 Codex 也可以遵循要求委派的適用 AGENTS.md 或技能指令。 後臺智能體 UI 可用時，活躍的子智能體會顯示在 輸入框上方。展開面板即可檢視其狀態、停止所有活躍的 子智能體，或開啟單個子智能體執行緒。

在大多數智慧級別下，請直接要求使用子智能體或讓智能體並行 工作。Ultra 支援主動委派，因此 ChatGPT 可以將適合的 獨立工作委派出去，無需你另行提出請求。

直接要求使用子智能體或並行智能體工作。當適用的專案或技能指令 要求委派時，Codex 也可以執行委派。

在 ChatGPT Work 中，從輸入框選擇模型和智慧級別。 根據所選模型，可用的智慧級別可能包括 較低（Light）、中等（Medium）、高（High）、 超高（Extra High） 和 最高（Max）。極高（Ultra） 僅向符合條件的帳戶和受支援的模型開放。它使用最高推理級別，並允許 ChatGPT 主動將合適的工作委派給子智能體。

在其他智慧級別下，如果希望並行委派工作，請明確要求使用子智能體。

如果你沒有設定子智能體模型或 model_reasoning_effort， 子智能體會繼承父智能體的模型和推理強度。如果顯式 建立請求或 [agents] 預設設定選擇了模型，但沒有 顯式指定或設定推理強度，子智能體會使用該模型的預設 推理強度。要為每項任務平衡智慧水平、速度和價格， 可以在提示詞中請求使用特定模型或推理強度， 在 config.toml 中設定 [agents] 預設設定，或直接在自定義智能體檔案中設定 model 和 model_reasoning_effort。 例如，使用 gpt-6-luna 進行快速掃描，或使用推理強度更高的 gpt-6.1-sol 設定來處理要求更高的推理任務。

模型選擇

• gpt-6.1-sol：對於需要處理高難度任務的智能體，請優先使用此模型。它適合需求不明確、包含多個步驟的工作，這類工作需要在較大的上下文中進行規劃、使用工具、驗證並持續跟進。
• gpt-6-luna：適合需要快速處理明確、重複性或大批次工作的智能體，任務範圍應較窄。

推理強度（model_reasoning_effort）

對於 GPT-6.1 Sol，請使用你的客戶端和所選模型支援的 推理強度。顯式設定模型時，GPT-6 Luna 可先使用 high，GPT-6 Astra 可先使用 low。 再根據任務調整為所選模型支援的級別。

• ultra：在所選模型支援時，用於最深入的 推理。
• max 和 xhigh：在所選模型支援這些級別時，用於要求特別高的 推理任務。
• high：用於智能體需要梳理複雜邏輯、檢查假設或處理邊界情況的任務（例如審查智能體或專注於安全的智能體）。
• medium：平衡速度與深度。
• low：用於任務簡單且速度最重要的情況。

更高的推理強度會增加響應時間和 token 用量，但可以提高複雜工作的質量。有關詳細資訊，請參閱模型、設定基礎和設定參考。

在大多數智慧級別下，ChatGPT 會在收到直接請求後生成智能體。使用 Ultra 時，如果並行工作有用，ChatGPT 也可以主動委派。

當前本機 Codex 版本會在收到直接請求或適用的 專案或技能指令後生成智能體。

開啟 子智能體（Subagents） 可檢視唯讀的 進行中（Active） 和 已完成（Done） 列表。選擇一個 已完成的子智能體即可檢查其詳細資訊和結果。網頁側邊欄會報告 子智能體活動，但不提供停止或引導單個 子智能體的控制項。

• 從主執行緒中顯示的活動開啟子智能體執行緒，以檢查 其工作。
• 直接要求 Codex 引導正在執行的子智能體、停止它，或關閉已完成的 子智能體執行緒。

報告檢查清單簡報檢查清單已開始工作

活躍沒有活躍的子智能體

已完成 · 3

模型 API 審查審查已完成；未發現端點相容性問題。

2 分鐘

軟體包審查最穩妥的工作流程是有針對性地更新依賴項。

3 分鐘

著陸頁審查審查已完成；最終佈局已無阻礙問題。

4 分鐘

• 在 CLI 中使用 /subagents 切換活躍的智能體執行緒，並檢視正在執行的執行緒。
• 直接要求 Codex 引導正在執行的子智能體、停止它，或關閉已完成的智能體執行緒。

• 後臺智能體面板可用時，將其展開以檢視狀態、 停止活躍的子智能體，或開啟子智能體執行緒。
• 直接要求 Codex 指導正在執行的子智能體、停止子智能體，或關閉已完成的 子智能體執行緒。

子智能體會繼承你當前的沙箱策略。

ChatGPT Work 在其託管環境中執行子智能體，不提供 本機 Codex 沙箱或審批模式控制。子智能體使用父級聊天可用的 工具。網站和連接器的權限仍由 各工具分別管理。

子智能體會繼承輸入框下方選擇的權限模式。在要求 Codex 委派工作之前， 請先為父輪次選擇權限模式。

在互動式 CLI 會話中，即使你正在檢視主執行緒，審批請求也可能 從非活躍的智能體執行緒中彈出。審批浮層 會顯示來源執行緒的標籤，你可以按 o 開啟該執行緒，然後再 核准、拒絕或回應請求。

在非互動式流程中，或在執行無法顯示新的審批請求時， 需要新審批的操作會失敗，Codex 會將錯誤傳回給 父工作流程。

子智能體繼承父輪次當前的沙箱和審批設定， 包括通過 /permissions 或 --yolo 所做的更改。自定義智能體檔案 無法替換這些設定。

子智能體會繼承在輸入框下方選擇的權限模式。在要求 Codex 委派工作之前， 請先為父智能體的當前輪次選擇權限模式。

在父會話中設定沙箱和審批控制。自定義智能體的 指令可以要求智能體避免編輯，但不會建立獨立的 唯讀沙箱。

自定義智能體

Codex 隨附以下內建智能體：

• default：通用後備智能體。
• worker：面向實施和修復、專注執行的智能體。
• explorer：以讀取為主的程式碼庫探索智能體。

要定義自己的自定義智能體，請將獨立 TOML 檔案新增到 ~/.codex/agents/（個人智能體）或 .codex/agents/（專案範圍的 智能體）下。

每個檔案定義一個自定義智能體。自定義智能體可以更改模型設定和 指令，或停用受支援的功能。它們會繼承父會話的 權限、供應商和 MCP 伺服器；自定義智能體檔案無法覆蓋這些 設定。

每個獨立的自定義智能體檔案都必須定義：

• name
• description
• developer_instructions

如果自定義智能體檔案設定了 model 或 model_reasoning_effort，則以 檔案中的值為準。在應用檔案之前，Codex 會依次從顯式指定的建立參數、 對應的 [agents] 預設值，以及 父會話的值中確定各項設定。如果顯式建立請求或 [agents] 預設值 選擇了模型，但兩者都未指定推理強度，Codex 會使用 該模型的預設推理強度。僅設定 model 的自定義智能體檔案 會保留此前確定的推理強度。如果所選模型不支援該推理強度， 或你希望使用其他推理強度，請在檔案中同時設定 model_reasoning_effort， 以指定所需的值。技能繼承自父會話，自定義智能體可以通過 skills.config 停用單個技能。

全域設定

全域子智能體設定仍位於設定中的 [agents] 下。

注意：

• agents.enabled 預設為 true。將其設為 false 可停用多智能體工具。
• 如果未設定 agents.max_concurrent_threads_per_session，Codex 會選擇預設值。現有設定可以繼續使用 agents.max_threads 作為舊版別名。
• 顯式生成值會覆蓋 agents.default_subagent_model 和 agents.default_subagent_reasoning_effort。
• agents.interrupt_message 預設為 true。將其設為 false 可從智能體上下文中省略模型可見的中斷訊息。
• 如果自定義智能體名稱與 explorer 等內建智能體相同，則以自定義智能體為準。

自定義智能體檔案格式

使用 model、model_reasoning_effort、model_reasoning_summary 和 model_verbosity 自定義模型行為。 有關這些設定的可用值，請參閱設定參考 中的說明。

要限制自定義智能體的功能，請將受支援的功能鍵設為 false： features.shell_tool、features.apps、features.plugins、 features.memories 或 features.request_permissions_tool。要停用單個 技能，請使用 skills.config；要停用內建技能，請使用 skills.bundled.enabled = false。設定 skills.include_instructions = false 可 省略自動新增的技能指令塊。受管理的要求仍然適用。

其他會話設定，包括 sandbox_mode、approval_policy、 model_provider 和 mcp_servers，即使寫入自定義智能體檔案， 也不會覆蓋父會話的設定。服務層級同樣遵循根 會話的偏好設定。請在父會話中設定 MCP 伺服器，以便智能體 使用它們。

Codex 通過自定義智能體的 name 欄位識別它。讓檔名與 智能體名稱保持一致是最簡單的約定，但 name 欄位才是最終 依據。

自定義智能體範例

最優秀的自定義智能體應當範圍明確且有鮮明傾向。為每個智能體分配清晰的職責， 提供與該職責匹配的工具範圍，並通過指令避免其 偏離到相鄰工作。

如果你的已登入帳戶或工作區擁有存取權限，這些範例會使用 GPT-6.1 Sol。 如果該模型不可用，請選擇你可以 使用的模型。

範例 1：PR 審查

此模式將審查工作拆分給三個各有側重的自定義智能體：

• pr_explorer 梳理程式碼庫並收集證據。
• reviewer 尋找正確性、安全性和測試風險。
• docs_researcher 通過專用 MCP server檢查框架或 API 文件。

專案設定（.codex/config.toml）：

[agents]
max_concurrent_threads_per_session = 8

[mcp_servers.openaiDeveloperDocs]
url = "https://developers.openai.com/mcp"

.codex/agents/pr-explorer.toml：

name = "pr_explorer"
description = "Read-only codebase explorer for gathering evidence before changes are proposed."
model = "gpt-6-luna"
model_reasoning_effort = "high"
developer_instructions = """
Stay in exploration mode.
Do not edit files.
Trace the real execution path, cite files and symbols, and avoid proposing fixes unless the parent agent asks for them.
Prefer fast search and targeted file reads over broad scans.
"""

.codex/agents/reviewer.toml：

name = "reviewer"
description = "PR reviewer focused on correctness, security, and missing tests."
model = "gpt-6.1-sol"
model_reasoning_effort = "medium"
developer_instructions = """
Review code like an owner.
Do not edit files.
Prioritize correctness, security, behavior regressions, and missing test coverage.
Lead with concrete findings, include reproduction steps when possible, and avoid style-only comments unless they hide a real bug.
"""

.codex/agents/docs-researcher.toml：

name = "docs_researcher"
description = "Documentation specialist that uses the docs MCP server to verify APIs and framework behavior."
model = "gpt-6-luna"
model_reasoning_effort = "high"
developer_instructions = """
Use the docs MCP server to confirm APIs, options, and version-specific behavior.
Return concise answers with links or exact references when available.
Do not make code changes.
"""

此設定非常適合以下提示詞：

Review this branch against main. Have pr_explorer map the affected code paths, reviewer find real risks, and docs_researcher verify the framework APIs that the patch relies on.

範例 2：前端整合除錯

此模式適用於 UI 迴歸、間歇性瀏覽器流程，或橫跨應用程式碼和執行中產品的整合錯誤。

專案設定（.codex/config.toml）：

[agents]
max_concurrent_threads_per_session = 6

[mcp_servers.chrome_devtools]
url = "http://localhost:3000/mcp"
startup_timeout_sec = 20

.codex/agents/code-mapper.toml：

name = "code_mapper"
description = "Read-only codebase explorer for locating the relevant frontend and backend code paths."
model = "gpt-6-luna"
model_reasoning_effort = "high"
developer_instructions = """
Map the code that owns the failing UI flow.
Do not edit files.
Identify entry points, state transitions, and likely files before the worker starts editing.
"""

.codex/agents/browser-debugger.toml：

name = "browser_debugger"
description = "UI debugger that uses browser tooling to reproduce issues and capture evidence."
model = "gpt-6.1-sol"
model_reasoning_effort = "medium"
developer_instructions = """
Reproduce the issue in the browser, capture exact steps, and report what the UI actually does.
Use browser tooling for screenshots, console output, and network evidence.
Do not edit application code.
"""

.codex/agents/ui-fixer.toml：

name = "ui_fixer"
description = "Implementation-focused agent for small, targeted fixes after the issue is understood."
model = "gpt-6-luna"
model_reasoning_effort = "high"
developer_instructions = """
Own the fix once the issue is reproduced.
Make the smallest defensible change, keep unrelated files untouched, and validate only the behavior you changed.
"""

[[skills.config]]
path = "/Users/me/.agents/skills/docs-editor/SKILL.md"
enabled = false

此設定非常適合以下提示詞：

Investigate why the settings modal fails to save. Have browser_debugger reproduce it, code_mapper trace the responsible code path, and ui_fixer implement the smallest fix once the failure mode is clear.