Agent市场部署

更新时间:
复制 MD 格式

本文档说明如何在计算巢Agent部署中,选择Agent市场示例并完成一键部署。

Agent 市场是什么

Agent 市场提供官方示例 Agent。选好 Agent 后按部署页填写必要信息,系统会自动完成环境准备、Agent 部署等流程,最终可通过 Web 对话界面或 HTTP 接口调用。

同一 Agent 通常提供 ECS 版容器集群版两种部署模板:

  • ECS 版在单台云服务器上运行 Docker 容器,适合快速验证与轻量生产,并支持 Workbench 远程登录;

  • 容器集群版将镜像部署到 ACS/ACK 集群,由 K8s 自动管理 Pod 生命周期,适合生产环境与高可用、弹性伸缩场景。

操作步骤

  1. 登录阿里云计算巢,进入Agent 部署 > Agent > Agent 市场

  2. 选择需要的 Agent,单击立即部署

  3. 在部署页选择部署方式:ECS 版容器集群版

    说明

    容器集群版须提前在目标 VPC 中创建 Redis 实例,并在Agent 部署 > 连接管理中创建会话连接,详见下方「应用连接说明」。

  4. 按页面提示填写并确认各项配置,单击立即创建

  5. 创建后将进入该应用页面,等待约 2~3 分钟(集群版创建时间较长)部署完成。

  6. 概览中打开 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 控制台创建实例,并在Agent 部署 > 连接管理中创建连接。详见「连接使用说明」。

  • ECS 版:可选。选新建 VPC 时列表不展示会话连接,可使用内置本地 Redis;选已有 VPC 后,列表仅展示与该 VPC 同网的连接,可按需绑定。

  • 容器集群版:必填。须选已有 VPC,并绑定与该 VPC 同网的会话管理连接。

会话连接须与 Agent 部署在同一 VPC 内网互通。选新建 VPC 时 VPC 尚未创建,无法匹配 Redis 网络,因此不展示会话连接——新建 VPC 仅在 ECS 场景生效。

创建完成后您会看到什么

创建完成后页面将会出现:

输出

ECS 版

容器集群版

WebUI 访问地址

http://<IP>:8000,选择对应应用名(如 conversation)

同 ECS,地址为 LoadBalancer 公网 IP

API 调用示例

页面提供 curl 示例;亦可向 /run_sse 发起 SSE 请求

同 ECS

代码调试

http://<IP>:8080(Code Server)

同 ECS

远程连接

通过 Workbench 登录 ECS

-

初始密码

可用于登录 ECS,建议登录后修改

-

常见问题

通用

现象

建议排查

无法对话、提示鉴权或 Key 相关错误

是否已填写百炼 API Key,百炼服务是否已开通

MCP 相关报错

是否百炼 MCP 已开通

会话无法持久化

是否在工具配置 > 应用连接中绑定了会话管理连接;绑定后需到应用分组 > 发布管理重新发布

应用连接列表为空 / 看不到会话管理

是否选了已有 VPC 且 Redis 在该 VPC 内;新建 VPC 时不展示会话连接(ECS 可跳过,集群须改选已有 VPC)

WebUI 打不开

部署是否已完成;首次启动较慢,可稍后尝试;确认访问端口为 8000

容器集群版

现象

建议排查

无法提交部署、提示缺少连接

容器版是否在应用连接中绑定了与所选 VPC 同网的会话管理连接

Pod Pending

集群资源不足或调度限制

Pod CrashLoopBackOff

查看 Pod 日志,排查镜像启动错误或 Redis 地址不可达