:サードパーティクライアントとの連携：DataWorks Agent

事前準備

• ワークスペースを作成済み であり、[Data Studio (新バージョン) を使用] を選択済みである必要があります。

• （任意。RAM ユーザーの場合のみ必須）タスク開発用の RAM ユーザーをワークスペースに追加し、開発者 または ワークスペース管理者 のロールを付与する必要があります。ワークスペース管理者ロールは広範な権限を持つため、付与には十分にご注意ください。メンバーの追加方法については、「ワークスペースメンバーの追加」をご参照ください。

  Alibaba Cloud アカウントをご利用の場合は、このステップはスキップできます。

• パーソナル開発環境インスタンスを作成しました。

  説明

  個人開発環境が Virtual Private Cloud（VPC）にバインドされている場合、個人開発環境へのインターネットアクセスを構成 する必要があります。

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

以下の手順に従って、個人開発環境を有効化し、アクセスします。

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

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

   • インスタンスのステータスが Running の場合： Personal Development Environment 下の実行中の個人開発環境インスタンスをクリックしてアクセスします。

   • その他のステータスの場合：ポップアップウィンドウで Management Environment をクリックします。Personal Development Environment Instances ページで作成済みのインスタンスを検索し、Start を Actions 列からクリックし、インスタンスステータス が Running に変更されるまで待ちます。その後、インスタンスをクリックして個人開発環境にアクセスします。

   説明

   アイコンが と同様に表示され、Personal Development Environment エリアに表示された場合、個人開発環境にアクセスしたことを意味します。

ステップ 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 互換モードを用いて Alibaba Cloud Model Studio（Bailian）API に接続する方法を示します。

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

2. Cline ページで ご自身の API キーを使用 をクリックし、以下の表に従ってパラメーターを構成します。

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

3. 下部の 始めましょう！ ボタンをクリックして、API キーの構成を完了します。

ステップ 4：MCP Server の構成

API キーの構成を完了した後、以下の手順に従って DataWorks MCP Server に接続・構成します。DataWorks MCP Server の詳細については、「付録：DataWorks MCP Server」をご参照ください。

1. Cline ページで、右上隅の アイコンをクリックして、マーケットプレイス タブの MCP Server に移動します。

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

3. MCP Server の構成 をクリックして、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	現在の DataWorks ワークスペースが配置されているリージョンです。例では cn-shanghai を使用しています。
   	ALIBABA_CLOUD_CREDENTIALS_URI	Alibaba Cloud の認証情報の URI を指定します。 重要 このパラメーターは DataWorks の個人開発環境でのみ有効であり、Alibaba Cloud ユーザーの認証を取得するために使用されます。
   	TOOL_CATEGORIES	Tool カテゴリの許可リストを構成します。OpenAPI のカテゴリをカンマ区切りで入力します。 例："TOOL_CATEGORIES":"Data Sources,Workspace Management,Resource Group Management,Data Map,Data Integration,Data Studio (New Version),Task O&M,Data Service,Open Platform,Data Quality,Tag Management,Security Center,SERVER_IDE_DEFAULT"。 説明 SERVER_IDE_DEFAULT は、個人開発環境におけるデフォルトの Tools を指します。その他のサービスカテゴリは、DataWorks - OpenAPI 概要 ページの左側ディレクトリツリーで確認できます。 モデルの読み込みパフォーマンスおよびユーザーエクスペリエンスを向上させるため、デフォルト構成では TOOL_CATEGORIES が SERVER_IDE_DEFAULT に設定されています。すべての OpenAPI ツールを有効にするには、この構成項目を削除してください。
   	TOOL_NAMES	Tool 名の許可リストを構成します。OpenAPI の名前をカンマ区切りで入力します。 例："TOOL_NAMES":"ListProjects,CreateNode,UpdateNode"。 説明 TOOL_NAMES は、DataWorks - OpenAPI 概要 ページで確認できます。

4. 構成を保存した後、利用可能な Tools の一覧が読み込まれれば、alibabacloud-dataworks-mcp-server のインストールおよび構成が完了したことを確認できます。これで DataWorks MCP Server の機能の利用を開始できます。

   説明

   情報が読み込まれない場合は、プログラムエンジンのスペックアップ を実行済みか確認してください。

   

5. cline_mcp_settings.json 構成ファイルを直接編集するか、マーケットプレイス からその他の MCP Server をインストールすることで、DataWorks Agent の機能を拡張できます。たとえば、DataWorks Agent で Hologres 関連の機能を利用する場合は、Hologres MCP Server に接続できます。