全部文档
当前文档
最近更新时间：2026-05-20 16:38:13
AgentEngine CLI 是一个专用于 Agent 全生命周期管理的命令行工具，覆盖 Agent 项目的初始化、配置、构建、部署与运维。
AgentEngine CLI 可用于 Linux、MAC、Windows 等系统。请确保您的系统已经安装 Python，且 Python 版本不低于 3.12；
已安装 KsADK（金山云 Agent 开发工具包），安装详情详见下述操作步骤；
KingSoft Cloud Agent Development Kit（KsADK），别名 AgentEngine SDK，安装方式可任选其中一种：
第一次安装，执行以下命令：
pip install ksadk更新安装，执行以下命令：
pip install -U ksadk安装完成后，可以通过 agentengine 命令查看是否安装成功：
查看 AgentEngine 安装版本：
agentengine --version查看 AgentEngine 可用操作：
agentengine -h展示如下，则表示安装成功：
安装完 KsADK 后，可以在本地电脑的任意目录下，使用如下命令，新建Agent项目。
agentengine init根据提示，输入项目名称。
按动键盘上下键，选择开发框架，并按Enter键进行确认。目前支持langgraph、langchain、deepagents、adk、openclaw或hermes。
根据系统提示，进入初始化创建的 Agent 目录下。
cd <Agent 项目名称>执行如下命令，进入交互配置页面。
agentengine config根据系统提示，依次完成以下配置。
参数 | 是否必须 | 说明 |
|---|---|---|
基础配置 | 是 |
|
模型配置 | 是 |
|
金山云配置 | 否 |
|
容器镜像配置 | 否 |
|
配置完成后可选择是否更新全局配置。所配置环境变量信息可以通过在当前 Agent 项目文件夹下的 .env 文件查看或修改。
开发过程中，若使用的是 anggraph、langchain、deepagents、adk 开发框架，则可以通过以下命令进行本地调试：
终端命令行中调用 Agent 调试：
agentengine run -i通过 Web 界面调试 Agent：
agentengine webAgent 开发完成与本地调试完成后，可进行云端构建，自动将 Agent 代码打包上传至 KS3 或镜像仓库。
执行如下命令，默认通过代码包方式构建，将代码包上传至 KS3。系统将自动创建相应存储空间。
agentengine build --push若需重新构建，可执行如下命令，通过清理缓存的方式重新推送。
agentengine build --push --no-cache执行如下操作，一键部署 Agent，默认使用 Code 方式部署。
agentengine deploy您也可直接执行如下命令，一键构建与部署，省下先 build 再 deploy 的流程：
agentengine launchAgent 部署成功后，可通过命令行查询与调用 Agent。
查询 Agent 状态：
agentengine status --agent <Agent名称>调用 Agent：
agentengine invoke --agent <Agent名称>部署完成 Agent 之后可以通过可观测性界面，查看 Agent 的会话、Trace 链路、Observation 环节等详情。
纯净模式