本文面向通过计算巢以自定义方式部署Agent的用户，说明创建页面各功能模块的作用、配置要点及注意事项，提供完整的部署指引。
自定义创建Agent能做什么
您自行指定应用从哪里来（Git 仓库、OSS 压缩包或容器镜像）、如何启动与停止，并可配置环境变量、百炼模型与 API Key、可选 MCP 与应用工具绑定等。部署完成后可通过 Web 对话页/API调用 等方式使用（基于AgentScope场景）。
可进入计算巢控制台，选择创建Agent。
前提说明
计算巢平台仅提供Agent运行环境，具体Agent代码需由开发者自行编写。
ECS镜像预装 Docker、python3.11、 AgentScope / AgentScope runtime框架，建议基于该框架开发以实现最佳适配（非AgentScope代码同样支持部署）。
记忆、沙箱等连接通过环境变量注入ECS实例，并在代码中显式声明相关变量以实现适配，具体可参考Agent连接使用说明。
WebUI默认后端 baseURL 为 http://${ECS公网IP}:8090/process，若开发者需更换baseURL，可在 WebUI-右上角设置-baseURL 更换。
延伸阅读
AgentScope：负责智能体本身的行为编排。使用
ReActAgent（或自定义 Agent）接入模型、提示词、Memory、Tools 等，把一次对话跑成流式消息。业务逻辑主要写在这里：选什么模型、给什么 sys_prompt、挂哪些工具、要不要会话记忆。AgentScope Runtime：负责把 Agent 封装为可部署的服务。基于
AgentApp（FastAPI）提供标准接口，在@agent_app.query(framework="agentscope")中接收解析好的消息与请求，组装上述 Agent 并管理会话状态，最后以 SSE 流式返回结果。
最小构建路径：新建 Python 项目 → 安装 agentscope 与 agentscope-runtime → 复制 AgentApp + lifespan + query 骨架 → 调整 sys_prompt、工具与会话存储 → 本地跑通后打包为 Docker / ECS / K8s 部署。
可参考官方源码与示例：AgentScope · AgentScope Runtime，后续开发也可参考计算巢 Agent 市场已有示例完成。
部署页参数说明
应用信息
参数 | 说明 |
应用名称 | 当前部署的Agent应用名称，默认即可。 |
分组名称 | 当前部署的Agent应用的分组名称，默认即可。 |
Agent 配置
源文件类型
选择应用来源方式：
Git仓库代码：从 Git 仓库拉取代码并部署
OSS文件：从 OSS 下载压缩包并部署
Docker镜像：使用容器镜像服务中的镜像部署
后续需要填写的参数会随该选项变化。
Git 仓库（当源类型为「Git仓库代码」时）
参数 | 说明 |
平台 | Git 平台，默认github。中国内地 ECS 访问 GitHub 可能不稳定，建议选择GitHub时部署地域选择海外。 |
所有者 | 仓库所有者/账号。 |
组织 | 仓库所属组织（若有）。 |
仓库名称 | Git 仓库名称。 |
代码分支 | 要部署的代码分支。 |
说明：发布时，代码会自动下载到工作目录下的 code_deploy_application 目录，无需在脚本中执行 git clone。该目录会自动创建，若已存在会被覆盖。
OSS（当源类型为「OSS文件」时）
参数 | 说明 |
OSS地域 | OSS Bucket 所在地域，默认与当前地域一致。 |
OSS Bucket | 存储部署包的 OSS Bucket 名称。 |
OSS文件 | 部署包在 Bucket 中的对象路径（文件名或路径）。 |
内网下载 | 是否通过内网下载。若选择内网，部署的 ECS 与 OSS 必须在同一地域。 |
部署过程中，OSS文件会在脚本执行前自动下载至工作目录，无需在脚本中手动实现下载逻辑。文件默认下载至指定路径，若为压缩包格式，需在应用启动脚本中补充解压操作（见工作目录与脚本）。
Docker 镜像（当源类型为「Docker镜像」时）
参数 | 说明 |
容器镜像服务地域 | 镜像所在 ACR 地域。 |
容器镜像服务类型 | 个人版 或 企业版。 |
容器镜像服务实例ID | 仅企业版需填，为 ACR 实例 ID。 |
命名空间 | 仅企业版需填，镜像所在命名空间。 |
仓库名称 | 镜像仓库名称。 |
镜像版本 | 要部署的镜像版本（Tag）。 |
是否通过内网拉取镜像 | 是否使用内网拉取。企业版需完成 配置专有网络的访问控制 且 ECS 与 ACR 在同一 VPC；个人版同地域可直接内网拉取。 |
发布时镜像会在执行脚本前自动拉取到 ECS，脚本中无需执行 docker pull。工作目录与脚本
参数 | 说明 |
工作目录 | 应用启动/停止脚本的执行工作目录，必须为绝对路径（如 /root）。可填尚未存在的目录，执行时会自动创建。默认：/root。 |
应用启动脚本 | 用于启动应用的 Shell 脚本。注意：每次执行启动脚本前会先执行一次应用停止脚本，请确保停止脚本能正确停止当前及历史版本的应用。仅支持 Shell 脚本。 |
应用停止脚本 | 用于停止应用的 Shell 脚本。注意：每次执行停止脚本前会先执行一次应用启动脚本。仅支持 Shell 脚本。 |
不同源类型的默认脚本逻辑可参考模板中的示例（如 Git 下进入 code_deploy_application 执行 python3 main.py，OSS 下解压后执行，Docker 下执行 docker run 等），可按实际需求修改。
部署资源配置
ECS镜像一般为带 Python 3.11 与 AgentScope 运行环境的系统。
参数 | 说明 |
付费类型 | 按量付费 (PostPaid) 或 包年包月 (PrePaid)。 |
购买资源周期 | 包年包月时的周期单位，如Month。 |
购买资源时长 | 包年包月时的时长（1–60 个月等可选值）。 |
实例类型 | ECS 实例规格，默认如ecs.u1-c1m2.large。 |
系统盘类型 | 如 高效云盘、ESSD 等。 |
系统盘空间(GB) | 系统盘容量，范围 20–500 GB，默认 40。 |
公网出带宽最大值(Mbps) | 0–100，0 表示关闭公网。默认 10。 |
网络付费类型 | 按带宽或按流量计费。 |
环境变量配置
参数 | 说明 |
环境变量 | 键值对列表，用于设置应用运行时的环境变量。部分应用依赖环境变量启动或初始化可在此配置。环境变量将会存放到创建的ECS中。 |
网络配置
参数 | 说明 |
可用区 | ECS 所在可用区。 |
选择专有网络 | 新建专有网络 或 已有专有网络。 |
专有网络VPC实例ID | 选择「已有专有网络」时填写。 |
交换机实例ID | 选择「已有专有网络」时填写。 |
专有网络IPv4网段 | 新建 VPC 时填写，如 |
交换机子网网段 | 新建VPC时填写，须为VPC网段的子网，默认 192.168.0.0/24。 |
模型配置
参数 | 说明 |
百炼 API-KEY | 百炼模型服务的 API-KEY。开通与获取方式见 获取百炼 API-KEY。若填写，将自动注入环境变量DASHSCOPE_API_KEY。 |
模型选择 | 使用的模型。若填写，将自动注入环境变量 DASHSCOPE_MODEL_NAME。可选值包括 qwen、deepseek、kimi、MiniMax等系列模型。 |
连接配置
参数 | 说明 |
应用工具 | 绑定应用管理中已创建的工具连接（如会话管理等），绑定结果以环境变量等形式注入运行环境，具体以各工具说明为准。 |
启动MCP | 是否启用 MCP 相关能力。设为 开启 时，会显示 MCP 相关配置项。 |
百炼 MCP | 可为只读；由服务或百炼侧关联配置。 |
MCP Json文件路径 | 当「是否启动MCP」为 true 时有效。用于保存 MCP 配置的 JSON 文件路径，默认 |
MCP Json 文件路径规则：该路径为 Agent 工作目录（即「工作目录」参数）下的相对路径，须以 / 开头。例如填 /mcp_config.json 时，实际文件会写入 {工作目录}/mcp_config.json；填 /config/mcp.json 时，会写入 {工作目录}/config/mcp.json（若子目录不存在会自动创建）。
部署结果验证
常见输出包括（以控制台 输出 / 概览 为准）：
WebUI 访问地址：浏览器打开后与 Agent 对话，若基于AgentScopeRuntime部署可基于此页面对话。
远程连接：通过 Workbench 登录服务器。
初始密码（新建机器时）：请保存并建议登录后修改。
后续操作
绑定应用连接：在页中，选择所需绑定应用连接完成绑定，关于应用连接介绍请参考文档Agent连接使用说明。
更换部署代码：若您需更换已部署的Agent代码，可前往部署物页签中创建部署物，并在中，点击发布完成代码替换。
更换环境变量：在参数页签修改环境变量，在部署物页签中创建用于重启应用的部署物，并在 中发布重启应用部署物使其生效。
常见问题
现象 | 建议排查 |
模型不可用、鉴权失败 | 是否已填写 百炼 API Key，百炼是否已开通 |
Git 拉取失败 | 网络能否访问对应代码平台；是否需内网/镜像 |
OSS 下载失败 | 地域是否一致；内网选项与 Bucket 地域是否匹配 |
镜像拉取失败 | ACR 与 ECS 网络（内网/企业版VPC）是否满足要求 |
WebUI 打不开 | 部署是否成功、是否为AgentScope Runtime框架、首次启动较慢，请稍等。 |
MCP 报错 | 百炼是否开通 MCP；配置文件路径是否理解正确（相对工作目录） |
会话不能持久化 | 是否在 应用工具 中绑定了会话管理等连接 |