全部文档
当前文档
最近更新时间：2026-04-29 10:47:27
AgentEngine CLI是一个专用于Agent全生命周期管理的命令行工具，包括Agent项目的初始化、配置、构建、部署跟运维。
AgentEngine CLI可用于Linux、MAC、Windows等系统。请确保您的系统已经安装Python，且Python版本不低于3.12；
已安装KsADK（金山云Agent开发工具包），安装详情详见下述操作步骤；
已开通AgentEngin服务权限（KsyunAgentEngineDefaultRole）。
KingSoft Cloud Agent Development Kit（KsADK）别名AgentEngine SDK，安装方式可任其中选一种。
# 第一次安装
pip install ksadk
# 更新安装
pip install -U ksadk安装完成后，可以通过agentengine命令查看是否安装成功。
# 查看AgentEngine安装版本
agentengine --version
# 查看AgentEngine可用操作
agentengine -h展示如下，则表示安装成功：
安装完KsADK之后，可以在本地电脑的任意目录下，使用AgentEngine CLI初始化Agent项目。
# 创建Agent项目
agentengine init创建Agent项目并选择开发Agent要使用的开发框架进行初始化。
进入初始化创建的Agent目录下，执行配置操作。
# 进入Agent项目文件夹
cd {Agent项目名称}
进行交互式配置
agentengine config配置内容包括基础配置、模型配置（若使用星流模型API，URL可不填）、金山云凭证配置等，配置完成后可选择是否更新全局配置。所配置环境变量信息可以通过在当前Agent项目文件夹下的.env文件查看或修改。
开发过程中，可以通过以下命令进行本地调试。
# 终端命令行中调用Agent调试
agentengine run -i
# 通过Web界面调试Agent
agentengine webAgent开发完成与本地调试完成后，可进行云端构建，自动将Agent代码打包上传至KS3或镜像仓库。
# 默认通过代码包方式构建，将代码包上传至KS3
agentengine build --push
# 重新构建可通过清理缓存的方式重新推送
agentengine build --push --no-cache代码包构建完后，可进行一键部署Agent，默认使用Code方式部署。
# 默认使用Code方式一键部署Agent
agentengine deploy
# 一键构建与部署，省下先build再deploy的流程
agentengine launchAgent部署成功后，可通过命令行查询与调用Agent。
# 查询Agent状态
agentengine status --agent {AgentID}
# 调用Agent
agentengine invoke --agent {AgentID}部署完成Agent之后可以通过可观测性界面，查看Agent的会话、Trace链路、Observation环节等详情。
纯净模式