# 集成与平台接口

| 文档 | 说明 |
|------|------|
| [agnet-platform-api-design.md](./agnet-platform-api-design.md) | **Agnet 平台**对 Heicode 暴露的 API 设计：身份、RBAC、多租户隔离、编排、运行态、事件流、审计。 |

**Agnet 可视化分工（摘要）**

- **Heicode Manager**：呈现 Agnet 平台回传的 **运行态与性能类字段**（是否在跑、阶段、健康、资源、聚合指标等）。
- **Heicode 客户端**：在编码与会话中 **实时展示 Agnet 平台子 agent 产出**（流式输出等），与 §6.4 / 事件流中的会话侧增量对应。  
团队与个人均可使用两端；划分依据是 **信息类型与载体**，详见集成文档 **§1.1**。

**Manager 一键部署与 SK（摘要）**

- **Heicode Manager** 须支持 **一键部署 Agnet 团队**，并在契约中写清 **团队成员**、**各成员所用模型**、**Agnet 子 agent 绑定的 SK 源（只读）**。
- **SK**：以 **Git 为统一事实源**，并允许 **上传 MD** 等作为补充；对 Agnet 的接口与语义要求见集成文档 **§5.0.1**。SK 正文不经 Agnet/Manager 编辑，详见 **§5.0**、**§3.2**。

**里程碑**（何时落地哪些能力）见 [`../milestones/README.md`](../milestones/README.md)。