企业官网建设流程全解析

开源Agent Harness是什么？TrueForge完全指南：一条命令把LLM变成真正能干活的Agent

【免费下载链接】trueforgeThe open-source agent harness - the runtime layer that turns an LLM into a working agent.项目地址: https://gitcode.com/gh_mirrors/tr/trueforge

TrueForge是一个开源Agent Harness（智能体运行框架），也是连接大模型与真实世界的运行时层——它替你跑完 Agent 的整个执行循环：模型调用、MCP 工具、技能、沙箱、人工审批、上下文管理和会话状态，再用一条npx命令把 LLM 变成一个真正能干活的 Agent。你可以把它理解为「Agent 版的应用服务器」：模型只负责思考，干活的部分交给 Harness。

为什么LLM需要一个Agent Harness？

一个只会「输出文字」的大模型和「能交付结果」的 Agent 之间，隔着一整套工程问题：

• 执行循环：规划 → 调用模型 → 路由工具 → 执行 → 再规划，循环往复直到任务完成
• 上下文管理：长任务里既要信息足够，又不能把窗口塞满噪音
• 安全边界：写操作、危险操作必须有人工审批卡点；代码必须在隔离沙箱里跑
• 会话持久化：对话和任务状态要能断线重连、重启不丢

这些正是 Agent Harness 的职责。TrueForge 把这些能力全部内置，开箱即用。

TrueForge 三层架构：服务端 + API/SDK + 聊天UI

TrueForge 由三部分组成：

它提供两种运行方式，功能完全一致，只有后端不同：

⚠️ Local 模式仅建议在 localhost 个人使用；团队或生产环境请走 Hosted 模式并开启登录。

一键安装步骤：一条命令跑起来 TrueForge

方式一：npx 本地模式（最快上手）

要求 Node.js ≥ 22.14，一条命令即可，无需任何其他基础设施：

npx @truefoundry/trueforge@latest

然后打开http://localhost:8790，UI 和后端就都在本地跑起来了，数据存在本地 SQLite 文件里。

方式二：Docker Compose 托管模式（团队部署）

服务端 + Postgres + Redis 全套拓扑一次拉起：

git clone https://gitcode.com/gh_mirrors/tr/trueforge && cd trueforge cp packages/trueforge/.env.example packages/trueforge/.env docker compose up --build

打开http://localhost:8791即可。编排文件在 docker-compose.yml；上 Kubernetes 可以用官方 Helm 图表，模板位于 charts/trueforge/，支持副本数、自带 Postgres/Redis、OIDC 登录等配置（见 charts/trueforge/values.yaml）。

构建你的第一个Agent：模型、MCP工具、技能三步走

打开界面后，一个可复用的 Agent =模型 + 指令 + 工具 + 技能 + 运行行为。下面走一遍完整的配置流程。

第一步：连接模型供应商

进入Settings → Models，从内置目录中选择一个供应商，粘贴 API Key，该供应商的模型立即可用。

内置目录支持的供应商覆盖主流国内外厂商（目录定义在 packages/trueforge/catalog/model-catalog.yaml）：

Agent 只按名字引用模型，API Key 永远不出现在 Agent 定义里。

第二步：挂载 MCP 工具连接器

进入Settings → Connectors配置 MCP 服务器后，在 Agent 构建器的 Connectors 标签页勾选即可。认证信息存在连接器里，支持 Header 认证和 OAuth（含聊天内一键授权）。

连接器预设同样来自 YAML 目录：packages/trueforge/catalog/mcp-catalog.yaml。

第三步：添加技能（Skills）

技能是基于 Git 的SKILL.md指令包，用来教会 Agent 专业流程——查数据库、走升级处理流程、写发布说明。支持从 GitHub 仓库直接导入：

技能默认只把名称和描述放进上下文，完整内容由 Agent 在沙箱中按需加载（渐进式披露），从而把上下文窗口省下来给真正的推理。

核心能力：这些特性让Agent真正可靠

沙箱即工具：Secret 不落地，按需分配

大多数框架把整个 Agent 塞进沙箱/VM 里；TrueForge 反过来——Agent 循环留在服务端，沙箱只是一个工具，只在真正需要跑代码、操作文件时才分配（目前支持 Daytona 供应商）。这带来三个直接好处：

• 模型和 MCP 凭证永不进入沙箱
• 沙箱崩溃不影响会话状态
• 纯问答、纯 MCP 调用的轮次零沙箱成本，更快更便宜

子代理 + 上下文工程：长任务不跑偏

• 子代理（Subagents）：主 Agent 可以把子任务派给并行子代理，各自独立上下文，只把结论汇报回来
• 延迟工具加载：默认只加载 MCP 服务器的名称和描述，工具 schema 用到才展开
• Code Mode / 大结果卸载 / 压缩：长结果不落上下文，历史自动压缩

人工检查点：审批、提问、生成式UI

• 工具审批：MCP 工具被标记为写/破坏性操作时，Agent 自动暂停，展示参数，等你点 Allow / Deny
• 中途提问：任务不明确时结构化地向用户澄清
• 生成式 UI：Agent 可以把图表、表格、卡片直接流式渲染进聊天界面（无任意代码执行）

以上能力的完整说明见 docs/key-features/overview.mdx，沙箱细节见 docs/sandbox.mdx。

真实成本对比：基准测试能省多少钱？

官方在 14 个企业级跨系统任务（同一模型、同一批 MCP 工具）上做了对比测试：

结论：同等准确率，成本更低；换成高效开源模型后成本再降 60%。复现脚本在 benchmark/，测试矩阵为 benchmark/bench_matrix.py，完整方法见 docs/benchmarking.mdx。

下一步：继续深入

从npx @truefoundry/trueforge@latest开始，几分钟内你就能拥有一个带 UI、带工具、带审批、带沙箱的可用 Agent——而所有这些都由这个开源 Agent Harness 替你跑完。

【免费下载链接】trueforgeThe open-source agent harness - the runtime layer that turns an LLM into a working agent.项目地址: https://gitcode.com/gh_mirrors/tr/trueforge