自定义Agent部署

源文件类型

源文件类型：选择应用来源方式：Git 仓库代码、OSS 文件 或 Docker 镜像。后续需填写的参数会随该选项变化。

不同部署方式下，各源类型是否可用如下：

Docker 镜像

发布时镜像会在执行脚本前自动拉取到 ECS，脚本中无需执行 docker pull。

推荐基于官方公开 ADK 基础镜像构建。

FROM compute-nest-registry.cn-hangzhou.cr.aliyuncs.com/computenest/agentscope-adk-base-py312:latest
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
CMD ["bash", "docker-entrypoint.sh"]   # 启动

Git 仓库（仅 ECS 版）

代码自动下载到 code_deploy_application/，无需 git clone。

OSS 文件（仅 ECS 版）

文件自动下载到工作目录，压缩包需启动脚本中解压。

应用连接说明

会话连接用于多轮对话上下文持久化，对应 Redis 实例。使用前请先在Redis 控制台创建实例，并在 Agent 部署 > 连接管理 中创建连接。详见连接使用说明。

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

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

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

MCP 配置方式

MCP Json 格式示例：

{
  "mcpServers": {
    "WebSearch": {
      "type": "streamableHttp",
      "baseUrl": "https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp",
      "headers": {
        "Authorization": "Bearer ${DASHSCOPE_API_KEY}"
      }
    }
  }
}

${DASHSCOPE_API_KEY} 为占位符，部署时由平台替换为实际 API Key。

代码读取示例：

ECS 版从文件读取；容器集群版从 MCP_JSON 读取并 Base64 解码。

import base64
import json
import os
from pathlib import Path

def load_mcp_config() -> dict:
    if raw := os.getenv("MCP_JSON"):
        return json.loads(base64.b64decode(raw).decode("utf-8"))
    path = Path(os.getenv("MCP_CONFIG_PATH", "/root/mcp_config.json"))
    return json.loads(path.read_text(encoding="utf-8"))

调试时可执行 echo "$MCP_JSON" | base64 -d 查看解码后的 JSON。

各 MCP 的 baseUrl 以百炼控制台展示为准；使用前需在百炼侧开通对应 MCP 能力。详见连接使用说明。

Skills 配置方式

代码中可从 /root/skills 读取已安装的 Skill 文件，供 Agent 按需加载。