FrontierAgent 教程:带任务看板的开源 Agent 运行时

📌 项目地址:github.com/ApodexAI/FrontierAgent | 星数:3,100+ | 协议:Apache-2.0 | 语言:Python

📋 项目简介

FrontierAgent 是 ApodexAI(就是发 Apodex-1.1 模型的那家)开源的 agent 全家桶:运行时框架 + TUI 终端产品 + 评测套件三件套,而且三者架构分离、可独立复用。它瞄准的是「长周期研究 + 文件型工作」——也就是那种要跑很久、要读写一堆文件的任务。和我们在 PI-Desktop教程:本地优先AI编码Agent桌面端 里介绍的桌面流不同,FrontierAgent 是终端原生(TUI),配合 codex-astra-luna-orchestrator 一类编排思路,主打「看得见的任务看板 + 摸得着的沙盒边界」。

✨ 核心特性

特性说明
ReAct 工作流单 agent:研究、读文件、写交付物、跑命令、循环迭代
Agent Team 工作流协调者 + 并行子代理 + 报告收集 + 结果合成
任务看板TUI 侧边栏实时显示任务状态流转
沙盒三区/inputs 只读、/workspace 工作、/outputs 持久交付
异步干预agent 运行中直接打字插队,下个安全点注入
Fail-closed授权与沙盒失败默认拒绝,不静默越权

🚀 安装

# 官方文档索引里有按场景分的安装指南
# 支持 OpenAI 兼容 API(Apodex-1.1 等)与自托管 SGLang
# 详见 docs/README.md 的 installation / SGLang / workflow / 评测 / 开发者指南

# 官方限时活动:Apodex API 免费用两周
# platform.apodex.ai 领 key,接 OpenAI 兼容端点即可

⚙️ 两种工作流怎么选

💡 使用建议

📚 常见问题

FrontierAgent 是什么?

ApodexAI 开源的 agent 运行时、终端产品和评测套件三合一(GitHub 3.1k 星,Apache-2.0),面向长周期研究与文件型工作。frontier-agent TUI 内置两种原生工作流:ReAct(单个有状态 agent 在任务沙盒里研究、读写文件、跑命令、迭代)和 Agent Team(协调者维护任务看板,把独立工作委派给并行子代理,收集报告后合成结果)。

FrontierAgent 的沙盒怎么隔离文件?

Shell 与文件工具共享一个任务级文件系统:/inputs 只读(输入材料)、/workspace 是工作状态(中间产物)、/outputs 存放持久交付物(最终成果)。授权与沙盒失败均为 fail-closed(默认拒绝),不会静默越权。这套三区设计让长任务的输入、过程与结果天然分离,便于审计和交付。

Agent Team 工作流怎么运作?

协调者(coordinator)把请求分解为有边界的并行任务,通过 add_task 和 update_task 事件维护任务看板,子代理完成后提交结构化报告,最后由协调者(可选一个快速 reporter)做证据复核并合成最终结果。任务看板在 TUI 侧边栏实时显示 pending、active、completed、blocked、cancelled 五种状态。运行中还可以直接打字插队新指令,会在下一个安全点注入。