阅读时间：1 分钟
0 字
API、MCP 与工具边界
REST、MCP、SDK 和未来 GraphQL 是同一平台能力的协议适配，不分别实现业务规则。Registry、Runtime、Actions 和 Policy 是语义与执行的权威服务。
能力映射
| 内部能力 | REST | MCP / Tool Registry |
|---|---|---|
| 发现本体与版本 | 本体、Schema 查询接口 | 可见资源和工具上下文 |
| 查询实体与关系 | Entity Query、Traverse | 只读 Function 工具 |
| 执行 Action | Action 提交与状态接口 | 有副作用工具，返回 executionId |
| 查询执行证据 | Execution、Evidence 接口 | 受权的状态与证据工具 |
上下文传播
所有协议传播验证后的租户、用户或服务、Agent、Harness、委托链、模型版本、用途、traceId 和可选幂等键。内部服务不重新相信外部原始字段，而是使用签名或受信任的服务上下文。
工具注册
Tool Registry 从已发布 Function 和 Action 生成工具候选，再根据租户套餐和策略过滤。工具说明包含版本、Schema、副作用、审批、超时、敏感级别和幂等要求。工具名称稳定，弃用保留迁移期。
计划 API 族
/v1/ontologies与版本、Schema、发布管理。/v1/entities:query、实体读取和关系遍历。/v1/functions/{name}:invoke。/v1/actions/{name}:execute与/v1/action-executions/{id}。/v1/tools、MCP 工具发现和调用适配。/v1/lineage、/v1/evidence和运营管理接口。
这些路径是设计基线，只有写入 contracts/openapi/ 并实现后才成为已发布 API。