跳到主要內容
maxstudioNews
AI 自動化DEV Community (Codex)約 11 分鐘

Codex CLI 任務委派:整合 osFoundry 代理與自動化會話

本文介紹 Codex CLI 如何將任務委派給 osFoundry 的代理、團隊或循環會話,透過發送目標、摘要和所需輸出,實現自動化協作。文章詳細說明了設定步驟、權限管理、批准流程以及結果回傳機制,讓 AI 代理能更有效地分工合作。

Codex CLI 任務委派:整合 osFoundry 代理與自動化會話
圖片來源:DEV Community (Codex)

一旦設定完成,Codex CLI 就可以將它不應該自行處理的任務委派給 osFoundry 的任何會話,包括代理會話(agent session)、團隊會話(team session)或循環會話(loop session)。它會發送一個目標(goal)、目前已知的摘要(summary),以及所需的輸出(output)。

會話擁有者會收到通知,並點擊「接受並執行」(Accept and run)或「拒絕」(Decline)。

執行完成後,Codex 會在同一個終端機會話中讀取結果並繼續工作。如果您授予它「執行者席位」(Runner seat),它甚至可以自行啟動一個有限的執行,無需任何點擊。

誰負責什麼?

Codex CLI osFoundry 登入:這是您自己的 Codex 登入憑證。osFoundry 的 OAuth 權杖會保留在 Codex 中。

連線(Connection):您需要一次性批准連線,以授予 Codex 存取特定工作區(workspace)和您所選範圍(scopes)的權限。透過七個 _session_ 工具,它能存取被邀請的會話。

席位(Seat):席位決定了權限等級。「檢視者」(Viewer)只能讀取,「貢獻者」(Contributor)可以發布筆記並提出委派(handoff),而「執行者」(Runner)則可以請求執行。

工作執行:Codex 會繼續在您的儲存庫(repository)中工作。會話則在其代理執行環境(agent runtime)上運行,並使用其專屬的代理、工具和模型設定。

誰負責批准?:預設情況下,Codex 會在每次使用寫入工具(write tool)前徵求您的同意(default_tools_approval_mode = "writes")。委派(handoff)則需要會話擁有者點擊「接受並執行」才能繼續。執行者席位(Runner seat)是對 request_session_run 的永久批准。

執行時間:每次呼叫的 max_rounds 限制在 1 到 10 之間。擁有者會看到「在您的代理執行環境上最多 N 輪」的提示。

返回內容:此連線啟動的任務狀態和結果,以及發送給它的筆記。會話代理的內部分析則保留在 osFoundry 內部。

設定

1. 建立連線

在 osFoundry 的標頭中點擊鑰匙圖示,然後打開「已連線」(Connected)分頁(即「已連線代理」(Connected agents))。在「三步驟連線」(Connect in three steps)中,將助理(Assistant)設定為「其他 MCP 用戶端」(Other MCP client),給予一個顯示名稱,例如「Codex CLI」,然後點擊「新增助理」(Add assistant)。擁有者會在每次委派時看到這個名稱,因此請使用一個易於識別的名稱。

2. 將伺服器與執行範圍(run scope)新增至 Codex

執行 codex mcp add osfoundry --url https://api.osfoundry.io/api/v1/external-mcp。然後打開 ~/.codex/config.toml 檔案,並將表格內容調整為此任務所需的最小配置:

[mcp_servers.osfoundry] url = "https://api.osfoundry.io/api/v1/external-mcp" scopes = ["osfoundry:read", "osfoundry:write", "osfoundry:run"] default_tools_approval_mode = "writes" enabled_tools = ["list_granted_resources", "list_project_resources", "read_session_state", "read_session_task_result", "read_session_mail", "post_session_note", "propose_session_handoff", "cancel_session_handoff", "request_session_run"]

request_session_run 背後的範圍是 osfoundry:run。如果 Codex 只需要提出委派,則可以移除此範圍。委派(Handoff)和筆記(note)工具需要 osfoundry:write,而三個讀取工具則需要 osfoundry:read。

當 default_tools_approval_mode 設定為 writes 時,Codex 會在使用非唯讀(read-only)的四個工具前徵求同意,並在不詢問的情況下執行讀取工具。

3. 登入

執行 codex mcp login osfoundry。瀏覽器會打開 osFoundry 的「連線代理」(Connect an agent)頁面。在「請求功能」(Requested capabilities)中,您會看到三行與上述範圍相關的內容。第三行是「執行您授予執行者角色(runner role)的會話」。

選擇工作區(Workspace),選取「使用待處理:Codex CLI」(Use pending: Codex CLI),勾選批准框,然後點擊「連線」(Connect)。

4. 將連線新增至包含會話的專案

回到「已連線」分頁,連線旁邊會顯示「已連線」(Connected.)。在「專案」(Projects)中選擇您的專案,然後點擊「新增至專案」(Add to project)。這將使連線能夠看到該專案中符合條件的會話。目前,它還不能在其中任何一個會話中進行寫入。

5. 在會話中授予席位

在頁面下方找到「代理、團隊和循環會話」(Agent, Team, and Loop sessions)區塊。說明文字清楚指出:「邀請它作為貢獻者(Contributor)加入會話以發布筆記和提出委派,或作為執行者(Runner)以請求執行。委派仍需要會話擁有者的批准。」

會話列表只會顯示已將此連線新增到的專案中的會話。選擇類型(Type)、會話(session)和角色(role),然後點擊「儲存角色」(Save role)。建議從「貢獻者」開始,之後再為同一個會話儲存為「執行者」即可更改角色。

實際執行(模擬)

由於撰寫本文的機器並未安裝 Codex,以下會話是一個模擬範例。工具名稱和參數名稱與即時伺服器 tools/list 返回的內容相同,並帶有 Codex MCP 工具所使用的 mcp__osfoundry__ 前綴。儲存庫、會話和所有值均為示範內容。

> CSV 匯出修正已合併。將客戶通知和知識庫更新交給 osFoundry 發布部門團隊,然後告訴我他們寫了什麼。

• mcp__osfoundry__list_granted_resources {} ← 1 project: "Billing v2"

• mcp__osfoundry__list_project_resources {"project_id": "…", "resource_type": "team_session", "search": "release"} ← team_session "Release desk"

`• mcp__osfoundry__propose_session_handoff { "session_type": "team_session", "session_id": "…", "goal": "為 CSV 匯出修正撰寫客戶通知並更新關於匯出的知識庫文章。

", "context_summary": "超過 1 萬行的匯出被截斷在 1 萬行。已在 PR #212 中修正(串流行,無上限)。影響有排程匯出的方案。沒有資料遺失;現在重新執行匯出會返回所有行。", "requested_output": "草稿通知(<120 字)和知識庫文章差異,供審閱。

", "max_rounds": 4, "idempotency_key": "codex-csv-212-note"}`

[Codex 詢問:允許此工具呼叫?→ 是]

← 委派待擁有者審閱(在 osFoundry 中,擁有者打開「Codex CLI 請求委派」→ 審閱委派 → 委派 → 外部助理請求 → 接受並執行)

• mcp__osfoundry__read_session_state {"session_type": "team_session", "session_id": "…"} ← 正在運行,最近的任務「由外部助理請求」

• mcp__osfoundry__read_session_task_result {"session_type": "team_session", "session_id": "…", "task_id": "…"} ← 完成:草稿通知 + 知識庫差異

• mcp__osfoundry__post_session_note {"session_type": "team_session", "session_id": "…", "subject": "謝謝,一個修正", "body": "修正已在 3.18.2 版發布,而非 3.18.1 版。", "idempotency_key": "codex-csv-212-fix"}

[Codex 詢問:允許此工具呼叫?→ 是]

發布部門起草了一份 96 字的通知和一份知識庫差異,取代了「匯出上限為 10,000 行」的段落。我已將版本修正發布回會話。

擁有者的操作:擁有者的工作量很小。通知會顯示「Codex CLI 請求委派」,並附有「在發布部門審閱請求」和一個「審閱委派」按鈕。擁有者會打開會話的「委派」(Handoffs)分頁。在「外部助理請求」(Outside assistant requests)中,目標會完整顯示,可以打開「上下文和預期輸出」(Context and expected output)查看,而「在您的代理執行環境上最多 4 輪」這行則說明了執行的最大輪數。

「接受並執行」(Accept and run)會將其放入佇列(「委派已接受並排入執行佇列」)。「拒絕」(Decline)則會立即終止。

如果 Codex 發送了錯誤的內容,只要擁有者尚未接受,就可以使用 handoff_id 搭配 cancel_session_handoff 來撤銷它。

限制

提案(Proposal)和執行(run)是刻意設計成兩種不同的工具。propose_session_handoff 會向人類徵求同意,這需要 osfoundry:write 權限、貢獻者席位(Contributor seat),以及人類可讀的 context_summary 和 requested_output,並且在擁有者點擊前不會啟動任何操作。

request_session_run 則跳過點擊步驟。這需要 osfoundry:run 權限和執行者席位(Runner seat),這些都是擁有者在授予席位時就已預先批准的。兩者都將 max_rounds 限制為 10。提案的目標限制為 5,000 個字元,執行則為 10,000 個字元。

Codex 只能看到結果,看不到推理過程。read_session_task_result 只會返回此連線啟動的任務。read_session_mail 會返回發送給此連線的筆記以及它自己發布的筆記,並且工具說明中寫明「不包含內部代理分析」。post_session_note 會新增一個帶有名稱的筆記,會話中的代理可以回應,但這「不會觸發自動執行」。

會話始終在其常規位置運行。委派不會將 Codex 的模型、金鑰或儲存庫帶入 osFoundry。它只傳輸文字,然後會話會使用其自身的代理和工具來完成工作。任何僅限於桌面本地的內容,例如本地資料夾或未同步的項目,都無法存取。伺服器的初始化回覆也說明:「本地資料無法供雲端客戶端使用。」

移除存取權

移除存取權只需一個點擊。在「已連線」分頁中移除席位或撤銷連線,Codex 的下一次會話呼叫將會被拒絕。

第一次嘗試時,一個您目前手動運行的循環(loop)會是個不錯的選擇。將 Codex CLI 以「貢獻者」身份邀請到其中,完成儲存庫中的任何更改,然後讓 Codex 提出下一個循環執行,並附上更改的摘要。委派(Handoffs)會顯示 osFoundry 的代理如何在步驟之間推進上下文,而代理會話(agent sessions)則會顯示「委派」分頁的位置。

Share

覺得值得一看?分享給朋友。

以上為 AI 自動翻譯導讀。原文版權歸 DEV Community (Codex) 所有, 建議透過「閱讀原文」前往原始網站,以取得最完整資訊並支持原作者。

Newsletter

不用每天追,AI 重點每週寄給你

43 個來源、每 2 小時更新,太多看不完。電子報每週挑最值得看的幾則,附上 Max 的看法。

每週一封。Email 只用來寄電子報,每封信都能一鍵退訂。