DataWorks:サードパーティクライアントでの DataWorks Agent

前提条件

• ワークスペースを作成しましたし、[Data Studio (新バージョン) を使用] を選択しました。

• (オプション、RAM ユーザー向け) 開発用の RAM ユーザーを、[開発] または [ワークスペース管理者] のロールでワークスペースに追加済みです。ワークスペース管理者ロールには広範な権限があるため、割り当てる際は注意してください。メンバーの追加方法の詳細については、「ワークスペースへのメンバーの追加」をご参照ください。

  Alibaba Cloud アカウントを使用している場合は、このステップをスキップできます。

• 個人開発環境インスタンスを作成していること。

  説明

  個人開発環境を Virtual Private Cloud (VPC) にバインドする必要がある場合は、個人開発環境のパブリックネットワークアクセスを構成する必要があります。

ステップ 1: 個人開発環境へのアクセス

個人開発環境を開始してアクセスするには、次のステップに従います。

1. DataWorks コンソールでワークスペースページに移動します。上部ナビゲーションバーで目的のリージョンを選択します。目的のワークスペースを見つけ、[操作]列で[ショートカット] > DataStudioを選択します。

2. 上部ナビゲーションバーの Personal Development Environment の横にある アイコンをクリックして、個人開発環境のインスタンスのステータスを確認し、アクセスします。

   • インスタンスのステータスが Running: [個人開発環境] の下にある実行中のインスタンスをクリックして、環境にアクセスします。

   • インスタンスが別の状態にある場合: ポップアップウィンドウで Management Environment をクリックします。Personal Development Environment Instances ページで、対象のインスタンスを見つけ、Actions 列の Start をクリックします。インスタンスステータス が Running に変わるまで待ち、インスタンスをクリックして環境に入ります。

   説明

   [個人開発環境] エリアにある のようなアイコンは、個人開発環境に入ったことを示します。

ステップ 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

ステップ 3: LLM API キーの構成

Cline 拡張機能のインストール後、API キーを構成するには、次のステップに従います。この例では、OpenAI 互換モードを使用して Model Studio (Bailian) API に接続する方法を示します。

1. Data Studio 個人開発環境ページで、上部のナビゲーションバーの右上隅にある アイコンをクリックして Copilot Chat を開き、 アイコンをクリックして Cline に切り替えます。

2. Cline ページで、[独自の API キーを使用] をクリックし、次の表に示すとおりにパラメーターを設定します。

   パラメーター	説明
   API プロバイダー	使用する API サービスプロバイダー。[OpenAI Compatible] を選択します。これは、OpenAI 互換インターフェースを使用して Model Studio (Bailian) API に接続することを示します。
   ベース URL	API サービスのベース URL。API リクエストのルートアドレスを指定します。 たとえば、Model Studio (Bailian) が提供する OpenAI 互換 API エンドポイントは https://dashscope-intl.aliyuncs.com/compatible-mode/v1 です。
   API キー	認証に使用されるキー。この API キーは Model Studio (Bailian) コンソール から取得できます。
   モデル ID	使用するモデル。 モデルは機能とパフォーマンスが異なります。qwen-coder-plus または qwen-plus を選択します。 qwen-coder-plus: コード生成およびプログラミングタスクに適しています。 qwen-plus: 一般的なテキスト生成および処理タスクに適しています。

3. 下部にある[Let's Go!] ボタンをクリックして、API キーの構成を完了します。

ステップ 4: MCP Server の構成

API キーの構成後、DataWorks MCP Server に接続して構成するには、次のステップに従います。DataWorks MCP Server の詳細については、「付録: DataWorks MCP Server」をご参照ください。

1. Cline ページの右上隅で アイコンをクリックすると、[MCP Servers] パネルの [Marketplace] タブに移動します。

2. [Installed] タブに切り替えて、インストール済みの MCP Server を表示します。

3. 「[MCP サーバーの構成]」をクリックして、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	Alibaba Cloud 認証情報の URI を指定します。 重要 このパラメーターは DataWorks 個人開発環境でのみ有効であり、Alibaba Cloud ユーザー認証情報を取得するために使用されます。
   	TOOL_CATEGORIES	Tool カテゴリの許可リストを構成します。ここに OpenAPI カテゴリをコンマで区切って入力します。 例: "TOOL_CATEGORIES":"Data Source,Workspace Management,Resource Group Management,Data Map,Data Integration,Data Development (New),Operation Center,DataService,Open Platform,Data Quality,Label Management,Security Center,SERVER_IDE_DEFAULT"。 説明 SERVER_IDE_DEFAULT は、個人開発環境のデフォルトの Tool を指します。その他のサービスカテゴリは、DataWorks - OpenAPI 概要 ページの左側のディレクトリツリーで確認できます。 モデルの読み込みパフォーマンスとユーザーエクスペリエンスを向上させるために、デフォルト構成では TOOL_CATEGORIES を SERVER_IDE_DEFAULT に設定します。すべての OpenAPI ツールを有効にするには、この構成項目を削除できます。
   	TOOL_NAMES	Tool 名の許可リストを構成します。ここに OpenAPI 名をコンマで区切って入力します。 例: "TOOL_NAMES":"ListProjects,CreateNode,UpdateNode"。 説明 TOOL_NAMES は DataWorks - OpenAPI 概要 ページで確認できます。

4. 構成を保存した後、ページが読み込まれ、利用可能な Tool のリストが表示された場合、alibabacloud-dataworks-mcp-server は正しくインストールおよび構成されています。これでその機能を使用できます。

   説明

   この情報の読み込みに失敗した場合は、エンジンのアップグレード を実行したことを確認してください。

   

5. DataWorks Agent の機能を拡張するには、cline_mcp_settings.json ファイルを直接編集するか、[マーケットプレイス] から他の MCP サーバーをインストールします。たとえば、DataWorks Agent で Hologres 関連の機能を使用するには、Hologres MCP サーバー に接続できます。