ksadk 0.6.5

KsADK Agent Runtime Platform - unified runtime, debugging, deployment and observability for AI agents

KsADK

一次构建 Agent，到处运行。Build agents once. Run them anywhere.

KsADK 是面向 AI Agent 的运行时平台（Agent Runtime Platform）。 继续使用 Google ADK、LangGraph、LangChain 或 DeepAgents 编写业务 Agent，再用统一 CLI、Web UI、OpenAI-Compatible API、工具运行时、沙箱、部署和可观测链路把它跑起来。

简体中文（默认） · 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

如果需要调用金山云 AgentEngine、Skill Service、知识库或长期记忆等线上能力，建议显式设置线上默认地域：

agentengine config set KSYUN_REGION=cn-beijing-6

启动本地调试 Web UI：

agentengine web . --no-open

为什么需要 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。
• 工程链路：打包、部署、OpenTelemetry 可观测。

架构

文档与样例

• 文档：https://kingsoftcloud.github.io/ksadk-python/
• 快速开始：https://kingsoftcloud.github.io/ksadk-python/getting-started/quickstart/
• 为什么需要 KsADK：https://kingsoftcloud.github.io/ksadk-python/getting-started/why-ksadk/
• 架构：https://kingsoftcloud.github.io/ksadk-python/getting-started/architecture/
• 生态定位对比：https://kingsoftcloud.github.io/ksadk-python/getting-started/comparison/
• 可观测：https://kingsoftcloud.github.io/ksadk-python/guides/observability-tracing/
• 样例仓库：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。