Codex Harness – OpenAI 開源的 AI Agent 底層執行框架

AI工具1個月前發佈新公告 AI管理員
1 0

Codex Harness是什麼

Codex Harness 是 OpenAI 開源的 AI Agent 底層執行框架。Codex Harness 是驅動 Agent 的外骨骼,負責任務理解、記憶保持、工具調用、進度展示、失敗處理及人類審批等完整執行循環。開發者可通過 CLI、SDK 和 app-server 三大組件,將 AI 智能體無縫嵌入自有產品、運營看板或業務系統,無需再把工作流硬塞進通用聊天框。

Codex Harness – OpenAI 開源的 AI Agent 底層執行框架

Codex Harness的主要功能

  • Agent 執行循環:驅動 AI 智能體完成從任務理解到結果輸出的完整迭代流程。
  • 上下文與記憶管理:在長對話中保持上下文連貫,智能壓縮和審查相關信息。
  • 工具與技能調用:支持 AI 靈活調用外部 API、數據庫及自定義業務工具。
  • 沙箱安全執行:提供隔離的運行時環境,確保文件系統與網絡操作安全可控。
  • 流式事件傳輸:支持實時嚮應用前端推送 AI 的思考過程與執行進度。
  • 人類審批介入:在關鍵操作前自動暫停並請求人類確認,實現安全的人機協作。
  • 會話持久化:支持跨會話保存和恢復對話狀態、線程與任務生命週期。
  • 前後端解耦架構:將審批界面與底層執行循環分離,便於無縫嵌入任意業務系統。

Codex Harness – OpenAI 開源的 AI Agent 底層執行框架

微信關注回覆“開源”,加入AI開源項目交流羣

如何使用Codex Harness

  • 獲取開源代碼:前往 GitHub 的 openai/codex 倉庫克隆項目,即可解鎖完整的 Harness 工具庫。
  • CLI 快速執行:用 codex exec 命令行工具運行有邊界的 Agent 工作流,適合腳本和 CI 自動化任務。
  • SDK 編程集成:通過 TypeScript 或 Python 版官方 SDK,在代碼中精準啓動、恢復或流式傳輸 Codex 任務。
  • App-Server 產品嵌入:部署 Codex app-server,通過 JSON-RPC 協議將 Agent 循環深度集成到自有業務系統。
  • 暴露業務工具:將應用自身的 API、數據庫及操作接口通過 MCP 協議暴露給 Harness,讓 AI 調用真實業務數據。
  • 配置審批流程 :在前端接入審批界面,Harness 會在關鍵操作前自動暫停並請求人類確認,實現安全的人機協作。
  • 流式事件監聽:訂閱 Harness 的流式事件輸出,在應用前端實時展示 AI 的思考過程與執行進度。
  • 注入業務上下文:向 Harness 傳入產品界面狀態、用戶行爲及業務規則,讓 AI 基於真實場景而非通用聊天框工作。

Codex Harness的核心優勢

  • 開源可嵌入:開發者可將 AI Agent 執行循環直接嵌入自有產品、運營看板或業務系統,無需把工作流硬塞進通用聊天框。
  • 前後端徹底解耦:應用層掌控界面、上下文、工具與審批流程,Harness 層專注 Agent 循環與沙箱執行,通過 JSON-RPC 協議實現通信分離。
  • Harness 設計即性能:在 ARC-AGI-3 基準上僅優化 Harness(保留推理+上下文壓縮),GPT-5.6 Sol 得分從 13.3% 飆升至 38.3%,Token 消耗減少 6 倍。
  • 沙箱安全執行:內置隔離運行時環境,嚴格控制文件系統、網絡訪問與運行時審批,確保 Agent 動作可控、可審計、可回滾。
  • 原生 Human-in-the-Loop:在關鍵操作前自動暫停並請求人類確認,審批通過後才繼續執行,天然適合容錯率極低的業務場景。
  • 流式事件與持久會話:支持實時向前端推送 AI 思考與執行進度,並可跨會話保存和恢復線程狀態,適配長週期工作流。
  • 模型無關的執行引擎:Harness 是編排層而非模型層,可與不同底層模型配合,聚焦「如何管理模型」而非綁定特定模型。

Codex Harness的項目地址

  • 項目官網:https://developers.openai.com/blog/codex-as-a-platform
  • GitHub倉庫:https://github.com/openai/codex

Codex Harness的同類競品對比

對比維度 Codex Harness LangGraph
核心定位 將 Agent 循環作爲可嵌入產品的底層執行引擎 基於圖狀態機的 Agent 工作流編排框架
架構設計 前後端分離:應用層控制界面/審批,Harness 處理執行循環 節點-邊模型:開發者定義顯式狀態流與檢查點
審批機制 原生內置 Human-in-the-Loop,關鍵操作自動暫停請求確認 需開發者手動在節點間插入中斷/審批邏輯
沙箱執行 內置隔離運行時,控制文件系統、網絡與工具訪問 無原生沙箱,需依賴外部容器/環境隔離
集成方式 JSON-RPC 協議連接 App-Server,流式事件實時推送 作爲 Python/JS 庫直接嵌入代碼,檢查點持久化
適用場景 已有成熟業務界面的產品,需 AI 在底層執行且人類掌控審批 需要精確控制多步驟狀態流轉的複雜工作流編排

Codex Harness的應用場景

  • 財稅合規自動化:嵌入稅務準備工作流,AI 處理複雜稅務邏輯並自動填充申報表,稅務師在關鍵字段審批確認,已驗證處理 7,000 份申報表、準備時間縮短約三分之一。
  • 企業雲平台應用構建:如 Cisco App Builder,客戶在其雲控制平台內使用自然語言創建自定義應用,Harness 在幕後處理權限校驗與底層邏輯流轉。
  • 物流調度異常處理:在物流看板中嵌入 Agent,調度員點擊「Investigate delay」後,Agent 自動調用 MCP 工具獲取實時運單數據、分析延誤原因,任何改單操作都需人工審批。
  • 運營儀表盤嵌入:將 Agent 直接集成到現有運營看板中,實時分析業務指標、觸發異常告警、執行修復動作,無需切換至獨立聊天界面。
  • 安全運維審批:安全分析師在預警隊列中直接調用 Agent 排查受影響服務狀態,高危操作自動觸發 Human-in-the-Loop 審批後執行。

Codex Harness的相關問題

Q:Codex Harness 是什麼?和 Codex 模型有什麼區別?

A: Harness 是驅動 AI Agent 的底層執行引擎,負責任務理解、記憶保持、工具調用、沙箱執行、流式事件和審批流程;而 Codex 模型是生成代碼/推理的「大腦」。Harness 是「外骨骼」,模型是「大腦」,兩者配合才能跑通完整 Agent 工作流。


Q:開源協議是什麼?可以免費商用嗎?

A: Apache-2.0 協議,可以完全免費商用。你可以自由嵌入自有產品、修改源碼、二次分發,無需開源你的上層業務代碼。


Q:必須綁定 OpenAI 的 GPT 模型嗎?能用 Claude 或 DeepSeek 嗎?

A: Harness 是模型無關的編排層,架構上不強制綁定 GPT。但當前官方實現默認對接 OpenAI API,若要替換爲其他模型,需自行適配模型調用層。


Q:三大組件怎麼選?什麼場景用哪個?

A:

codex exec → 腳本、CI 流水線、後台一次性任務,返回結構化結果。

Codex SDK → 你在寫應用代碼,需要編程式啓動、恢復或流式傳輸任務。

Codex app-server → Agent 要成爲產品的一部分,需要持久對話、實時事件、中斷工作和審批處理。


Q:已有業務系統,如何接入 Harness?

A: 通過 Codex app-server 的 JSON-RPC 協議連接。你的應用負責提供「產品界面 + 業務上下文 + 審批流程」,Harness 負責「Agent 循環 + 沙箱執行」,雙方通過 Context in / Events out 雙向通信。


Q:Human-in-the-Loop 怎麼實現?對業務侵入大嗎?

A: Harness 在檢測到「需審批的操作」時自動暫停 Agent 循環,通過流式事件向前端推送審批請求;用戶確認後 Harness 繼續執行。業務端只需實現一個審批 UI 並響應 JSON-RPC 事件,侵入性極低。

© 版權聲明

相關文章

暫無評論

暫無評論...