DataWorks:DataWorks Agent と MCP

(オプション) 基盤となるエンジンのアップグレード

以前の個人開発環境を使用している場合、または個人開発環境に Cline 拡張機能を既にインストールしている場合は、次のいずれかの方法を使用して既存の基盤となるエンジンをアップグレードして拡張機能を使用できます。 アップグレード操作を既に実行している場合は、このセクションをスキップできます。

ワンクリックアップグレード: 個人開発環境にアクセスした後に基盤となるエンジンの適応アップグレードを示すメッセージが表示された場合は、[ワンクリックアップグレード] をクリックしてアップグレードを完了します。

コマンドベースのアップグレード: 下部ツールバーの左側にある アイコンをクリックして、[ターミナル] タブに移動します。 [ターミナル] タブで次のコマンドを入力し、Enter キーを押してアップグレードを実行します。

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. Data Studio ページの左側のナビゲーションペインにある アイコンをクリックします。

2. [拡張機能] ペインの検索ボックスに Cline と入力します。

3. 下に表示される Cline 拡張機能を見つけます。

4. Cline 拡張機能の右下隅にある [インストール] をクリックし、インストールが完了するまで待ちます。

5. インストールが完了したら、Data Studio ページの左側のナビゲーションペインにある アイコンを右クリックし、[キーバインドの構成] を選択するか、[移動先] > セカンダリサイドバー または [移動先] > パネル を選択して対応する操作を実行します。

API キーを構成する

Cline 拡張機能がインストールされたら、次の手順を実行して API キーを構成します。 この例では、OpenAI 互換モードで接続された Alibaba Cloud Model Studio API を使用します。

1. Data Studio ページの左側のナビゲーションペインにある アイコンをクリックします。

2. CLINE ペインで [独自の API キーを使用する] をクリックし、パラメーターを構成します。 次の表にパラメーターを示します。

   パラメーター	説明
   API プロバイダー	使用する API サービスプロバイダー。 ドロップダウンリストから OpenAI Compatible を選択します。 これは、OpenAI API と互換性のあるインターフェースを使用して Alibaba Cloud Model Studio API に接続することを示します。
   ベース URL	API サービスのベース URL。API リクエストのルートアドレスを指定するために使用されます。 たとえば、Alibaba Cloud Model Studio API によって提供され、OpenAI と互換性のある次の API 宛先アドレスを入力します: https://dashscope.aliyuncs.com/compatible-mode/v1。
   API キー	リクエストが有効であることを確認するための身分認証に使用されるキー。 Alibaba Cloud Model Studio コンソール から API キーを取得します。
   モデル ID	使用するモデル。 モデルによって、機能とパフォーマンスが異なる場合があります。 qwen-coder-plus または qwen-plus を選択します。 これら 2 つのオプションは、異なる事前学習済みモデルを表します。 qwen-coder-plus: コード生成とプログラミングタスクに適しています。 qwen-plus: 一般的なテキスト生成と処理タスクに適しています。

3. [開始] をクリックして、API キーの構成を完了します。

MCP サーバーに接続する

API キーの構成が完了したら、次の手順を実行して MCP サーバーに接続します。

1. CLINE ペインの右上隅にある アイコンをクリックします。 マーケットプレイスMCP サーバー セクションの タブが表示されます。

2. [インストール済み] タブをクリックします。

3. [MCP サーバーの構成] をクリックします。 次に、右側に表示される構成タブに次の情報を入力します。 ビジネス要件に基づいて複数の MCP サーバーを構成できます。

   説明

   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		alibabacloud-dataworks-mcp-server と入力します。これは、DataWorks MCP Server の命令パラメーターを示します。
   env	REGION	ワークスペースが存在するリージョン。 このパラメーターを ワークスペースが存在するリージョンの識別子 に設定します。
   	ALIBABA_CLOUD_CREDENTIALS_URI	Alibaba Cloud クレデンシャルを取得するための URI。 このパラメーターを http://localhost:7002/api/v1/credentials/0 に設定します。これは、個人開発環境によって提供されるデフォルトの URI です。 重要 RAM ユーザーを使用してタスクを開発する場合は、このパラメーターを http://localhost:7002/api/v1/credentials/1 に設定する必要があります。
   	TOOL_CATEGORIES	tool カテゴリ。 API 操作カテゴリを指定し、複数のカテゴリをコンマ（,）で区切ります。 例: "TOOL_CATEGORIES":"データソース,スペース管理,リソースグループ管理,データマップ,Data Integration,データ開発,オペレーションセンター,DataService Studio,オープンプラットフォーム,Data Quality,タグ管理,セキュリティセンター,SERVER_IDE_DEFAULT"。 説明 SERVER_IDE_DEFAULT は、個人開発環境のデフォルトの tool カテゴリです。 OpenAPI ポータルの DataWorks - 概要ページの左側のナビゲーションツリーで他のカテゴリを表示できます。 カテゴリには、データソース、スペース管理、リソースグループ管理、データマップ、Data Integration、データ開発、オペレーションセンター、DataService Studio、オープンプラットフォーム、Data Quality、タグ管理、セキュリティセンターが含まれます。
   	ツール名	tool 名。 API 操作名を指定します。 複数の名前をコンマ（,）で区切ります。 例: "TOOL_NAMES":"ListProjects,CreateNode,UpdateNode"。 説明 このパラメーターの設定は、OpenAPI ポータル内の DataWorks - 概要ページで確認できます。

4. 構成が完了したら、 Ctrl+S を押して、MCP サーバーの構成を保存して読み込みます。

5. ［インストール済み］タブに次の図のような情報が表示されている場合は、DataWorks MCP Server がインストールされています。その後、DataWorks MCP Server を使用できます。

   説明

   次の図のような情報が表示されない場合は、基盤となるエンジンをアップグレードしたかどうかを確認してください。