Skip to main content

Kingsoft Cloud Agent Development Kit

新版本要求 Python 3.12 或以上;已有 Agent 可保留原 SDK 和运行镜像,旧 Runtime 的会话读取与订阅协议继续兼容。

金山云智能体开发套件

构建、部署、调试、观测企业级 AI 智能体的一站式云原生框架。 兼容 Google ADK、LangGraph、LangChain 与 DeepAgents,并支持一键拉起 OpenClaw 和 Hermes 运行时。

简体中文(默认) · English

Docs PyPI License Ask DeepWiki

KsADK AgentKit Studio 真实 Agent 工作区

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.7:能力与接入

0.8.7 要求 Python 3.12+,内置 Web companion 为 0.3.18。 下表介绍本版本能力;安装前核对 GitHub Release 与两个 PyPI 发行包的版本。

能力 如何接入
AG-UI / A2UI 安装 agui extra,在自有图中接入结构化输入、业务 Schema 与持久化 checkpoint。
OAuth MCP / API Key MCP OAuth 使用 McpOAuthTools 与本地 Web/托管 Broker;原 API Key 客户端继续使用。
A2A 绑定 Space、注册 callee,再通过发现工具调用;注册与 Gateway 属于配套平台。
会话与恢复 分别配置 Session 和框架 checkpoint;托管模式显式请求 Kernel 准入。

详见功能接入与配置、 AG-UI/A2UI 示例、 OAuth MCP 和 A2A。 模型生成的 A2UI 仍需通过注册目录校验,复杂样式可能失败;不把生成失败包装为业务成功。

运行时架构

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 内置官方 Channel UI;本地和高代码 Agent 可通过 ksadk.connector 出站 WSS 接入独立 Channel 服务,不需要开放本地端口或安装 agentengine-channel。
  • 本地开发闭环:Studio 覆盖创建、构建、调试、评测与本地 Scheduler Lite,并复用独立发布的 @kingsoftcloud/ksadk-web 会话组件。

从 运行时架构、AgentKit Local Studio、Channel Connector 和插件与自动化开始阅读。版本说明与制品校验信息见 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 Studio 知识库、记忆库与 Skill Center 真实绑定界面

KsADK Studio Agent、资源绑定与插件页真实演示

为什么需要 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 可观测。

架构

KsADK 总体技术架构

Agent Kernel 收口可信控制,Harness 管理装配与生命周期,可插拔 Provider 保留框架原生执行语义;RuntimeEvent v2 为 API、Studio 与托管界面提供统一事件事实链。

文档与样例

相关项目

参与贡献

欢迎通过 issue、PR、样例和文档改进参与贡献。提交前建议运行:

make public-preflight

开源协议:Apache-2.0。

Metadata

Release files for agentengine-sdk-python 0.8.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agentengine-sdk-python 0.8.7
File Size Uploaded Provenance Actions
agentengine_sdk_python-0.8.7.tar.gz 10.4 MB With provenance Details for agentengine_sdk_python-0.8.7.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for agentengine-sdk-python 0.8.7
File Interpreter ABI Platform Actions
agentengine_sdk_python-0.8.7-py3-none-any.whl Python 3 none any Details for agentengine_sdk_python-0.8.7-py3-none-any.whl

Total release size: 21.8 MB

Release files / agentengine_sdk_python-0.8.7.tar.gz

Download URL agentengine_sdk_python-0.8.7.tar.gz
Size 10.4 MB
Tags Source
SHA-256 checksum
How to use checksums
a5995b5847a4b00f9f92ae3f0805574a33994301cc9a974bd25bf94afb6902cd
BLAKE2b-256 checksum
How to use checksums
20a95037deeef43ec8464be5b1eb020b1a3683c95cf93275547c0bcda8010596
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

Release files / agentengine_sdk_python-0.8.7-py3-none-any.whl

Download URL agentengine_sdk_python-0.8.7-py3-none-any.whl
Size 11.3 MB
Tags Python 3
SHA-256 checksum
How to use checksums
00a9a2360c1b3fbeb83c063c3453b9b094d239f4d851a9f1d39fe4ac1c594105
BLAKE2b-256 checksum
How to use checksums
429e24c4922b811f5e4477d8cd6772c0d17be4cfe7f96624ad65db73bc73e8be
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

Security for agentengine-sdk-python 0.8.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for agentengine_sdk_python-0.8.7.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page