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

Codex CLI 在 osFoundry 團隊協作中的自動化應用:Runner 角色設定指南

本文詳細說明 Codex CLI 如何在 osFoundry 的團隊或循環會話中扮演 Runner 角色,負責排隊執行任務並擷取結果。內容涵蓋設定流程,包括 OAuth 權杖、角色指派與工具權限,並透過模擬範例展示 Codex CLI 如何自動化查詢支援工單和發布更新等任務。

Codex CLI 在 osFoundry 團隊協作中的自動化應用:Runner 角色設定指南
圖片來源:DEV Community (Codex)

最終,Codex CLI 在 osFoundry 的團隊或循環會話中扮演著 Runner 的角色。它從終端機透過 request_session_run 將一個有界目標排入佇列,會話中的代理人會在會話的執行環境中處理這些任務,而 Codex 則透過 read_session_task_result 擷取結果。

接著,它會透過 post_session_note 在會話的團隊信箱中留下備註,並透過 read_session_mail 讀取代理人的回覆。每次執行時,無需人工點擊任何按鈕:由所有者一次性授予的 Runner 角色即代表核准。

Codex CLI 在 osFoundry 上的運作方式

連線

您的 Codex 連線。Codex 持有 osFoundry 的 OAuth 權杖,並具備 osfoundry:run 權限範圍。所有者只需核准此連線一次,並逐個會話選擇其角色。

可啟動的內容

每次呼叫可啟動一個目標,最多 10,000 個字元,max_rounds 為 1 到 10。它會將其排入佇列,作為由「外部助理請求」觸發的任務,並使用會話的代理人、工具和模型來執行。

工作執行地點

不在您的機器上執行。Codex 僅負責等待和讀取。工作會在會話的執行環境中執行。在桌面執行環境中,下一次輪詢會擷取任務,每次一個會話執行一個任務。

回傳內容

此連線啟動的任務狀態和結果、發送給它的備註,以及它發布的備註。代理人的內部分析會保留在會話中。

誰可以停止它

Codex 會在每次寫入工具(default_tools_approval_mode = "writes")之前徵求您的同意。所有者可以在「已連接」分頁中移除角色或撤銷連線。

設定步驟

1. 授予 Codex 執行權限範圍

連線以常規方式建立:標頭中的鑰匙圖示、「已連接」分頁、其他 MCP 客戶端,以及一個顯示名稱,例如 Codex CLI。這個名稱將顯示在每次執行和備註中,供會話代理人和所有者查看,因此請選擇一個易於辨識的名稱。

在 Codex 端,新增伺服器並將其限制為 Runner 循環:

```

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" ,

"request_session_run" ,

"read_session_task_result" ,

"post_session_note" ,

"read_session_mail" ,

]

```

然後登入:codex mcp login osfoundry。在 osFoundry 的「連接代理人」頁面上,「請求功能」應顯示三行。第三行「執行您授予 Runner 角色的會話」正是本文所討論的內容。如果缺少,表示 osfoundry:run 不在 scopes 中。請修正檔案並重新連線。

設定為 "writes" 後,Codex 會在不詢問的情況下啟動三個讀取工具,並在 request_session_run 和 post_session_note(兩個非唯讀工具)之前停止。

2. 將連線新增至會話專案

回到「已連接」分頁,在「專案」下方,選擇包含會話的專案,然後點擊「新增至專案」。這樣會話的連線就能看到專案中的會話,但仍無法寫入任何會話。

3. 將其設定為 Runner

下方是「代理人、團隊與循環會話」區塊。輔助說明總結了角色:「邀請它作為貢獻者加入會話以發布備註和提議交接,或作為 Runner 以請求執行。」選擇會話類型(代理人會話、團隊會話或循環會話),在「選擇此代理人專案中的會話」中選擇會話,將角色設定為 Runner,然後點擊「儲存角色」。

提示訊息會顯示「會話角色已儲存」,並且該角色會顯示在一行中:類型、會話名稱和角色。例如:代理人、團隊與循環會話區塊中,Codex CLI 在「Triage desk」團隊會話中擔任 Runner。

共有三種角色,貢獻者和 Runner 之間僅差一個工具:

| 角色 (下拉式選單) | 讀取狀態、結果、郵件 | 發布備註 | 排隊執行 |

|---|---|---|---|

| 檢視者 | 是 | 否 | 否 |

| 貢獻者 | 是 | 是 | 否 |

| Runner | 是 | 是 | 是 |

為同一會話儲存另一個角色會取代舊角色。移除會移除該角色。同一個面板包含一個「工具」區塊(「所有支援的工具預設為啟用」)。在此處取消勾選工具會從 osFoundry 端移除該工具,無論 Codex 中的 enabled_tools 如何設定。

實際執行

Codex 未安裝在撰寫本文的機器上,因此以下會話是模擬範例。工具和參數名稱與實際伺服器相同,並帶有 Codex 新增的 mcp__osfoundry__ 前綴。專案、會話、代理人和所有值均為示範內容。

範例 (模擬)

> 重複發票電子郵件的修復已在 PR #231 中。詢問 osFoundry Triage desk 有哪些未結工單與此相關,然後告知他們修復將於週四發布。

  • mcp__osfoundry__list_project_resources {"project_id": "…", "resource_type": "team_session", "search": "triage"} ← team_session "Triage desk"
  • mcp__osfoundry__read_session_state {"session_type": "team_session", "session_id": "…"} ← idle, agents @triager @writer
  • mcp__osfoundry__request_session_run `{

"session_type": "team_session",

"session_id": "…",

"goal": "列出過去 7 天內報告收到兩次相同發票電子郵件的未結支援工單。針對每個工單:工單 ID、客戶方案、一行狀態。背景:原因是郵件任務中的重試,已在 PR #231 中修復,尚未部署。請勿回覆客戶。",

"max_rounds": 3,

"idempotency_key": "codex-pr231-dupe-tickets"}`

[Codex 詢問:允許此工具呼叫? → 是] ← queued, task_id "…"

  • mcp__osfoundry__read_session_task_result {"session_type": "team_session", "session_id": "…", "task_id": "…"} ← pending … (Codex 等待並再次詢問)
  • mcp__osfoundry__read_session_task_result {…same…} ← completed: 4 張工單 (#5512, #5518, #5530, #5541),均為團隊方案
  • mcp__osfoundry__post_session_note `{

"session_type": "team_session",

"session_id": "…",

"subject": "重複發票電子郵件:週四修復發布",

"body": "根本原因在於郵件任務中的重試。PR #231 已合併並將於週四發布。可以告知 #5512、#5518、#5530 和 #5541。",

"idempotency_key": "codex-pr231-note"}`

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

  • mcp__osfoundry__read_session_mail {"session_type": "team_session", "session_id": "…", "limit": 10} ← 2 則備註:您的,以及 @writer: 「已為所有四個草擬回覆,保留至週四。」

Triage desk 找到了四張關於重複電子郵件的未結工單,均為團隊方案。我告知團隊修復將於週四發布;@writer 已草擬回覆並將其保留至那時。

限制所在

goal 承載著上下文。request_session_run 沒有單獨的上下文欄位,且其架構拒絕任何未列出的參數:因此,代理人需要知道的一切都必須包含在目標本身中。在所有者端,執行不會顯示為匿名任務。會話的「觸發」分頁(「什麼啟動此會話」)會將其顯示為「外部助理請求」,下方是目標,然後在執行期間顯示「正在運行中」,完成後顯示「上次運行:」。

備註會以連線的顯示名稱出現在團隊信箱中,標記為「外部助理」。代理人可以回覆,而 read_session_mail 會將這些回覆報告給 Codex。執行者可以啟動工作,但不能塑造會話。架構是封閉的 (additionalProperties: false):Codex 無法傳遞模型、工具列表或額外上下文。會話會以其自身的設定在所有者的執行環境中運行。max_rounds 限制為 10。

沒有人可以超越。當會話在所有者的桌面應用程式中運行時,執行環境會每 15 秒檢查一次任務,只要有工作就持續如此。在四次空輪詢後,它會減慢到 30 秒,然後是 60 秒,然後是五分鐘,應用程式中的任何人工操作都會立即喚醒它。它一次執行一個會話的一個任務,並保留下一個任務直到會話空閒。這就是為什麼工具指示執行環境會在「可用時」執行任務。Codex 必須定期查詢結果,而不是保持單一呼叫開放。

來自外部的文字仍被視為外部文字。在桌面執行環境的程式碼中,只有所有者手動啟動的執行才算作操作員輸入。來自外部助理的目標會像網路掛鉤的主體一樣被過濾。請以簡單的指令形式撰寫目標,不要貼上任何您不希望被過濾的內容。Codex 看到的是結果,而不是對話。read_session_task_result 僅回覆此連線啟動的任務。

read_session_mail 會回傳發送給連線的備註以及它發布的備註,每次呼叫 1 到 20 則,不包含代理人的內部分析。備註絕不會啟動執行。工具說明明確指出它「不會觸發自動執行」:角色仍然是唯一的入口點。所有僅存在於所有者桌面上的內容都無法觸及。伺服器的 initialize 回覆指出:「本機資料無法供雲端客戶端使用。」

接下來,嘗試一個循環會話。將 Codex CLI 設定為您已手動啟動的循環的 Runner,然後要求 Codex 在每次合併後將循環的下一個階段排入佇列,目標是一個段落,說明發生了什麼變化。代理人的任務佇列會顯示這些執行如何排列,而代理人郵件會解釋備註如何在代理人之間流動。

Share

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

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

Newsletter

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

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

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