DataWorks：基於三方用戶端的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-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的配置後，您可根據以下步驟完成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":"資料來源,空間管理,資源群組管理,資料地圖,Data Integration,資料開發（新版）,營運中心,資料服務,開放平台,資料品質,標籤管理,資訊安全中心,SERVER_IDE_DEFAULT"。 說明 SERVER_IDE_DEFAULT為個人開發環境上的預設Tools，其他業務分類（資料來源,空間管理,資源群組管理,資料地圖,Data Integration,資料開發（新版）,營運中心,資料服務,開放平台,資料品質,標籤管理,資訊安全中心）可在巨量資料開發治理平台 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功能。

   說明

   如果未能載入出以下資訊，請確認是否已升級引擎。