DataWorks Copilot 設定中心是配置與最佳化智能助手功能的核心模組。目前該中心整合了 MCP 伺服器、規則、通用及模型四大核心功能。通過接入外部工具服務與靈活定製 AI 規則,Copilot 旨在全面提升開發效率並保障代碼品質,為使用者提供高度定製化的智能化開發體驗。
功能入口
Copilot 設定中心支援配置規則、MCP 伺服器、通用設定及模型 API 金鑰。您可通過以下操作進入設定中心:
單擊DataWorks介面右上方的Copilot表徵圖,開啟DataWorks Copilot面板。
單擊Copilot面板的
設定按鈕,進入設定中心。

規則配置
規則(Rules)是為 DataWorks Copilot 注入持久化上下文、規範與偏好的核心機制,從而確保其產生的程式碼與回答能精準遵循特定要求。
規則的類型與許可權
DataWorks 提供企業級和個人級兩種類型的規則:
類型 | 定義與用途 | 許可權控制 | 生效範圍 |
個人Rules | 由開發人員個人建立和維護,用於封裝個人的編碼習慣、常用程式碼片段、個人專案說明等。 | 僅對目前使用者可見並生效,其他使用者無法查看或使用。 | 個人範圍,在使用者所有可訪問的工作空間中均可調用。 |
企業級Rules | 由管理員統一制定,用於沉澱和推行公用的開發規範,如數倉分層命名法、代碼風格標準、核心表使用說明等。 | 工作空間管理員及更進階別使用者可建立、編輯和管理。 | 支援全域生效或指定到特定工作空間。 |
建立與管理規則
在Copilot設定中心,切換到Rules頁簽。在規則管理介面,您可以:
通過頁簽切換,分別管理個人Rules以及企業級Rules。
查看已有規則的名稱、生效機制、生效範圍等資訊。
查看、編輯或刪除已有規則。
單擊新增Rule按鈕建立新規則。
建立/編輯規則時,需要配置以下核心屬性:
屬性 | 功能說明 |
規則名稱 | 為規則設定一個易於識別的名稱和詳細的功能描述。 |
規則內容 | 規則的核心,即您希望提供給AI的具體上下文prompt資訊。可以填寫要求Copilot自動產生代碼時需要執行的規範和標準等內容。支援手動輸入與文檔上傳兩種方式。
|
生效機制 | 定義規則被自動引入對話的策略,對齊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 在產生代碼或回答時,會預設將這些規則作為背景知識和約束條件。
對於設定為手動應用的規則,可以在對話時通過以下方式主動啟用:
單擊輸入框下方的
按鈕。在彈出的操作功能表中,選擇規則,然後點選您希望本次對話應用的具體規則。
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。
