大数据开发治理平台 DataWorks：基于三方客户端的DataWorks Agent

准备工作

• 已创建工作空间，并选择使用新版数据开发（Data Studio）。

• （可选，RAM账号需要）进行任务开发的RAM账号已被添加至对应工作空间中，并具有开发或空间管理员（权限较大，谨慎添加）角色权限，添加成员的操作详情请参见为工作空间添加空间成员。

  如果您使用的是主账号，则可忽略该添加操作。

• 已创建个人开发环境实例。

  说明

  如您的个人开发环境需要绑定VPC，您需配置个人开发环境访问公网。

步骤一：进入个人开发环境

您可通过以下步骤，启用并进入个人开发环境。

1. 进入DataWorks工作空间列表页，在顶部切换至目标地域，找到已创建的工作空间，单击操作列的快速进入 > Data Studio，进入Data Studio。

2. 单击顶部导航栏个人开发环境旁边的图标，检查您创建的个人开发环境实例的状态并进入个人开发环境。

   • 实例状态为运行中：单击个人开发环境中正在运行的个人开发环境实例，进入个人开发环境。

   • 实例状态为其它状态：单击弹窗中的管理环境，在个人开发环境实例页面找到您创建的实例，单击操作栏中的启动按钮，等待实例状态变为运行中，再单击该实例进入个人开发环境。

   说明

   当个人开发环境区域出现类似图标时，表示您已成功进入个人开发环境。

步骤二：安装 Cline

进入个人开发环境后，您可以按照以下步骤配置 DataWorks Agent。本文将以 Cline 为例进行说明。

wget https://nodejs.org/dist/v20.19.0/node-v20.19.0-linux-x64.tar.xz
tar xf node-v20.19.0-linux-x64.tar.xz
mv /etc/dsw/node /etc/dsw/node14
mv node-v20.19.0-linux-x64 /etc/dsw/node

bash <(curl -s https://dataworks-notebook-${REGION}.oss-${REGION}.aliyuncs.com/public-datasets/aone-release/dwcode-server/scripts/update.sh)  0.2.169

步骤三：配置 LLM 的 API Key

安装完 Cline 扩展程序后，请按照以下步骤配置 API Key 信息。这里将以使用 OpenAI Compatible 模式连接百炼 API 为例进行配置说明。

1. 在 Data Studio 个人开发环境页面，单击顶部导航栏右上角的，进入 Copilot Chat，单击切换至 Cline。

2. 单击 Cline 页面中的Use your own API key，根据下表参数说明进行相关配置。

   参数	说明
   API Provider	指定您要使用的 API 服务提供商，选择OpenAI Compatible。这表示您将使用与 OpenAI API 兼容的接口来连接百炼 API。
   Base URL	API 服务的基础 URL，用于指定 API 请求的根地址。 例如百炼 API 提供的与 OpenAI 兼容的 API 端点地址：https://dashscope-intl.aliyuncs.com/compatible-mode/v1。
   API Key	用于身份验证的密钥，可从阿里云百炼控制台获取该 API Key。
   Model ID	指定您要使用的具体模型。不同模型在功能定位和性能表现上各有侧重。 选择qwen-coder-plus或qwen-plus： qwen-coder-plus：适用于代码生成和编程任务。 qwen-plus：适用于通用文本生成和处理任务。

3. 单击下方的 Let's go! 按钮，完成 API Key 的配置。

步骤四：配置 MCP Server

完成 API Key 配置后，您可按以下步骤接入并配置 DataWorks MCP Server。更多关于 DataWorks MCP Server的说明，可见附录：DataWorks MCP Server。

1. 在 Cline 页面右上角单击图标，进入 MCP Serves 的 Marketplace 页签。

2. 切换至 Installed 页签，查看已安装的 MCP Server；

3. 单击 Configure MCP Servers 打开cline_mcp_settings.json配置文件。DataWorks 默认预置 alibabacloud-dataworks-mcp-server 的基础配置，具体配置信息如下：

   {
     "mcpServers": {
       "alibabacloud-dataworks-mcp-server": {
         "command": "npx",
         "args": [
           "alibabacloud-dataworks-mcp-server"
         ],
         "env": {
           "REGION": "cn-shanghai",
           "ALIBABA_CLOUD_CREDENTIALS_URI": "http://localhost:7002/api/v1/credentials/0",
           "TOOL_CATEGORIES": "SERVER_IDE_DEFAULT"
         },
         "disabled": false,
         "autoApprove": [],
         "timeout": 60
       }
     }
   }

   参数		说明
   command		npx，表示dataworks-mcp-server提供的指令方式。
   args		alibabacloud-dataworks-mcp-server，表示dataworks-mcp-server的指令参数。
   env	REGION	示例中为cn-shanghai，表示当前 DataWorks 工作空间所在的地域。
   	ALIBABA_CLOUD_CREDENTIALS_URI	指定阿里云凭证的URI。 重要 该参数仅在DataWorks个人开发环境生效，用于获取阿里云用户身份认证。
   	TOOL_CATEGORIES	配置Tool分类的白名单。请在此处填写OpenAPI的分类，多个分类之间用半角逗号分隔。 例如："TOOL_CATEGORIES":"数据源,空间管理,资源组管理,数据地图,数据集成,数据开发（新版）,运维中心,数据服务,开放平台,数据质量,标签管理,安全中心,SERVER_IDE_DEFAULT"。 说明 SERVER_IDE_DEFAULT为个人开发环境上的默认Tools，上述其他业务分类可在大数据开发治理平台 DataWorks - OpenAPI 概览页的左侧目录树中查看。 为提升模型加载性能和用户体验，默认配置中将 TOOL_CATEGORIES 设为 SERVER_IDE_DEFAULT；如需启用全部 OpenAPI 工具，可删除该配置项。
   	TOOL_NAMES	配置Tool名字的白名单。请在此处填写OpenAPI的名字，多个名字之间用半角逗号分隔。 例如："TOOL_NAMES":"ListProjects,CreateNode,UpdateNode"。 说明 TOOL_NAMES可在大数据开发治理平台 DataWorks - OpenAPI 概览中查看。

4. 配置信息保存后，当页面成功加载并显示可用的 Tools 列表时，即表示 alibabacloud-dataworks-mcp-server 已安装并配置成功，您可立即开始使用 DataWorks MCP Server 功能。

   说明

   如果未能加载出以下信息，请确认是否已升级程序引擎。

   

5. 您可以通过直接编辑上述 cline_mcp_settings.json 配置文件，或在 Marketplace 中安装其他 MCP Server，灵活扩展 DataWorks Agent 的能力。例如，若需在 DataWorks Agent 中使用 Hologres 相关功能，可接入 Hologres MCP Server。