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
0.8.2 Agent Runtime V2 Phase 1
- Studio 现已覆盖本地创建、构建、调试以及云端部署、状态、详情、会话、更新、删除和版本回滚；也可以选择账号中由 CLI 部署的高代码 Agent。
- 云端请求由 Studio 本地服务使用 AK/SK 签名并经过 Server 准入，浏览器不持有云凭证；Gateway 不再绕过 Server 直连 Runtime。
- 普通前台对话使用真实 SSE 流；正文、思考、工具与审批可增量渲染。Goal 与 Plan 作为明确的执行控制，Background 只用于需要脱离前台连接的长任务。
- AgentKernelStore 默认允许 InMemory 或 SQLite；PostgreSQL 仅在需要跨 Pod 接管、恢复和高可用时启用。
- 配套 Web UI 固定为
@kingsoftcloud/ksadk-web@0.3.2。
完整操作见 AgentKit Local Studio，详细变更见 CHANGELOG。
0.8.1 可观测性契约
- 远端 trace 统一使用标准 OTLP/HTTP：Langfuse 读取
OTEL_EXPORTER_OTLP_*，CloudMonitor 读取CLOUD_MONITOR_OTLP_*；同一 span 在两端保持相同的trace_id/span_id。 - 托管 Agent 通过 CLI 或控制台创建时默认开启可观测性并由平台注入双路配置；只有显式传入
--no-observability或在控制台关闭才禁用。 LANGFUSE_USE_CALLBACK、Langfuse SDK CallbackHandler/exporter 已移除。CLOUD_MONITOR_APP_KEY只保留一个版本的过渡 fallback，新配置应通过 OTLP headers 提供Ksc-Appkey。- exporter 直接运行在 Agent 进程内，不会额外启动 OpenTelemetry Collector、sidecar、容器或 Pod。
0.8.1 RuntimeEvent schema v2 契约
- 运行事件主路径使用 canonical
RuntimeEvent(schema_version=2)：runtime、协议投影、事件存储、回放与最终输出选择都以 v2 为唯一事实来源。 - v1 事件转为只读兼容投影，不再接受新的 v1 写入；未升级的下游消费者收到终端快照，已升级的消费者可显式选择 identity-aware 的 replace 语义。
- 能力描述：
RuntimeEventVersions=[1,2]、RuntimeEventDefault=2、RuntimeEventV1ProjectionModes=["snapshot_only","identity_replace"]、RuntimeEventV1ProjectionDefault="snapshot_only"。 - 本地 Web UI、Studio 与 Hosted UI 必须使用与本次 Python 发布一致的 identity-aware 版本，才能按 item identity 正确归并流式与回放输出。
为什么需要 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 可观测。
架构
文档与样例
- 文档：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://github.com/kingsoftcloud/ksadk-samples
相关项目
- KsADK 仓库：https://github.com/kingsoftcloud/ksadk-python
- Web UI 仓库：https://github.com/kingsoftcloud/ksadk-web
- Wiki：https://zread.ai/kingsoftcloud/ksadk-python
- 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
ksadk-0.8.2.tar.gz
(5.0 MB
view details)
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
ksadk-0.8.2-py3-none-any.whl
(5.3 MB
view details)
File details
Details for the file ksadk-0.8.2.tar.gz.
File metadata
- Download URL: ksadk-0.8.2.tar.gz
- Upload date:
- Size: 5.0 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f44207c6710797320f166b0de29ffe78606167cf859db937c0ceb1b163d00b68
|
|
| MD5 |
398d72e2649d2b20712a426e93d33a5a
|
|
| BLAKE2b-256 |
7ba348e922bcd5dd6ffa55be6f4a6b174221083cae9cd79c421b9726e3145910
|
Provenance
The following attestation bundles were made for ksadk-0.8.2.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.2.tar.gz -
Subject digest:
f44207c6710797320f166b0de29ffe78606167cf859db937c0ceb1b163d00b68 - Sigstore transparency entry: 2601005292
- Sigstore integration time:
-
Permalink:
kingsoftcloud/ksadk-python@c8c9be629f4cb054ec4d8818cf0596ef42377671 -
Branch / Tag:
refs/tags/v0.8.2 - Owner: https://github.com/kingsoftcloud
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@c8c9be629f4cb054ec4d8818cf0596ef42377671 -
Trigger Event:
release
-
Statement type:
File details
Details for the file ksadk-0.8.2-py3-none-any.whl.
File metadata
- Download URL: ksadk-0.8.2-py3-none-any.whl
- Upload date:
- Size: 5.3 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 |
8fb0b0af0b54204a5972e256c1d7afae56f206a9c430e7d07235587618be40b3
|
|
| MD5 |
8e54733542550885292dc87500ac469c
|
|
| BLAKE2b-256 |
8fe3ee17d34e9ea964fb786c7da196a7dc7fec20bbba8fa7462bcbc90a7d0e3d
|
Provenance
The following attestation bundles were made for ksadk-0.8.2-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.2-py3-none-any.whl -
Subject digest:
8fb0b0af0b54204a5972e256c1d7afae56f206a9c430e7d07235587618be40b3 - Sigstore transparency entry: 2601006166
- Sigstore integration time:
-
Permalink:
kingsoftcloud/ksadk-python@c8c9be629f4cb054ec4d8818cf0596ef42377671 -
Branch / Tag:
refs/tags/v0.8.2 - Owner: https://github.com/kingsoftcloud
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@c8c9be629f4cb054ec4d8818cf0596ef42377671 -
Trigger Event:
release
-
Statement type:
