AppKit
AppKit 是 AgentOS 里几乎所有应用接入的起点。
它负责 app bundle 注册、Bearer token 获取,以及事件订阅能力。
它解决什么问题
对于开发者来说,AppKit 主要解决三件事:
- 标识“当前是谁在接入 AgentOS”
- 给当前 app 发放访问其他模块所需的 Bearer token
- 建立 app 级别的 SSE 事件订阅
什么时候你一定会碰到 AppKit
- 你要注册 app bundle
- 你要获取
apiKey/ Bearer token - 你要访问
modelkit、agentkit、ragkit、cronkit等需要鉴权的模块 - 你要接收
welcome、callApp等 App 级事件
核心能力
Bundle 注册
注册入口通常是:
- SDK:
sdk.agentos.registerBundle(...) - HTTP:
POST /appkit/register
注册后会返回:
bundleIdappGroupIdtoken
其中 token 就是后续访问受保护模块时使用的 Bearer token。
Token 与鉴权
很多开发者第一次接入时最关心的是:apiKey 从哪里来?
在 AgentOS 里,它通常来自 AppKit 注册结果:
- OpenAI 兼容接入里的
apiKey=registerBundle返回的token - 直接访问
agentkit/ragkit/cronkit/toolkit时,也需要这个 Bearer token
SSE 订阅
AppKit 还提供应用级 SSE 订阅,用于接收:
welcomecallApp- 连接状态变化
如果你的应用需要后台通知、宿主协作或系统事件桥接,这部分就很关键。
适合什么场景
- 任何需要正式注册成 AgentOS app 的客户端
- 需要统一 token 管理的应用
- 需要 app 级事件订阅的应用
不适合把它当成什么
AppKit 不是:
- 聊天模型调用层
- Agent 编排层
- RAG 服务层
- 定时任务层
它更像所有这些能力的“接入入口”。
