Kingsoft Cloud Agent Development Kit
金山云智能体开发套件
构建、部署、调试、观测企业级 AI 智能体的一站式云原生框架。 兼容 Google ADK、LangGraph、LangChain 与 DeepAgents，并支持一键拉起 OpenClaw 和 Hermes 运行时。
30 秒快速体验
python -m venv .venv
source .venv/bin/activate
pip install -U "ksadk[all]"
agentengine init demo-agent -f langgraph
cd demo-agent
agentengine config set OPENAI_API_KEY=your-api-key OPENAI_MODEL_NAME=gpt-4o-mini
agentengine run -i
启动本地调试 Web UI：
agentengine web . --no-open
运行时架构
KsADK 把“框架适配”收敛为稳定的运行时分层，同时保留各框架的原生执行语义：
- 可信内核：统一并发、取消、恢复、状态一致性和运行时安全边界。
- Harness 执行层：负责装配、Activation、生命周期和共用能力注入；一次 Activation 只选择一个 Provider。
- 可插拔 Provider：Codex、KsADK Harness、DSH/Cordis 与 Subagent 在同一 Harness 契约下运行，Provider 保留原生线程、checkpoint 与事件语义。
- 统一事件：
RuntimeEvent(schema_version=2)是存储、回放、API、Studio 与托管界面的事件事实来源；v1 仅作为只读兼容投影。 - 受控插件化：DSH Bundle/Profile 使用固定工具链、不可变来源摘要和失败回滚；Codex 官方插件仍由 Codex App Server 管理。
- 平台资源插件：Studio 可绑定知识库、长期记忆与 Skill Center；Agent Revision 保存资源选择，Build 固化连接引用和插件摘要，Runtime 在 Activation 时按平台授权装配。
- 本地开发闭环：Studio 覆盖创建、构建、调试、评测与本地 Scheduler Lite，并复用独立发布的
@kingsoftcloud/ksadk-web会话组件。
从 运行时架构、AgentKit Local Studio 和插件与自动化开始阅读。版本说明与制品校验信息见 GitHub Releases。
RuntimeEvent schema v2 契约
运行事件主路径固定为 canonical RuntimeEvent(schema_version=2)；能力描述为 RuntimeEventVersions=[1,2]、RuntimeEventDefault=2、RuntimeEventV1ProjectionModes=["snapshot_only","identity_replace"]、RuntimeEventV1ProjectionDefault="snapshot_only"。v1 仅作只读兼容投影。
为什么需要 KsADK
大多数 Agent 框架解决“如何开发 Agent”。KsADK 解决“如何运行、调试、部署和观测 Agent”。
- 本地开发：
agentengine init、agentengine run、agentengine web。 - 统一调试：浏览器 Web UI、streaming、附件、workspace 文件、工具调用和会话。
- 统一协议：本地
/v1/responses与/v1/chat/completions。 - 工具边界：Skill Runtime、Workspace、Sandbox、Memory、Knowledge。
- 工程链路：打包、部署、OpenClaw / Hermes 运行时、OpenTelemetry 可观测。
架构
Agent Kernel 收口可信控制，Harness 管理装配与生命周期，可插拔 Provider 保留框架原生执行语义；RuntimeEvent v2 为 API、Studio 与托管界面提供统一事件事实链。
文档与样例
- 文档：https://kingsoftcloud.github.io/ksadk-python/
- 快速开始：https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/getting-started/quickstart/
- 为什么需要 KsADK：https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/getting-started/why-ksadk/
- 架构：https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/getting-started/architecture/
- 生态定位对比：https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/getting-started/comparison/
- 可观测：https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/guides/observability-tracing/
- 云端部署：https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/guides/cloud-deployment/
- Hosted UI 与事件回放：https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/guides/hosted-ui-events/
- 环境变量：https://kingsoftcloud.github.io/ksadk-python/cn/docs/references/environment-variables/
- 样例仓库：https://github.com/kingsoftcloud/ksadk-samples
相关项目
- KsADK 仓库：https://github.com/kingsoftcloud/ksadk-python
- Web UI 仓库：https://github.com/kingsoftcloud/ksadk-web
- PyPI：https://pypi.org/project/ksadk/
参与贡献
欢迎通过 issue、PR、样例和文档改进参与贡献。提交前建议运行：
make public-preflight
开源协议：Apache-2.0。
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ksadk-0.8.4.tar.gz.
File metadata
- Download URL: ksadk-0.8.4.tar.gz
- Upload date:
- Size: 7.7 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2c463b0b640c015216a0558be147c4a566b186278b766ae6626b7deff9276893
|
|
| MD5 |
4e1eb73795ab076088fe42c66f5f637b
|
|
| BLAKE2b-256 |
f57b7e6f4966db07b92d851bddef3f56222ef63b02fd63c4195912caab0124be
|
Provenance
The following attestation bundles were made for ksadk-0.8.4.tar.gz:
Publisher:
publish-pypi.yml on kingsoftcloud/ksadk-python
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ksadk-0.8.4.tar.gz -
Subject digest:
2c463b0b640c015216a0558be147c4a566b186278b766ae6626b7deff9276893 - Sigstore transparency entry: 2764870394
- Sigstore integration time:
-
Permalink:
kingsoftcloud/ksadk-python@8e37106d1faed44c2de8b7f72a0d8cd2f1fbddd5 -
Branch / Tag:
refs/tags/v0.8.4 - Owner: https://github.com/kingsoftcloud
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@8e37106d1faed44c2de8b7f72a0d8cd2f1fbddd5 -
Trigger Event:
release
-
Statement type:
File details
Details for the file ksadk-0.8.4-py3-none-any.whl.
File metadata
- Download URL: ksadk-0.8.4-py3-none-any.whl
- Upload date:
- Size: 8.1 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
729871989772dd8c60968973e10040d085b8b309abc95758b475f970356e549f
|
|
| MD5 |
a31c1d8239cad49f91a54609ead7b60b
|
|
| BLAKE2b-256 |
135333baa2569619186df70f886bd675f8caa30d76646de059e4833ba3688076
|
Provenance
The following attestation bundles were made for ksadk-0.8.4-py3-none-any.whl:
Publisher:
publish-pypi.yml on kingsoftcloud/ksadk-python
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ksadk-0.8.4-py3-none-any.whl -
Subject digest:
729871989772dd8c60968973e10040d085b8b309abc95758b475f970356e549f - Sigstore transparency entry: 2764870415
- Sigstore integration time:
-
Permalink:
kingsoftcloud/ksadk-python@8e37106d1faed44c2de8b7f72a0d8cd2f1fbddd5 -
Branch / Tag:
refs/tags/v0.8.4 - Owner: https://github.com/kingsoftcloud
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@8e37106d1faed44c2de8b7f72a0d8cd2f1fbddd5 -
Trigger Event:
release
-
Statement type:
