架构
KsADK 的公开架构是一层 Agent Runtime Platform：业务 Agent 仍由你选择的框架编写，KsADK 统一负责运行、调试、协议、工具、沙箱、部署与观测。
总览
上图展示 KsADK 的三层架构:业务 Agent 框架(用户自带)→ KsADK Runtime 数据面(核心)→ 托管控制面。KsADK 在框架之上补齐运行、调试、协议、工具、沙箱、部署与观测,业务逻辑仍留在你选择的 Agent 框架里。
关键边界
KsADK 只接管"怎么跑"，不接管"做什么"。Agent 的业务逻辑、prompt、domain tools 留在你的框架代码里；运行时、会话、工具协议、部署、观测由 KsADK 统一处理。
核心边界
| 层 | 责任 |
|---|---|
| Agent 框架 | 编排业务逻辑、状态、工具调用和模型交互 |
| KsADK CLI | 创建项目、加载配置、本地运行、Web UI 启动和打包 |
| Runner | 把 ADK、LangGraph、LangChain、DeepAgents 适配到统一调用接口 |
| 本地 Server | 暴露 /v1/responses、/v1/chat/completions 和本地 Web UI API |
| Toolsets | 提供 Skill、Workspace、Platform、Sandbox 等工具入口 |
| AgentEngine / Hermes / OpenClaw | 承接远端运行、部署和更完整的 runtime backend |
| OpenTelemetry | 输出标准 tracing，接入外部观测系统 |
本地运行路径
执行 agentengine run 或 agentengine web 时的处理流程：
- CLI 解析项目目录、
.env和agentengine.yaml。 - 框架检测器识别 ADK、LangGraph、LangChain 或 DeepAgents。
- Runner Factory 创建对应 Runner。
- Runner 加载用户 Agent。
- 本地终端、Web UI 或 OpenAI-Compatible API 调用 Runner。
- 会话、附件、workspace 文件、工具调用和 tracing 由 KsADK 统一处理。
会话、附件、workspace 与 tracing 都走同一条 KsADK 运行时路径——本地与远端行为一致，方便本地调试后无缝迁移到托管 runtime。
为什么这个架构重要
这层边界让团队可以保留各自熟悉的 Agent 框架，同时共享：
- 同一套本地命令。
- 同一套浏览器调试体验。
- 同一套 OpenAI-Compatible API。
- 同一套 Skill / Workspace / Sandbox 工具模型。
- 同一套部署和观测入口。
更详细的内部本地运行时实现见 运行时架构。