管理扩展

安装专家套件

1. 在 Data Agent 界面左侧导航栏，单击扩展 > 专家套件。

2. 在专家套件页面，单击安装套件。

3. 打开安装专家套件对话框，选择安装方式。系统支持以下三种安装来源：

   • 远程仓库：从 Git 仓库或套件市场获取套件内容，适用于托管在 HTTPS Git 仓库，或发布在 Claude Marketplace、Gemini 市场的套件。可通过 Ref 指定分支、tag 或 commit 固定安装版本。

   • npm 包：从 npm 注册表下载指定版本的套件包并安装，适用于以版本化 npm 包形式分发的套件。通过包名后缀 @version 指定版本。

   • 本地路径 / 上传：从本地目录或上传的压缩包安装，不依赖仓库或注册表，适用于离线环境或尚未发布的自研套件。

   远程仓库与 npm 包的主要区别在于：前者从 Git 仓库或市场获取内容，通过 Ref 固定版本，私有仓库使用实例内 Git 凭据认证；后者从 npm 注册表获取已发布的包制品，通过包名 @version 指定版本，私有注册表使用实例内的 .npmrc / NPM_TOKEN 配置拉取。各来源需填写的信息如下：

   安装来源	输入内容	说明
   远程仓库	仓库：填写仓库标识，支持 owner/repo（如 myorg/my-suite）、HTTPS Git URL、owner/repo:plugin-name（仓库包含多个插件时用于指定安装其中一个插件）三种格式 Ref：填写分支、tag 或 commit 以固定安装版本。可选，留空时默认使用仓库默认分支	用于安装 Claude Marketplace、Gemini CLI 扩展或 HTTPS Git 仓库中的套件，支持浏览 Gemini 市场和 Claude Code 市场。未指定 Marketplace 插件时，将在安装过程中选择；私有仓库使用实例内 Git 凭据认证。
   npm 包	包名：填写 npm 注册表上已发布的 scoped 包名，可附加版本号，如 @scope/my-extension@1.2.0 Registry：用于拉取包的 npm 注册表。留空时，默认读取实例内的 .npmrc / NPM_TOKEN 配置	从 npm 注册表安装 scoped 包。仅支持 scoped 包名（@scope/name），避免与 owner/repo 格式混淆。
   本地路径 / 上传	本地目录路径或压缩包	从本地目录安装或上传压缩包

   说明

   远程仓库始终通过 daemon 安装；npm 包在 daemon 支持时直接提交安装，本地路径和上传压缩包仍需在终端执行 qwen extensions install。

4. 单击确认安装，完成安装。安装成功后，可在专家套件页面查看该套件是否已加入列表；若安装失败，可在套件条目上查看错误提示。

管理已安装专家套件

安装完成后，可通过套件操作菜单启用或禁用套件。套件的启用、禁用（含批量操作）均在实例范围内生效：

在任务中使用专家套件

在 Data Agent 任务输入框中输入 @，在弹出的菜单中选择专家套件，即可引用已启用的专家套件；智能体将调用套件内置的能力（技能、MCP 资源等）完成会话任务。

内置技能

Data Agent 预置了 DataWorks 官方内置技能，无需安装，开启后即可在会话任务中调用。在技能页面切换至 DataWorks 页签，即可查看当前实例可用的内置技能，并按需开启或关闭。以下为部分常用内置技能的功能示例，实际技能列表以产品界面展示为准：

安装技能

在技能页签单击目标技能的安装，可直接安装市场技能；自定义技能需通过安装技能对话框上传 Zip 包或执行安装命令。

1. 在 Data Agent 界面左侧导航栏，单击 扩展 > 技能。

2. 在技能页面，单击安装技能。

3. 在安装技能对话框选择安装方式，并填写对应信息：

   上传 Zip 包

   选择安装位置：

   安装位置	说明
   安装到当前实例	仅写入实例本地，不上传至平台；可更新已有的本地 Skill。
   发布到技能平台	上传至云端并按归属范围共享，同时安装到当前实例。需选择归属范围：工作空间或租户。

   单击或将文件拖动到虚线框内，上传 Zip 包。支持 .zip 格式文件，单个文件最大 50MB。

   重要

   Zip 根目录必须包含 SKILL.md；技能名称和描述从包内 SKILL.md 的元信息中读取，其他文件可作为资源附件通过相对路径引用。限制：SKILL.md ≤ 200KB，整个 Zip 包 ≤ 50MB。

   Zip 包支持以下两种结构，根目录直接放置 SKILL.md 及资源文件，或将它们放在单一顶层目录下：

   # 结构一：根目录结构
   my-skill.zip
   ├── SKILL.md         # 必需；包含名称、描述和正文
   ├── data/sample.csv  # 资源附件
   └── images/demo.png
   
   # 结构二：单一顶层目录包装
   my-skill.zip
   └── my-skill/
       ├── SKILL.md         # 必需；包含名称、描述和正文
       ├── data/sample.csv  # 资源附件
       └── images/demo.png

   单击安装到实例。

   命令安装

   在安装命令文本框中，粘贴面向 Qwen Code 的技能安装命令。

   单击执行安装。

   说明

   命令安装方式需要当前资源组开通公网访问。

4. 在技能页面确认目标技能已出现在列表中。

管理已安装技能

在技能页面，可对目标技能执行以下操作：

在任务中使用技能

在任务输入框中输入 /，选择并调用目标技能；智能体将按照该技能预定义的流程执行当前任务。

新增 MCP 服务器

1. 在 Data Agent 界面左侧导航栏，单击扩展 > MCP。

2. 单击新增 MCP 服务。

3. 打开新增 MCP 服务对话框，配置以下参数：

4. 参数	类型	必填	说明
   名称	文本输入	是	MCP 服务器的唯一标识名称
   传输方式	选择	是	Streamable HTTP（默认）、stdio 或 SSE，三者的区别请参见下表
   输入方式	选择	否	手动输入（默认）或 JSON 解析；选择 JSON 解析时可直接粘贴 JSON 格式的配置内容

   三种传输方式的区别如下：

   传输方式	连接方式	适用场景
   HTTP	通过 HTTP 协议连接远程 MCP 服务	部署在网络或云端的 MCP 服务
   stdio	启动本地进程，通过标准输入/输出通信	本地命令行 MCP 服务（如 npm 包、可执行文件）
   SSE	通过 Server-Sent Events 长连接连接远程服务	仍使用 SSE 协议的远程服务

   根据选择的传输方式，需要填写不同的连接参数：

   HTTP

   参数	必填	说明
   服务端点地址	是	Streamable HTTP 服务端点地址，如 https://example.com/mcp
   请求头	否	每行一个 KEY=VALUE，如 Authorization=Bearer xxxx
   超时时间	否	连接超时时间（毫秒）

   stdio

   参数	必填	说明
   命令	是	启动服务的命令行命令
   参数	否	命令行参数（字符串数组）
   环境变量	否	环境变量（键值对格式）
   超时时间	否	连接超时时间（毫秒）

   SSE

   参数	必填	说明
   URL	是	SSE 服务端点地址
   请求头	否	每行一个 KEY=VALUE
   超时时间	否	连接超时时间（毫秒）

5. （可选）开启信任该服务开关。开启后，在受信任工作目录下调用该服务器的工具时无需确认。

6. 单击确认，完成创建。创建成功后，在 MCP 服务器列表页确认新增条目的状态列显示为已连接；若显示需要认证，请按照认证操作完成 OAuth 认证；若显示错误，请检查地址、传输参数与网络连通性后重试。

管理已有 MCP 服务器

对于已配置的 MCP 服务器，支持以下操作：

在任务中使用 MCP 服务器

在任务输入框中输入 @，选择MCP 资源，即可引用 MCP 服务器资源；智能体将在执行任务时调用 MCP 服务器提供的外部工具和数据源。