本文档说明如何在计算巢Agent部署中,选择Agent市场示例并完成一键部署。
Agent 市场是什么
Agent 市场提供官方示例 Agent。选好 Agent 后按部署页填写必要信息,系统会自动完成环境准备、Agent 部署等流程,最终可通过 Web 对话界面或 HTTP 接口调用。
同一 Agent 通常提供 ECS 版与容器集群版两种部署模板:
ECS 版在单台云服务器上运行 Docker 容器,适合快速验证与轻量生产,并支持 Workbench 远程登录;
容器集群版将镜像部署到 ACS/ACK 集群,由 K8s 自动管理 Pod 生命周期,适合生产环境与高可用、弹性伸缩场景。
操作步骤
登录阿里云计算巢,进入。
选择需要的 Agent,单击立即部署。
在部署页选择部署方式:ECS 版或容器集群版。
说明容器集群版须提前在目标 VPC 中创建 Redis 实例,并在中创建会话连接,详见下方「应用连接说明」。
按页面提示填写并确认各项配置,单击立即创建。
创建后将进入该应用页面,等待约 2~3 分钟(集群版创建时间较长)部署完成。
在概览中打开 WebUI(或页面提供的访问入口),即可连接 Agent 对话。
部署页配置
应用信息
应用名称、分组名称:可自定义应用名称/分组名称,通常情况下使用默认选项即可。
部署资源
ECS 版:
参数 | 说明 |
付费方式 | 按量付费 / 包年包月 |
实例规格 | 默认 ecs.u1-c1m2.large |
系统盘 | ESSD,默认 40 GB |
公网带宽 | 默认 5~10 Mbps |
容器集群版:
参数 | 说明 |
集群选项 | 新建 ACS / 新建 ACK / 已有集群 |
默认集群类型 | 新建 ACS(Serverless,无需管理节点) |
ACK 额外配置 | Worker 规格、节点数量、网络插件(仅选新建 ACK 时显示) |
两种部署方式的 WebUI 与 API 均通过 8000 端口访问;WebUI 与 /run_sse 流式 API 共用同一端口。
模型配置
模型选择:在下拉列表中选择要使用的模型;通常情况使用默认选项即可。
百炼 API Key:从百炼获取后填入,必填,用于调用模型服务。
高级配置
环境变量:若应用需要额外环境变量(如业务配置),可在此添加键值对,无需要可留空。该区域默认折叠。
网络配置
ECS 版:可用区、专有网络(新建或已有)、交换机与网段等,按页面提示选择即可。
容器集群版:须选择已有专有网络及交换机(不支持新建 VPC)。
网络选择会影响下方工具配置中可绑定的应用连接:会话连接须与 Agent 部署在同一 VPC 内网互通。
工具配置
将 Agent 与账号下的云资源或扩展能力绑定。
参数 | 说明 |
应用连接 | 绑定 Agent 依赖的外部能力。列表里只会出现当前 Agent 支持的连接类型(如会话管理、沙箱、知识库等) |
百炼 MCP | 市场 Agent 会自动关联所需 MCP,内容为只读。需确认对应能力已在百炼侧开通;若提示未开通,按指引完成开通 |
Skills | 若 Agent 支持 Skills,可开启启用 Skills并选择要安装的 Skill。仅当前 Agent 支持时显示此项 |
应用连接说明
会话连接用于多轮对话上下文持久化,对应 Redis 实例。使用前先在 Redis 控制台创建实例,并在中创建连接。详见「连接使用说明」。
ECS 版:可选。选新建 VPC 时列表不展示会话连接,可使用内置本地 Redis;选已有 VPC 后,列表仅展示与该 VPC 同网的连接,可按需绑定。
容器集群版:必填。须选已有 VPC,并绑定与该 VPC 同网的会话管理连接。
会话连接须与 Agent 部署在同一 VPC 内网互通。选新建 VPC 时 VPC 尚未创建,无法匹配 Redis 网络,因此不展示会话连接——新建 VPC 仅在 ECS 场景生效。
创建完成后您会看到什么
创建完成后页面将会出现:
输出 | ECS 版 | 容器集群版 |
WebUI 访问地址 |
| 同 ECS,地址为 LoadBalancer 公网 IP |
API 调用示例 | 页面提供 | 同 ECS |
代码调试 |
| 同 ECS |
远程连接 | 通过 Workbench 登录 ECS | - |
初始密码 | 可用于登录 ECS,建议登录后修改 | - |
常见问题
通用
现象 | 建议排查 |
无法对话、提示鉴权或 Key 相关错误 | 是否已填写百炼 API Key,百炼服务是否已开通 |
MCP 相关报错 | 是否百炼 MCP 已开通 |
会话无法持久化 | 是否在中绑定了会话管理连接;绑定后需到重新发布 |
应用连接列表为空 / 看不到会话管理 | 是否选了已有 VPC 且 Redis 在该 VPC 内;新建 VPC 时不展示会话连接(ECS 可跳过,集群须改选已有 VPC) |
WebUI 打不开 | 部署是否已完成;首次启动较慢,可稍后尝试;确认访问端口为 8000 |
容器集群版
现象 | 建议排查 |
无法提交部署、提示缺少连接 | 容器版是否在应用连接中绑定了与所选 VPC 同网的会话管理连接 |
Pod Pending | 集群资源不足或调度限制 |
Pod CrashLoopBackOff | 查看 Pod 日志,排查镜像启动错误或 Redis 地址不可达 |