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
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 agentengine_sdk_python-0.8.2.tar.gz.
File metadata
- Download URL: agentengine_sdk_python-0.8.2.tar.gz
- Upload date:
- Size: 4.9 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5dc578265edcdd026b0f6425e228dbf41b8436dc917a1f809fcc647683c24c16
|
|
| MD5 |
3090a29ed52b82ea00be07fb0d9d7a60
|
|
| BLAKE2b-256 |
c2d6fcc1cf2bbe4d4ca4962d7428b97fce5dfbdeab65e3d61800fc24a5b23e08
|
Provenance
The following attestation bundles were made for agentengine_sdk_python-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:
agentengine_sdk_python-0.8.2.tar.gz -
Subject digest:
5dc578265edcdd026b0f6425e228dbf41b8436dc917a1f809fcc647683c24c16 - Sigstore transparency entry: 2601011818
- 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 agentengine_sdk_python-0.8.2-py3-none-any.whl.
File metadata
- Download URL: agentengine_sdk_python-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 |
853e98c027d2578e5f4b2f72e490d94adaa373693ad5f27e373f10c56783dfb7
|
|
| MD5 |
8eedc729f677b996e688bc0a697fb2eb
|
|
| BLAKE2b-256 |
d890dcef6d74bda33adddf182b98e3aa353d6dfb1daafcc86635dd1b0c7b7d22
|
Provenance
The following attestation bundles were made for agentengine_sdk_python-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:
agentengine_sdk_python-0.8.2-py3-none-any.whl -
Subject digest:
853e98c027d2578e5f4b2f72e490d94adaa373693ad5f27e373f10c56783dfb7 - Sigstore transparency entry: 2601012312
- 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:
