ksadk 0.6.1

Kingsoft Cloud Agent Development Kit - 支持 LangChain/LangGraph/DeepAgents/ADK/OpenClaw/Hermes 的本地运行与云端部署

ksadk

简体中文 | English

金山云 Agent Development Kit。ksadk 提供 Python SDK 和 agentengine 命令行，用于创建、运行、调试、打包和部署 AgentEngine 智能体项目。它面向 本地开发、Serverless 运行时、Google ADK、LangChain/LangGraph、 DeepAgents、Hermes、OpenClaw、MCP 和 Skill Runtime 等场景。

当前版本：0.6.1。

安装

pip install -U ksadk

按需安装可选运行时依赖：

pip install -U "ksadk[adk]"
pip install -U "ksadk[langgraph]"
pip install -U "ksadk[deepagents]"
pip install -U "ksadk[skills]"
pip install -U "ksadk[all]"

快速开始

创建并运行一个本地 Agent：

agentengine init my-agent -f langgraph
cd my-agent
agentengine config
agentengine run -i

打开本地 Web UI：

agentengine web . --no-open

如需走部署形态，先使用 dry-run 或内部审核流程确认配置：

agentengine launch . --target serverless

包含能力

• 本地开发命令：init、config、run、web
• 构建与部署命令：build、deploy、launch
• 远程操作：agent invoke、files、dashboard
• 运行时集成：ADK、LangChain、LangGraph、DeepAgents、MCP
• 托管运行时资产：Hermes 和 OpenClaw
• Skill Runtime 预览：Skill Center 发现、zip 下载、sha256 校验、安全解压、本地执行和通过 ksadk[skills] 启用的沙箱执行
• Sandbox Runtime 预览：通用沙箱抽象与 E2B 兼容后端

0.6.1 重点

• /v1/responses 和 /v1/chat/completions 在外部保持独立协议，Runner 内部接收统一的 Responses 风格输入。
• Hosted UI 与本地 agentengine web 使用 Responses input_image / input_file 发送图片和文件，同时兼容旧的 inlineData / fileData。
• 浏览器刷新或 SSE 断开后，流式运行可以在后台继续，UI 可以重新订阅同一个 invocation。
• 未配置 STM 时，LangGraph、LangChain、DeepAgents 和 ADK 的本地 Web 会话默认使用项目内 sqlite 存储。
• 工作区预览自动刷新时保留当前预览/编辑模式。
• 默认运行时使用 Hermes 2026.5.16-ksadk-v1 和 OpenClaw 2026.5.22。

文档

公开文档托管在 GitHub Pages，并使用 MkDocs Material 与双语 i18n 方案：

• 中文文档
• English documentation
• 快速开始
• 配置项
• 命令行参考
• OpenAI 兼容 API
• 贡献指南
• 安全策略

项目链接

• 文档：https://kingsoftcloud.github.io/ksadk-python/
• 仓库：https://github.com/kingsoftcloud/ksadk-python
• Web UI 仓库：https://github.com/kingsoftcloud/ksadk-web
• PyPI：https://pypi.org/project/ksadk/
• 开源协议：Apache-2.0

说明

• Skill 注册、CRUD 和版本治理属于 Skill Service；ksadk 在运行时消费 Skill Center。
• Sandbox 模板和实例生命周期属于 Sandbox Service；ksadk 使用配置的沙箱后端执行运行时工作流。
• E2B 兼容沙箱后端使用原生 E2B_API_URL 和 E2B_API_KEY 环境变量。