开发文档 · API 与协议参考

Interfaces Protocol

AG-UI、Channels、A2A 与 MCP 等外部协议的适配职责和限制。

成熟度:Experimental

Interfaces Protocol 约束外部生态协议和 Fellow 内部协议之间的 adapter。它负责能力映射、版本声明和错误保真,不拥有 Thread、Run、Object 或外部业务系统的领域真相。

当前可用

AG-UI 映射、Channels 及其他边界集成已有局部实现;MCP 可作为工具互操作边界。当前还没有覆盖所有 adapter 的统一一致性层,不同适配器的能力与限制必须分别确认。

信任边界

  • 外部 payload、事件和对端身份都视为不可信输入。
  • adapter 必须在入口执行认证、校验和映射,不能通过字段转换绕过内部授权。
  • 删除或升级 adapter 不应迁移核心领域数据。
  • 映射错误时应保留 Fellow 稳定错误码和因果信息,不能只留下外部协议文案。

版本边界

Fellow StreamEvent SSE 是 Interaction 当前原生 wire,AG-UI 是映射目标,不取代原生事件权威。adapter 必须显式声明支持的外部与内部版本;不支持时快速失败,不能静默猜测转换。

当前不包含

Interfaces 不实现 Connector 的业务凭证管理,不把 MCP 变成 Object / Control 协议,也不要求 AIOS 核心依赖某个外部生态协议。Experimental 表示映射和能力声明仍可能破坏性调整。

相关文档