Skip to content

AppKit

AppKit 是 AgentOS 里几乎所有应用接入的起点。
它负责 app bundle 注册、Bearer token 获取,以及事件订阅能力。

它解决什么问题

对于开发者来说,AppKit 主要解决三件事:

  • 标识“当前是谁在接入 AgentOS”
  • 给当前 app 发放访问其他模块所需的 Bearer token
  • 建立 app 级别的 SSE 事件订阅

什么时候你一定会碰到 AppKit

  • 你要注册 app bundle
  • 你要获取 apiKey / Bearer token
  • 你要访问 modelkitagentkitragkitcronkit 等需要鉴权的模块
  • 你要接收 welcomecallApp 等 App 级事件

核心能力

Bundle 注册

注册入口通常是:

  • SDK:sdk.agentos.registerBundle(...)
  • HTTP:POST /appkit/register

注册后会返回:

  • bundleId
  • appGroupId
  • token

其中 token 就是后续访问受保护模块时使用的 Bearer token。

Token 与鉴权

很多开发者第一次接入时最关心的是:apiKey 从哪里来?

在 AgentOS 里,它通常来自 AppKit 注册结果:

  • OpenAI 兼容接入里的 apiKey = registerBundle 返回的 token
  • 直接访问 agentkit / ragkit / cronkit / toolkit 时,也需要这个 Bearer token

SSE 订阅

AppKit 还提供应用级 SSE 订阅,用于接收:

  • welcome
  • callApp
  • 连接状态变化

如果你的应用需要后台通知、宿主协作或系统事件桥接,这部分就很关键。

适合什么场景

  • 任何需要正式注册成 AgentOS app 的客户端
  • 需要统一 token 管理的应用
  • 需要 app 级事件订阅的应用

不适合把它当成什么

AppKit 不是:

  • 聊天模型调用层
  • Agent 编排层
  • RAG 服务层
  • 定时任务层

它更像所有这些能力的“接入入口”。

下一步看什么

  • 如果你要直接调用模型:看 ModelKit
  • 如果你要让平台帮你组 Agent:看 AgentKit
  • 如果你要做知识库:看 RagKit
  • 如果你要做定时任务:看 CronKit