HarnessRouter/harnessrouter

解决的问题

HarnessRouter 消除了开发人员为产品中使用的每个不同代理框架（如 Codex 或 Claude Code）构建自定义整合逻辑的需求。它提供了一个单一、统一的 API 层，允许产品运行任务、管理会话并在不同的代理后端之间切换，而无需重写整合代码。

运作方式

它实现了统一框架协议 (UHP) 并提供与 OpenAI Responses 兼容的 API。该系统由用于管理的 Console、用于 API 处理和框架生命周期的 Gateway，以及在隔离会话工作区中执行框架的 Runner 组成。用户可以连接自己的模型提供商密钥，配置内置或自定义框架（包括指令、工具和 MCP 服务器），并通过 API 调用使用 harness_id 来指定后端以触发代理任务。

目标用户

正在构建代理应用程序的开发人员和产品团队，他们希望使用专业的代理框架作为可插拔后端，同时保持对基础设施、成本和延迟的控制。

特色亮点

• 统一接口： 一个 API 即可管理多个代理框架，减少整合开销。
• OpenAI 兼容： 可与现有的 OpenAI Responses SDK 和流式解析器配合使用。
• 会话管理： 处理持久会话、流式进度、文件附件和任务取消。
• 可自定义框架： 支持创建具有特定指令、工具和技能的自定义框架。
• 灵活部署： 可通过 Docker 进行自托管的 Community Edition，或作为托管的 Cloud 服务使用。