全部產品
Search
文件中心

DataWorks:DataWorks Copilot 系統設定

更新時間:Feb 27, 2026

DataWorks Copilot 設定中心是配置與最佳化智能助手功能的核心模組。目前該中心整合了 MCP 伺服器、規則、通用及模型四大核心功能。通過接入外部工具服務與靈活定製 AI 規則,Copilot 旨在全面提升開發效率並保障代碼品質,為使用者提供高度定製化的智能化開發體驗。

功能入口

Copilot 設定中心支援配置規則、MCP 伺服器、通用設定及模型 API 金鑰。您可通過以下操作進入設定中心:

  1. 單擊DataWorks介面右上方的Copilot表徵圖,開啟DataWorks Copilot面板。

  2. 單擊Copilot面板的image設定按鈕,進入設定中心。

image

規則配置

規則(Rules)是為 DataWorks Copilot 注入持久化上下文、規範與偏好的核心機制,從而確保其產生的程式碼與回答能精準遵循特定要求。

規則的類型與許可權

DataWorks 提供企業級和個人級兩種類型的規則:

類型

定義與用途

許可權控制

生效範圍

個人Rules

由開發人員個人建立和維護,用於封裝個人的編碼習慣、常用程式碼片段、個人專案說明等。

僅對目前使用者可見並生效,其他使用者無法查看或使用。

個人範圍,在使用者所有可訪問的工作空間中均可調用。

企業級Rules

由管理員統一制定,用於沉澱和推行公用的開發規範,如數倉分層命名法、代碼風格標準、核心表使用說明等。

工作空間管理員及更進階別使用者可建立、編輯和管理。

支援全域生效或指定到特定工作空間。

建立與管理規則

在Copilot設定中心,切換到Rules頁簽。在規則管理介面,您可以:

  • 通過頁簽切換,分別管理個人Rules以及企業級Rules

  • 查看已有規則的名稱、生效機制、生效範圍等資訊。

  • 查看、編輯或刪除已有規則。

  • 單擊新增Rule按鈕建立新規則。

建立/編輯規則時,需要配置以下核心屬性:

屬性

功能說明

規則名稱

為規則設定一個易於識別的名稱和詳細的功能描述。

規則內容

規則的核心,即您希望提供給AI的具體上下文prompt資訊。可以填寫要求Copilot自動產生代碼時需要執行的規範和標準等內容。支援手動輸入與文檔上傳兩種方式。

  • 手動輸入:直接輸入或粘貼規則內容。

  • 文件上傳:上傳本地檔案,Copilot 解析其內容後作為規則內容使用。支援的檔案格式包括 .doc.docx.pdf.txt.md.xls.xlsx.ppt.pptx.rtf.csv 和 .json;單個檔案大小不超過 50 KB。

生效機制

定義規則被自動引入對話的策略,對齊Cursor的設計理念:

  • 總是應用:每次對話都會自動載入此規則。

  • 手動應用:預設不載入,僅在對話中被使用者添加至上下文時生效。

生效範圍

企業級規則支援設定生效範圍,控制此規則在哪些地方可見和可用。

  • 指定工作空間:僅對指定的工作空間下的成員生效。配置時,可選範圍僅限於擁有管理員權限的工作空間列表

  • 全部工作空間:租戶級生效。

以下是規則內容舉例:

  • 規則名稱:表名及節點命名規範。

  • 規則內容:如下。

    # DataWorks數倉(ODS/DWD/DWS/ADS)表與節點命名規範
    作為一名資深的資料倉儲架構師,你在DataWorks中建立任何錶或節點時,都必須嚴格遵循以下命名規範。這些規範是確保資料資產清晰、可維護和一致性的核心要求。
    
    ### 1 表命名規範(Table Naming Convention)
    所有表名必須遵循統一的結構化範式。
    
    #### 1.1 核心命名公式
    分層首碼_[自訂描述]_[更新策略尾碼]
    
    #### 1.2 分層首碼 (Layer Prefix) - [硬性要求]
    -   DIM (維度層):  必須以 `dim_` 開頭。
    -   DWD (明細層):  必須以 `dwd_` 開頭。
    -   DWS (匯總層):  必須以 `dws_` 開頭。
    -   ADS (應用程式層):  必須以 `ads_` 開頭。
    
    #### 1.3 更新策略尾碼 (Update Strategy Suffix) - [硬性要求]
    -   DIM (維度層): 使用 _df 尾碼,代表每日全量快照 (Daily Full Snapshot)。
    -   DWD (明細層): 使用 _di 尾碼,代表每日增量資料 (Daily Incremental)。使用 _df 尾碼,代表每日全量快照 (Daily Full Snapshot)。
    -   DWS / ADS (匯總/應用程式層): 使用 _1d, _7d, _nd 等尾碼,代表其資料彙總的周期(例如:近1天、近7天、近N天)。
    
    #### 1.4 分隔字元
    表名中的所有單詞必須使用小寫字母,並由單個底線 `_` 分隔。
    
    #### 1.5 命名樣本
    -   DIM表示例: `dim_user_info_df` (使用者資訊維度資料表,每日全量)
    -   DWD表示例 (增量):  `dwd_trade_order_detail_di` (交易訂單明細,每日增量)
    -   DWD表示例 (全量):  `dwd_product_base_info_df` (商品基礎資訊,每日全量)
    -   DWS表示例:  `dws_user_active_uv_7d` (使用者近7日活躍UV匯總)
    -   ADS表示例:  `ads_screen_kpi_overview_1d` (大屏核心KPI概覽,每日)
    
    ### 2.節點命名規範 (Node Naming Convention)
    
    節點名稱應清晰地反映其產出的核心表和處理邏輯。
    
    -   命名原則:  節點名應與其產出的主要表的名稱保持高度一致,以 `[分層]_[商務邏輯]` 的格式命名。
    -   樣本: 
        -   產出表 `dwd_trade_order_detail_di` 的ODPS SQL節點,應命名為 `dwd_trade_order_detail_di`。
        -   如果一個節點處理複雜的邏輯,可以命名為 `dws_build_user_active_uv_7d`。
    
    ### 3.自我檢查清單
    
    在完成命名後,請依據此清單進行檢查:
    1.  表名是否以正確的分層首碼 (`dim_`, `dwd_`, `dws_`, `ads_`) 開頭。
    2.  表名是否以正確的更新策略尾碼 (`_df`, `_di`, `_1d` 等) 結尾。
    3.  所有單詞是否均用底線 `_` 分隔。
    4.  節點名是否清晰地反映了其功能和產出。

在對話中使用規則

配置好的規則會在您與 Copilot 的日常互動中發揮作用。

  • 對於設定為總是應用的規則,無需任何額外操作。Copilot 在產生代碼或回答時,會預設將這些規則作為背景知識和約束條件。

  • 對於設定為手動應用的規則,可以在對話時通過以下方式主動啟用:

    1. 單擊輸入框下方的 image按鈕。

    2. 在彈出的操作功能表中,選擇規則,然後點選您希望本次對話應用的具體規則。

MCP 伺服器配置

MCP (Model Context Protocol) Server 是 Copilot Agent 執行任務時依賴的後端工具服務集合,為查詢、分析和代碼產生等操作提供工具與資料來源與API。在設定中心可以查看DataWorks官方內建的 Alibaba Cloud-DataWorks-MCP-Server及相關工具。

訪問MCP Servers管理介面

在Copilot設定中心。單擊 MCP Servers進入MCP Servers頁簽。

管理MCP Server

在MCP Servers列表頁面,可以查看當前已配置的DataWorks 內建的 MCP Server及其工具列表。

使用MCP Server

MCP Server相關工具可以在Copilot Agent中使用,詳情參見:DataWorks Agent

通用配置

在Copilot設定中心。單擊設定進入設定頁簽。在該頁面,您可以進行以下兩類配置:

全域設定

副駕駛總開關:用於控制當前租戶內 Copilot 功能的整體啟用狀態。若關閉此開關,將禁用租戶下所有使用者對 Copilot、Agent 等相關功能的存取權限。

重要

該設定需要租用戶系統管理員許可權,修改後將影響租戶內所有使用者。

個人設定

生成代碼檔案的預設儲存路徑:用於指定 Agent 所產生代碼的儲存路徑。預設選項為專案目錄,您可以根據需要將其切換為個人目錄

模型配置

在 Copilot 設定中心,單擊模型進入模型頁簽。在該頁面,您可以配置百鍊模型的 API Key。配置完成後,Agent 或 Copilot 在調用大模型時將預設使用您所設定並啟用的 API Key。

image

相關文檔