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":"資料來源,空間管理,資源群組管理,資料地圖,Data Integration,資料開發（新版）,營運中心,資料服務,開放平台,資料品質,標籤管理,資訊安全中心,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。