开源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/trueforgeTrueForge是一个开源Agent Harness智能体运行框架也是连接大模型与真实世界的运行时层——它替你跑完 Agent 的整个执行循环模型调用、MCP 工具、技能、沙箱、人工审批、上下文管理和会话状态再用一条npx命令把 LLM 变成一个真正能干活的 Agent。你可以把它理解为「Agent 版的应用服务器」模型只负责思考干活的部分交给 Harness。为什么LLM需要一个Agent Harness一个只会「输出文字」的大模型和「能交付结果」的 Agent 之间隔着一整套工程问题执行循环规划 → 调用模型 → 路由工具 → 执行 → 再规划循环往复直到任务完成上下文管理长任务里既要信息足够又不能把窗口塞满噪音安全边界写操作、危险操作必须有人工审批卡点代码必须在隔离沙箱里跑会话持久化对话和任务状态要能断线重连、重启不丢这些正是 Agent Harness 的职责。TrueForge 把这些能力全部内置开箱即用。TrueForge 三层架构服务端 API/SDK 聊天UITrueForge 由三部分组成组件说明核心服务端运行 Agent 循环流式返回每一步敏感操作暂停等待审批HTTP API TypeScript SDKUI 里能做的API 里都能自动化REST SSE OpenAPI聊天 UI UI SDK开箱即用的界面也支持嵌入你自己的 React 应用做品牌定制它提供两种运行方式功能完全一致只有后端不同模式适合场景存储额外依赖启动方式Local个人试用SQLite无npx一条命令Hosted团队共享、多副本PostgresPostgres RedisDocker Compose 或 Helm⚠️ Local 模式仅建议在 localhost 个人使用团队或生产环境请走 Hosted 模式并开启登录。一键安装步骤一条命令跑起来 TrueForge方式一npx 本地模式最快上手要求 Node.js ≥ 22.14一条命令即可无需任何其他基础设施npx truefoundry/trueforgelatest然后打开http://localhost:8790UI 和后端就都在本地跑起来了数据存在本地 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供应商说明openai / anthropic / google-geminiOpenAI、Anthropic、Google Geminifireworks / together / moonshot / zai / alibabaFireworks、Together、Kimi、GLM、Qwencustom任意 OpenAI 兼容端点vLLM、Ollama、自建网关都行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中途提问任务不明确时结构化地向用户澄清生成式 UIAgent 可以把图表、表格、卡片直接流式渲染进聊天界面无任意代码执行以上能力的完整说明见 docs/key-features/overview.mdx沙箱细节见 docs/sandbox.mdx。真实成本对比基准测试能省多少钱官方在 14 个企业级跨系统任务同一模型、同一批 MCP 工具上做了对比测试配置通过 / 14单次成本Claude Managed Agents · Opus 4.810.7$11.8TrueForge · Opus 4.810.7$8.6便宜约30%TrueForge · GLM-5.211.7$3.0便宜约75%deepagents · Opus 4.810.0$21.2结论同等准确率成本更低换成高效开源模型后成本再降 60%。复现脚本在 benchmark/测试矩阵为 benchmark/bench_matrix.py完整方法见 docs/benchmarking.mdx。下一步继续深入资料路径快速上手docs/quickstart.mdx初始配置模型/MCP/技能/沙箱目录docs/harness/initial-setup.mdx创建 Agent 完整字段说明docs/create-agent/overview.mdxTypeScript SDKpackages/trueforge-sdk/可嵌入的 React UI SDKpackages/trueforge-ui/核心运行框架源码packages/trueforge-core/API 总览docs/api/overview.mdx从npx truefoundry/trueforgelatest开始几分钟内你就能拥有一个带 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
