企业集成与 Runtime API
本文说明 Harness 在原有本地工作台之上新增的企业系统连接能力。原有文件处理、Office、技能市场、企业空间、团队 Skill 沉淀、设备令牌与审计全部保留。
1. 能力边界
| 能力 | 说明 | 默认 |
|---|---|---|
| 企业系统连接器 | 连接器在 ERP/WMS/MES 侧运行，通过 MCP 只读工具查询库存、流水、生产计划 | 只读 |
| Runtime API | 同步/异步消息、会话管理、执行 trace；供企业系统或集成商调用 | Bearer Token |
| 签名 Skill Pack | 企业空间 Skill 服务端签名、版本化下发、客户端验签同步、可回滚 | 按租户 |
| 本地工作台 | 文件、命令、Office 处理在本机；只有模型推理走加密网络 | 保留 |
2. 企业系统连接器
连接器以 MCP 服务方式运行在企业侧；Harness 只看到被授权的工具，不直接访问数据库。
- 固定服务名
erp，工具名形如mcp__erp__get_inventory； - MCP 配置在客户端完整重启后生效，不支持热替换；技能文件可热加载；
- 字段、工具、租户三层白名单；写操作默认关闭；
- Token 与租户/设备绑定，可轮换、可吊销；
- 每次调用记录 requestId、toolName、tenant 与结果。
数据边界：连接器只返回任务所需字段；原始数据不复制到平台。模型 Key 不下发到客户端或企业系统。
3. Runtime API
Runtime API 用于把数字员工接进企业现有系统，而不是让人再打开一个聊天窗口。当前 v1 提供：
| 接口 | 作用 |
|---|---|
POST /v1/sessions | 创建会话 |
POST /v1/sessions/:id/messages | 发送消息；支持同步与异步（async） |
GET /v1/runs/:id | 查询异步任务状态与结果 |
GET /v1/sessions/:id | 读取会话 |
GET /v1/sessions/:id/trace | 读取执行 trace |
鉴权：Authorization: Bearer <tenant runtime token>。Token 与租户绑定；模型 Key 不通过 Runtime API 下发。
注意：Runtime API 不应直接暴露公网。远程接入走 HTTPS 网关，由网关负责鉴权、TLS 与访问控制；不要在浏览器或前端代码中放置 Runtime Token。
4. 签名 Skill Pack
技能市场继续提供公共技能与行业包；企业空间可以把团队跑通的流程沉淀成 Skill，并做签名下发。
- 服务端签名，客户端验签后再写入；签名过期或验签失败不执行；
- 内容哈希作为版本，配合 ETag；未变化返回 304；
- 发布前人工审核；版本快照可回滚；
- 按企业空间隔离，不串租户。
未实现能力：外部批量导入 Skill Pack 的接口当前未实现，不在本文档中作为已交付 API 承诺。企业 Skill 可通过管理端审核发布，客户端从签名包接口同步。
5. 部署形态
| 形态 | 适用 | 边界 |
|---|---|---|
| 本机 / 单机 | 个人或单机试点 | loopback；连接器与客户端同机 |
| 企业内网 | ERP 在内网、团队共享 | 内网访问；按企业空间隔离 |
| HTTPS 网关 | 远程接入 / 多地点 | 网关鉴权、TLS、IP 白名单；Runtime 不直接公网暴露 |
6. 下载与版本
企业系统连接能力从 1.26.24 起提供。Windows 免安装版已完成企业集成验证；安装版待管理员环境补验。原有本地工作台、Office、技能市场、企业空间与审计能力保持在同一下载包中。
下载 1.26.24 · 企业集成方案 · 企业空间