
HarnessRouter 自定义 Harness 完全指南5 步配置专属 AgentSkills 与 MCP 工具一次搞定【免费下载链接】harnessrouterHarnessRouter Community Edition: the self-hosted, Apache-2.0 edition of the unified interface for agent harnesses. Run Codex, Claude Code, Hermes, PI, DSH, and more through one API, with sessions, streaming, files, cancellation, and failure handling. Implements the Unified Harness Protocol (UHP), an open standard. Your keys, your infrastructure.项目地址: https://gitcode.com/gh_mirrors/ha/harnessrouterHarnessRouter 社区版是一个可自托管的 Agent 统一接入层它把 Codex、Claude Code、Hermes 等主流 Agent Harness 变成同一个 API 背后的即插即用后端。本文面向新手带你用5 步在 HarnessRouter 中配置一个专属的自定义 HarnessCustom Harness并一次性配好Agent 指令、MCP 工具与 Skills 技能让你不用写胶水代码就能拥有一个行为可控、可复用的专属 Agent。先搞懂 3 个概念 ⚙️概念一句话解释Base Harness基础运行时Agent 的引擎如 Codex、Claude Code、DeepSeek Harness自定义 Harness在引擎之上保存的一套专属配置默认模型 指令 工具 技能Skills / MCPSkills 是教 Agent怎么做的技能文档MCP 是给它接上外部能力的工具服务器内置 Harness 开箱即用但当你想让 Agent 固定扮演某种角色、遵守你的输出规范、或调用自己的工具时就需要自定义 Harness。它的设置入口和表单实现分别在 Harness 设置组件 与 Harness 列表页/harnesses/page.tsx) 中界面文案与下文步骤一一对应。第 1 步启动 HarnessRouter 并连接模型提供商前置条件很简单Docker 约 4 GB 磁盘 一个模型提供商的 API Key。一条命令启动docker run -d --name harnessrouter \ -p 127.0.0.1:3000:3000 \ -v harnessrouter:/data \ harnessrouter/harnessrouter等待日志出现ready on :3000后用默认账号harnessrouter / harnessrouter登录控制台记得在 Profile 里改密码。然后在侧边栏Bring Your Own KeyIntegrations中点击Add Integration选择提供商并填入 API Key该提供商支持的模型就会立刻出现在下拉列表里 这一步的密钥只授权模型请求与后面集成产品用的 API Key 不是一回事详见 自托管指南。第 2 步新建一个自定义 Harness打开Agent harnesses页面点击右上角New harness。在Add harness弹窗里一次性填好三样东西Name— 给你的专属 Agent 起个名字例如客服反馈分析 AgentBase harness— 选择底层引擎Codex、Claude Code、DeepSeek Harness 等Default model— 选择默认模型来自第 1 步连接的提供商。然后点Create and configure系统会把你带进该 Harness 的配置页。注意基础运行时创建后不可更改默认模型则之后随时可以改。第 3 步编写 Agent instructions固定角色与规范配置页的第一段就是Agent instructions这里写下的角色、约定、约束和输出格式会在每一轮任务开始时自动加载而基础 Harness 自带的系统提示词保持不变。新手可以直接套这个模板你是 XX 领域的专家。处理任务时① 先给出结论再展开② 只使用给定文件中的数据③ 输出必须是 Markdown 表格。写得越具体Agent 的行为越稳定——这是自定义 Harness 价值最大的一步。第 4 步添加 MCP 工具给 Agent 接上外部能力Tools区域可以开关引擎自带的工具如搜索更重要的是Add MCP按钮点击后填入一个 MCP Server 的名称与地址Agent 在之后的每个任务里都能直接调用它的工具。典型用途让 Agent 查询你内部的数据库或知识库接入日历、工单、部署系统等企业服务的 MCP 实现。如果多个 Harness 要共享同一组工具和技能可以用PluginsAgent Plugins 包格式一次性安装格式规范见 协议 Plugins 章节。第 5 步添加 Skills保存并实测Skills区域用来挂载技能包——每个技能就是一个带SKILL.md的文件夹教 Agent 完成某类固定流程例如把合同转成风险清单。你可以新增自己的技能、覆盖继承来的技能或禁用不希望 Agent 使用的能力。全部配好后点Save Changes保存配置点Run Task输入一个具体任务观察实时流式输出与产出的文件。保存后的自定义 Harness 就有了自己的Harness ID在控制台和 API 中都可以按 ID 直接调用方便产品集成与后续复用。保存之后把专属 Agent 接入你的产品 配置好的自定义 Harness 可以像内置 Harness 一样通过 OpenAI Responses 兼容 API 调用只需在请求的metadata.harness_id中填你的 Harness ID 即可切换后端。完整流程、密钥管理与流式说明见 自托管指南 - Using the API协议层面的行为定义见 UHP 规范。常见问题 FAQQ内置 Harness 和自定义 Harness 有什么区别A内置 Harness 是纯净的运行时自定义 Harness 运行时 你的模型/指令/工具/技能适合沉淀团队规范并反复复用。Q创建后能换基础运行时吗A不能Base harness 创建后不可更改但默认模型、指令、MCP 与 Skills 都可以随时修改。QSkills 和 MCP 工具是必须的吗A都不是。最小可用的自定义 Harness 只需要名字、基础运行时和模型指令、工具、技能按需添加即可。Q配置可以迁移到别处吗A可以。自定义 Harness 可以保存并上传到 HarnessRouter Cloud上传只复制配置不包含提供商密钥、会话或文件详见 self-hosting-guide 的迁移章节。【免费下载链接】harnessrouterHarnessRouter Community Edition: the self-hosted, Apache-2.0 edition of the unified interface for agent harnesses. Run Codex, Claude Code, Hermes, PI, DSH, and more through one API, with sessions, streaming, files, cancellation, and failure handling. Implements the Unified Harness Protocol (UHP), an open standard. Your keys, your infrastructure.项目地址: https://gitcode.com/gh_mirrors/ha/harnessrouter创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考