すべてのプロダクト
Search
ドキュメントセンター

DataWorks:DataWorks Copilot システム設定

最終更新日:Feb 27, 2026

DataWorks Copilot の設定センターを使用して、インテリジェントアシスタントを構成および最適化します。設定センターでは、MCP Server 設定、ルール、一般設定、モデル設定の4つの主要な領域を管理できます。外部ツールを統合し、カスタムルールを定義することで、DataWorks Copilot は開発効率を向上させ、コード品質を確保し、高度にカスタマイズされた開発エクスペリエンスを作成するのに役立ちます。

設定センターへのアクセス

DataWorks Copilot 設定センターでは、ルール、MCP Server 設定、一般設定、およびモデル API キーを構成できます。設定センターにアクセスするには、次の手順に従います。

  1. DataWorks インターフェースの右上隅にある Copilot アイコンをクリックして、DataWorks Copilot パネルを開きます。

  2. Copilot パネルの image [設定] ボタンをクリックして、設定センターを開きます。

image

ルール設定

ルールは、DataWorks Copilot に永続的なコンテキスト、標準、およびプリファレンスを提供します。これにより、アシスタントによって生成されるコードと応答が、特定の要件に準拠することが保証されます。

ルールタイプと権限

DataWorks は、エンタープライズレベルと個人の2種類のルールを提供します。

タイプ

定義と目的

権限管理

適用範囲

Personal Rules

個々の開発者によって作成および維持され、個人のコーディング習慣、頻繁に使用されるコードスニペット、およびプロジェクト固有のメモをカプセル化します。

現在のユーザーにのみ表示および適用可能です。他のユーザーは表示または使用できません。

個人範囲。ユーザーがアクセスできるすべてのワークスペースで使用できます。

Enterprise-class Rules

管理者によって定義され、データウェアハウス階層命名規則、コードスタイルガイド、コアテーブルの使用方法など、共通の開発標準を確立および適用します。

ワークスペース管理者およびより上位の権限を持つユーザーが作成、編集、および管理できます。

グローバルに、または特定のワークスペースに適用できます。

ルールの作成と管理

DataWorks Copilot 設定センターで、Rules タブに移動します。このタブでは、次の操作を実行できます。

  • Personal Rules タブと Enterprise-class Rules タブを切り替えて、各タイプのルールを管理します。

  • 既存のルールの名前、適用メカニズム、および適用範囲を表示します。

  • 既存のルールを表示、編集、または削除します。

  • New Rule をクリックして新しいルールを作成します。

ルールを作成または編集する際は、次のプロパティを構成します。

プロパティ

説明

Rule Name

ルールに識別しやすい名前と詳細な説明を設定します。

Rule Content

ルールのコアであり、AI に提供したい特定のプロンプトまたはコンテキストです。Copilot がコードを生成する際に従う必要がある標準と規則を入力できます。2つの入力方法がサポートされています: 手動入力とファイルのアップロード。

  • Manually enter: ルールコンテンツを直接入力または貼り付けます。

  • Document Upload: ローカルファイルをアップロードします。Copilot はそのコンテンツを解析してルールとして使用します。サポートされている形式には、.doc.docx.pdf.txt.md.xls.xlsx.ppt.pptx.rtf.csv、および .json が含まれます。最大ファイルサイズは 50 KB です。

Entry into force mechanism

ルールが会話に自動的に追加されるタイミングを定義します。

  • Always applied.: このルールは、すべての会話で自動的にロードされます。

  • Manual application: このルールはデフォルトではロードされません。会話のコンテキストに明示的に追加した場合にのみ適用されます。

Scope of entry into force

エンタープライズレベルのルールの場合、ルールの表示と利用可能性を制御するために適用範囲を設定できます。

  • Specify the workspace: 選択したワークスペースのメンバーにのみ適用されます。このオプションを構成する場合、管理者権限を持つワークスペースのみを選択できます。

  • All Work Space: テナント全体に適用されます。

以下は、ルールコンテンツの例です。

  • ルール名: テーブルとノードの命名規則。

  • ルールコンテンツ: 以下を参照してください。

    # DataWorks データウェアハウス (ODS/DWD/DWS/ADS) テーブルとノードの命名規則
    シニアデータウェアハウスアーキテクトとして、DataWorks でテーブルまたはノードを作成する際は、以下の命名規則に厳密に従う必要があります。これらの規則は、データ資産が明確で、保守可能で、一貫性があることを保証するために不可欠です。
    
    ### 1. テーブル命名規則
    すべてのテーブル名は、統一された構造パラダイムに従う必要があります。
    
    #### 1.1 コア命名式
    layer_prefix_[custom_description]_[update_strategy_suffix]
    
    #### 1.2 レイヤープレフィックス - [必須]
    -   DIM (ディメンションレイヤー): `dim_` で始まる必要があります。
    -   DWD (データウェアハウス詳細レイヤー): `dwd_` で始まる必要があります。
    -   DWS (データウェアハウスサマリーレイヤー): `dws_` で始まる必要があります。
    -   ADS (アプリケーションデータサービスレイヤー): `ads_` で始まる必要があります。
    
    #### 1.3 更新戦略サフィックス - [必須]
    -   DIM (ディメンションレイヤー): 日次完全スナップショットには `_df` サフィックスを使用します。
    -   DWD (データウェアハウス詳細レイヤー): 日次増分データには `_di` サフィックスを、日次完全スナップショットには `_df` サフィックスを使用します。
    -   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. ノード命名規則
    
    ノード名は、それが生成するコアテーブルとその処理ロジックを明確に反映する必要があります。
    
    -   命名原則: ノード名は、`[レイヤー]_[ビジネスロジック]` 形式に従って、出力するメインテーブルの名前と密接に一致する必要があります。
    -   例: 
        -   テーブル `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.  ノード名がその機能と出力を明確に反映していますか?

会話でのルールの使用

構成されたルールは、DataWorks Copilot との日常的なやり取り中に適用されます。

  • Always applied. に設定されたルールについては、追加の手順は不要です。DataWorks Copilot は、コードまたは回答を生成する際に、これらのルールを背景知識および制約として自動的に使用します。

  • Manual application」に設定されたルールについては、以下のようにして会話内で有効化できます。

    1. 入力ボックスの下にある image ボタンをクリックします。

    2. 表示されるコンテキストメニューで、Rule を選択し、現在の会話に適用する特定のルールを選択します。

MCP Server 設定

Model Context Protocol (MCP) Server は、DataWorks Copilot Agent がタスクを実行するために使用するバックエンドツールサービスのコレクションです。クエリ、分析、コード生成などの操作のためのツール、データソース、および API を提供します。設定センターでは、DataWorks によって提供されるデフォルトの Alibaba Cloud-DataWorks-MCP-Server と、それに関連付けられたツールを表示できます。

MCP Server ページへのアクセス

DataWorks Copilot 設定センターで、MCP Servers をクリックして、[MCP サーバー] タブを開きます。

MCP Server の管理

MCP Server ページでは、組み込みの DataWorks MCP Server とそのツールを表示できます。

MCP Server の使用

MCP Server に関連付けられたツールは、DataWorks Agent で使用できます。詳細については、「DataWorks Agent」をご参照ください。

一般設定

DataWorks Copilot 設定センターで、Settings をクリックして Settings タブを開きます。このページでは、以下の 2 種類の設定を構成できます:

グローバル設定

Copilot master switch: 現在のテナント内の DataWorks Copilot 機能全体の有効状態を制御します。このスイッチをオフにすると、テナント内のすべてのユーザーは DataWorks Copilot、Agent、および関連機能にアクセスできなくなります。

重要

この設定にはテナント管理者権限が必要です。変更はテナント内のすべてのユーザーに影響します。

個人設定

The default storage path for generating code files: Agent が生成するコードのストレージパスを指定します。デフォルトのオプションはProject Directoryです。必要に応じてPersonal Directoryに変更できます。

モデル設定

DataWorks Copilot 設定センターで、Model をクリックして、Model タブを開きます。このページでは、Bailian モデルの API キーを設定できます。設定後、エージェントまたは Copilot は、大規模言語モデル (LLM) を呼び出す際に、設定した API キーをデフォルトで使用します。

image

関連ドキュメント