FrontierAgent
🧩 FrontierAgent,我們的代理框架,與之一起開源 — 原生命令列 TUI、ReAct 與 Agent Team 模式,在 macOS 和 Linux 上只需一個指令,無需預先安裝
FrontierAgent 是什麼?
🧩 FrontierAgent,我們的代理框架,與之一起開源 — 原生命令列 TUI、ReAct 與 Agent Team 模式,在 macOS 和 Linux 上只需一個指令,無需預先安裝,無需強制依賴 Docker。
FrontierAgent 概覽
這是什麼
FrontierAgent 是一個開源的代理執行環境、終端產品與評估套件,專為長時間研究與基於檔案的工作而設計。frontier-agent TUI 提供兩種原生工作流程:ReAct(一個有狀態的代理進行研究、讀取檔案、撰寫交付物、執行命令,並在任務範圍的沙盒中迭代)與 Agent Team(協調者維護任務看板,將獨立工作委派給平行子代理,收集他們的報告,並綜合結果)。相同的工作流程引擎也驅動用於評估 Apodex 模型的基準測試執行器。框架、工具、工作流程與評估層保持分離,因此每個部分都可獨立重複使用。
主要功能
- 原生 Agent Team 工作流程。 協調者分解請求,分派有界限的平行任務,接收結構化報告,並可選用快速報告者進行最終證據審查。
- 任務看板。 Agent Team 的
add_task與update_task事件即時顯示在 TUI 側邊欄,狀態包含待處理、進行中、已完成、受阻與已取消。 - 沙盒化檔案工作。 Shell 與檔案工具共用一個任務範圍的檔案系統:
/inputs為唯讀,/workspace為工作狀態,/outputs包含持續的交付物。授權與沙盒失敗會以失敗關閉方式處理。 - 非同步干預。 在代理執行時輸入內容可排入新指令。它會在下一個安全回合邊界注入,不會捨棄正在進行的執行。在 Agent Team 模式下,它會引導協調者;已在運行的子代理則允許完成。
- 透明的交付物。 在 macOS/Docker 上,
/outputs對應到主機上的.apodex/runs//outputs。同一個執行目錄也包含其檢查點、追蹤、引擎日誌與軌跡。 - 核准、追蹤與復原。 變更操作會顯示差異並要求核准(除非啟用
--yes)。工作階段會建立檢查點,每個動作都會在本地追蹤,/revert可還原工作階段變更,--resume可繼續已儲存的執行。 - 內建評估。 子程序執行器支援研究與基於檔案的基準測試、確定性工件收集、並行處理、進度檢查,以及重新執行個別失敗項目。
使用情境
- 需要反覆閱讀、撰寫與執行命令的長時間研究任務。
- 使用沙盒化輸入、工作區與輸出進行基於檔案的工作。
- 執行代理團隊以進行平行子任務委派與綜合。
- 在研究與基於檔案的基準測試(例如 FrontierSearchBench、FrontierChallenge)上評估模型。
- 使用 OpenAI 相容端點進行代理工作流程的本地開發與測試。
快速開始
需求:Git、Python 3.12、uv 以及一個 OpenAI 相容的模型端點。Docker 為選用。 bash git clone https://github.com/ApodexAI/FrontierAgent.git cd FrontierAgent uv sync --python 3.12 --extra dev cp .env.example .env 在 .env 中加入你的端點: dotenv OPENAI_API_KEY=your-key OPENAI_BASE_URL=https://your-openai-compatible-endpoint/v1 OPENAI_MODEL=your-model-name 啟動 TUI: bash # 有狀態的單一代理工作流程 uv run frontier-agent --mode react --cwd /path/to/project # 協調者加上平行子代理 uv run frontier-agent --mode agent_team --cwd /path/to/project
授權與價格
採用 Apache-2.0 授權。開放原始碼且免費使用。
內容整理自該專案公開的 README 與儲存庫資訊。