Kingsoft Cloud Agent Development Kit

金山云智能体开发套件

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

简体中文（默认） · English

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.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。

迁移与环境变量示例见可观测指南和环境变量参考。

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