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

升级完成后，请在弹窗中单击重新加载窗口以应用最新的更改。

安装Cline扩展程序

您可根据以下步骤，在个人开发环境安装扩展程序Cline，作为您的Agent对话窗口。

1. 单击个人开发环境欢迎页左侧导航栏的图标，进入程序扩展页。

2. 在程序扩展页的搜索框中输入Cline。

3. 找到下方出现的扩展程序Cline。

4. 单击Cline程序右下方的安装，等待程序安装完成。

5. 安装完Cline程序后，您可以通过右键单击左侧导航栏的图标，根据个人喜好配置键绑定、将插件程序移动到 > 辅助侧边栏或移动到 > 面板。

配置LLM的API Key

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

1. 单击个人开发环境欢迎页左侧导航栏的图标，进入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.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的配置后，您可根据以下步骤完成MCP Server的相关配置。

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

2. 单击切换至Installed页签。

3. 单击Configure MCP Servers，您可按需在此配置多个MCP Server。请在右侧的配置文件中填写以下配置信息。

   说明

   若您需在DataWorks Agent中使用Hologres能力，请接入Hologres MCP Server。

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

   参数		说明

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

4. 编辑完配置信息后，请按Ctrl+S保存并加载您所配置的MCP Server信息。

5. 看到如下加载成功的Tools可确认alibabacloud-dataworks-mcp-server已安装成功，即可开始使用DataWorks MCP Server功能。

   说明

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