Back to packageRELEASE DETAILS

0.8.6

PyPI

agentengine-sdk-python

Kingsoft Cloud Agent Engine SDK alias package for ksadk

Published15 Oct 2026

Direct dependencies76

Transitive dependenciesNot calculated

README

Version 0.8.6 documentation

Kingsoft Cloud Agent Development Kit

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

金山云智能体开发套件

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

简体中文（默认） · English

30 秒快速体验

python -m venv .venv
source .venv/bin/activate
pip install -U "ksadk[langgraph]"

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

示例按需安装 LangGraph extra；只使用 Native Studio 可以安装 ksadk。ksadk[all] 还会安装其他可选框架与开发工具。

启动本地调试 Web UI：

agentengine web . --no-open

升级前请查看文档站的快速开始与升级说明；本地 Studio 默认使用 Native Harness 和持久化执行账本。

运行时架构

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

大多数 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

参与贡献

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

make public-preflight

开源协议：Apache-2.0。

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 85

Native requirements

76 direct targetsNot calculated transitive count

Package / target	Requirement	Relationship
click Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`click>=8.0.0`	runtime
pyyaml Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`pyyaml>=6.0.0`	runtime
packaging Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`packaging>=23.0`	runtime
tomli Environment { "extras": "", "marker": "python_version < \"3.11\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`tomli>=2.0.0; python_version < "3.11"`	runtime
python-dotenv Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`python-dotenv>=1.0.0`	runtime
pydantic Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`pydantic<3.0.0,>=2.0.0`	runtime
jsonschema Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`jsonschema<5.0.0,>=4.0.0`	runtime
rfc8785 Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`rfc8785==0.1.4`	runtime
questionary Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`questionary>=2.0.0`	runtime
prompt_toolkit Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`prompt_toolkit>=3.0.0`	runtime
rich Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`rich>=13.0.0`	runtime
fastapi Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`fastapi<1.0.0,>=0.100.0`	runtime
uvicorn Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`uvicorn>=0.23.0`	runtime
python-multipart Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`python-multipart<1.0.0,>=0.0.9`	runtime
python-socks Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`python-socks<3.0.0,>=2.7.1`	runtime
httpx Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`httpx<0.29.0,>=0.28.1`	runtime
httpcore Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`httpcore<1.1.0,>=1.0.9`	runtime
a2a-sdk Environment { "extras": "fastapi", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`a2a-sdk[fastapi]==1.1.0`	runtime
a2ui-core Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`a2ui-core==0.1.1`	runtime
httpx-sse Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`httpx-sse>=0.4.0`	runtime
sse-starlette Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`sse-starlette>=2.1.0`	runtime
mcp Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`mcp<2.0.0,>=1.26.0`	runtime
requests Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`requests>=2.28.0`	runtime
requests-aws4auth Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`requests-aws4auth>=1.2.0`	runtime
kingsoftcloud-sdk-python Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`kingsoftcloud-sdk-python>=1.5.8.94`	runtime
cryptography Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`cryptography>=44.0.0`	runtime
websockets Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`websockets<16.0,>=12.0`	runtime
qrcode Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`qrcode>=7.4.0`	runtime
asyncpg Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`asyncpg<1.0.0,>=0.30.0`	runtime
greenlet Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`greenlet>=1.0.0`	runtime
ks3sdk Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`ks3sdk>=1.15.0`	runtime
pypdf Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`pypdf>=6.0.0`	runtime
beautifulsoup4 Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`beautifulsoup4>=4.12.0`	runtime
rapidocr-onnxruntime Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`rapidocr-onnxruntime>=1.2.0`	runtime
pillow Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`pillow<13.0.0,>=11.0.0`	runtime
google-adk Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`google-adk<3.0.0,>=1.34.0`	runtime
langgraph Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`langgraph<1.3.0,>=1.2.0`	runtime
langgraph-checkpoint-sqlite Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`langgraph-checkpoint-sqlite>=2.0.0`	runtime
opentelemetry-api Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`opentelemetry-api<=1.41.1,>=1.39.0`	runtime
opentelemetry-sdk Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`opentelemetry-sdk<=1.41.1,>=1.39.0`	runtime
opentelemetry-exporter-otlp Environment { "extras": "", "marker": null, "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`opentelemetry-exporter-otlp<=1.41.1,>=1.39.0`	runtime
litellm Environment { "extras": "", "marker": "(platform_system != \"Windows\" or python_version < \"3.13\") and extra == \"adk\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`litellm>=1.0.0; (platform_system != "Windows" or python_version < "3.13") and extra == "adk"`	runtime
json_repair Environment { "extras": "", "marker": "extra == \"adk\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`json_repair>=0.25.0; extra == "adk"`	runtime
langchain Environment { "extras": "", "marker": "extra == \"langchain\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`langchain<2.0.0,>=1.3.14; extra == "langchain"`	runtime
langchain-openai Environment { "extras": "", "marker": "extra == \"langchain\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`langchain-openai<2.0.0,>=1.4.0; extra == "langchain"`	runtime
langchain-core Environment { "extras": "", "marker": "extra == \"langchain\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`langchain-core<2.0.0,>=1.5.0; extra == "langchain"`	runtime
langgraph Environment { "extras": "", "marker": "extra == \"langgraph\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`langgraph<1.3.0,>=1.2.0; extra == "langgraph"`	runtime
langgraph-checkpoint-sqlite Environment { "extras": "", "marker": "extra == \"langgraph\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`langgraph-checkpoint-sqlite>=2.0.0; extra == "langgraph"`	runtime
langgraph-checkpoint-postgres Environment { "extras": "", "marker": "extra == \"langgraph\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`langgraph-checkpoint-postgres>=3.1.0; extra == "langgraph"`	runtime
psycopg Environment { "extras": "binary", "marker": "extra == \"langgraph\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`psycopg[binary]<4.0,>=3.2; extra == "langgraph"`	runtime
psycopg-pool Environment { "extras": "", "marker": "extra == \"langgraph\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`psycopg-pool<4.0,>=3.2; extra == "langgraph"`	runtime
langchain Environment { "extras": "", "marker": "extra == \"langgraph\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`langchain<2.0.0,>=1.3.14; extra == "langgraph"`	runtime
langchain-openai Environment { "extras": "", "marker": "extra == \"langgraph\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`langchain-openai<2.0.0,>=1.4.0; extra == "langgraph"`	runtime
protobuf Environment { "extras": "", "marker": "extra == \"langgraph\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`protobuf>=6.32.1; extra == "langgraph"`	runtime
deepagents Environment { "extras": "", "marker": "python_version >= \"3.11\" and extra == \"deepagents\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`deepagents<1.0.0,>=0.6.2; python_version >= "3.11" and extra == "deepagents"`	runtime
langgraph Environment { "extras": "", "marker": "extra == \"deepagents\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`langgraph<1.3.0,>=1.2.0; extra == "deepagents"`	runtime
langchain Environment { "extras": "", "marker": "extra == \"deepagents\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`langchain<2.0.0,>=1.3.14; extra == "deepagents"`	runtime
langchain-openai Environment { "extras": "", "marker": "extra == \"deepagents\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`langchain-openai<2.0.0,>=1.4.0; extra == "deepagents"`	runtime
a2a-sdk Environment { "extras": "fastapi", "marker": "extra == \"a2a\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`a2a-sdk[fastapi]==1.1.0; extra == "a2a"`	runtime
SQLAlchemy Environment { "extras": "asyncio", "marker": "extra == \"a2a\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`SQLAlchemy[asyncio]<3.0.0,>=2.0.0; extra == "a2a"`	runtime
aiosqlite Environment { "extras": "", "marker": "extra == \"a2a\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`aiosqlite<1.0.0,>=0.20.0; extra == "a2a"`	runtime
a2a-sdk Environment { "extras": "postgresql", "marker": "extra == \"a2a-postgres\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`a2a-sdk[postgresql]==1.1.0; extra == "a2a-postgres"`	runtime
openinference-instrumentation-langchain Environment { "extras": "", "marker": "extra == \"tracing\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`openinference-instrumentation-langchain>=0.1.0; extra == "tracing"`	runtime
deepeval Environment { "extras": "", "marker": "extra == \"judge\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`deepeval>=3.2.6; extra == "judge"`	runtime
e2b Environment { "extras": "", "marker": "extra == \"skills\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`e2b<2.25.0,>=2.15.3; extra == "skills"`	runtime
openai-codex Environment { "extras": "", "marker": "extra == \"codex\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`openai-codex==0.154.0; extra == "codex"`	runtime
ag-ui-protocol Environment { "extras": "", "marker": "extra == \"agui\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`ag-ui-protocol==0.1.19; extra == "agui"`	runtime
ag-ui-langgraph Environment { "extras": "fastapi", "marker": "extra == \"agui\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`ag-ui-langgraph[fastapi]==0.0.42; extra == "agui"`	runtime
copilotkit Environment { "extras": "", "marker": "extra == \"agui\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`copilotkit==0.1.94; extra == "agui"`	runtime
pytest Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`pytest>=7.0.0; extra == "dev"`	runtime
pytest-asyncio Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`pytest-asyncio>=0.21.0; extra == "dev"`	runtime
pytest-xdist Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`pytest-xdist>=3.0.0; extra == "dev"`	runtime
fastmcp Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`fastmcp>=2.0.0; extra == "dev"`	runtime
build Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`build>=1.0.0; extra == "dev"`	runtime
twine Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`twine>=5.0.0; extra == "dev"`	runtime
black Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`black>=22.0.0; extra == "dev"`	runtime
ruff Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`ruff>=0.1.0; extra == "dev"`	runtime
mypy Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`mypy>=1.0.0; extra == "dev"`	runtime
types-PyYAML Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`types-PyYAML>=6.0.0; extra == "dev"`	runtime
types-protobuf Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`types-protobuf>=6.32.0; extra == "dev"`	runtime
types-python-dateutil Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`types-python-dateutil>=2.9.0; extra == "dev"`	runtime
types-qrcode Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`types-qrcode>=8.2.0; extra == "dev"`	runtime
types-requests Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`types-requests>=2.32.0; extra == "dev"`	runtime
playwright Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`playwright>=1.50.0; extra == "dev"`	runtime
agentengine-sdk-python Environment { "extras": "a2a,adk,agui,codex,deepagents,dev,judge,kb,langchain,langgraph,skills,tracing", "marker": "extra == \"all\"", "requires_python": ">=3.12", "evaluation": "NOT_EVALUATED" }	`agentengine-sdk-python[a2a,adk,agui,codex,deepagents,dev,judge,kb,langchain,langgraph,skills,tracing]; extra == "all"`	runtime

Distribution files

2 collected

agentengine_sdk_python-0.8.6-py3-none-any.whl

bdist_wheel · 9,947.65 KB · Python py3

Source file

agentengine_sdk_python-0.8.6.tar.gz

sdist · 9,137.46 KB · Python source

Source file

Repository

PENDING

kingsoftcloud/ksadk-python

Shared repository data · GitHub

License detected in repository: Not collected

Metadata history

Meaningful changes

Current collected state Current

Observed since 20 Oct, 21:50 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:d44055dadfb4e5fbd312d05bcfbeec78e7f08578f344b1c99c3c873a995abb6d

Other collected versions

View all collected versions →