全部文档
当前文档
最近更新时间：2026-07-27 15:41:12
本文介绍如何使用 KSADK、AgentEngine CLI 和星源 AgentKit 完成智能体开发、部署、调试与观测，帮助您了解构建和管理智能体的完整流程。
星源 AgentKit 是面向智能体开发和运行的云平台，为智能体提供运行时托管以及知识库、记忆库、MCP、沙箱、Skills、在线调试和可观测等平台能力。
KSADK（Kingsoft Cloud Agent Development Kit）是星源 AgentKit 的开发套件。它兼容 LangGraph、LangChain、Google ADK、DeepAgents 等开发框架，并提供 AgentEngine CLI，帮助开发者完成项目初始化、本地运行、调试、构建和部署。对于 OpenClaw、Hermes 等智能体形态，也可以通过统一的运行时能力进行部署和管理。
二者的分工可以概括为：
KSADK 负责将不同框架编写的 Agent 接入统一的开发、运行和部署协议。
AgentEngine CLI 负责初始化项目、本地调试、构建制品以及发起部署。
星源 AgentKit 控制台负责管理运行时和云上组件，并提供在线调试与可观测能力。
从开发到云端运行，智能体通常需要经过以下四个阶段。
从官方样例、空项目或已有 Agent 获取项目，选择开发框架或 Agent 形态，配置模型、金山云身份和平台组件，并在本地完成运行与调试。
使用 AgentEngine CLI 一键执行 agentengine launch .，或按需分步执行 agentengine build . --push 和 agentengine deploy .，将代码包或容器镜像部署至 AgentEngine 运行时。
先在控制台或通过 agentengine agent status 确认运行时达到 RUNNING · 1/1 Ready 且 Endpoint 已生成，再进行控制台在线调试或 CLI 调用。
在控制台持续查看运行时监控、会话、Trace、日志、评测和资源用量，分析智能体的运行质量。
通过 KSADK 快速部署智能体
适合首次使用 KSADK 的开发者。通过官方知识库问答示例了解项目结构、本地调试、构建制品和控制台部署的最短路径。具体操作参见《入门指引：快速部署智能体》
通过控制台管理智能体运行时
适合已经取得代码包或镜像，希望通过可视化页面配置网络、身份认证、环境变量和可观测服务的用户。运行时创建完成后，可以继续进行在线调试和运行观测。
开发企业级智能体
适合需要组合知识库、记忆库、MCP、沙箱和 Skills 等多种能力，并关注权限、安全、评测、可观测和生产部署的团队。具体操作参见《进阶入门：智能体开发》。
组件 | 功能说明 |
|---|---|
工具与沙箱 | 为智能体提供文件、代码、命令等工具能力，并在隔离环境中执行高风险任务。Skills 可进一步封装可复用的业务能力。 |
记忆库 | 保存和检索用户偏好、历史事实等跨会话信息，使智能体能够在后续会话中延续上下文。 |
知识库 | 对企业文档进行解析、切片和检索，为智能体提供可追溯的私域知识。 |
MCP | 将外部系统、云服务或存量 API 转换为智能体可发现、可调用的标准工具。 |
KSADK 与 AgentEngine 支持从本地验证到云端运行的完整流程。您可以根据当前阶段选择合适的方式。
部署模式 | 核心优势 | 适用场景 |
|---|---|---|
本地调试（Local） | 使用 | 原型验证、日常开发、问题排查 |
云端运行（Cloud） | 将代码包或容器镜像部署到 AgentEngine 运行时，由平台提供网络、认证、弹性、在线调试和可观测能力。 | 联调、测试及生产环境 |
混合模式（Hybrid） | 在本地开发并验证，通过 AgentEngine CLI 构建和上传制品，再使用 CLI 或控制台完成云端部署与管理。 | 团队协作、持续迭代、企业级交付 |
下一步：如果您希望将一个 KSADK 示例快速部署到云端，请继续阅读《入门指引：快速部署智能体》。
纯净模式
