DataWorks:拡張機能

エキスパートスイートのインストール

1. Data Agent の左側のナビゲーションペインで、[拡張機能] > [エキスパートスイート] をクリックします。

2. [エキスパートスイート] ページで、[スイートをインストール] をクリックします。

3. [エキスパートスイートのインストール] ダイアログで、インストール方法を選択します。次の 3 つのインストールソースを利用できます：

   • [リモートリポジトリ]：Git リポジトリまたはスイートマーケットプレイスからスイートの内容を取得します。HTTPS Git リポジトリでホストされているスイート、または Claude Marketplace や Gemini Marketplace に公開されているスイートには、このソースを使用します。Ref を使用してブランチ、タグ、またはコミットを固定できます。

   • [npm パッケージ]：npm レジストリからバージョン付きのスイートパッケージをダウンロードしてインストールします。バージョン付きの npm パッケージとして配布されるスイートには、このソースを使用します。パッケージ名に @version を付加して、バージョンを指定します。

   • [ローカルパス / アップロード]：ローカルディレクトリ、またはアップロードしたアーカイブからインストールします。このソースはリポジトリやレジストリに依存しないため、オフライン環境や未公開の社内スイートに適しています。

   リモートリポジトリと npm パッケージの主な違いは次のとおりです。前者は Git リポジトリまたはマーケットプレイスから内容を取得し、Ref でバージョンを固定し、プライベートリポジトリではインスタンス内の Git 認証情報を使用します。後者は npm レジストリから公開されたパッケージアーティファクトを取得し、パッケージ名の @version サフィックスでバージョンを固定し、プライベートレジストリではインスタンスの .npmrc / NPM_TOKEN 設定を使用します。各ソースについて、次の情報を指定します：

   インストールソース	入力	説明
   [リモートリポジトリ]	リポジトリ：次の 3 つの形式のいずれかで、リポジトリ識別子を入力します： owner/repo (例: myorg/my-suite)、HTTPS Git URL、または owner/repo:plugin-name (マルチプラグインリポジトリから 1 つのプラグインをインストールする場合) Ref：(任意) バージョンを固定するブランチ、タグ、またはコミットを入力します。空のままの場合、リポジトリのデフォルトブランチが使用されます。	Claude Marketplace、Gemini Marketplace、または HTTPS Git リポジトリからインストールします。Gemini と Claude のマーケットプレイスを参照できます。マーケットプレイスソースでプラグインが指定されていない場合、インストール時に 1 つ選択します。プライベートリポジトリでは、インスタンス内の Git 認証情報を使用します。
   [npm パッケージ]	パッケージ名：公開済みのスコープ付きパッケージ名を入力します。必要に応じてバージョンも指定できます (例: @scope/my-extension@1.2.0) レジストリ：取得元の npm レジストリです。空のままの場合、インスタンスの .npmrc / NPM_TOKEN 設定が使用されます。	npm レジストリからスコープ付きパッケージをインストールします。owner/repo 形式との混同を避けるため、スコープ付きパッケージ名 (@scope/name) のみをサポートしています。
   [ローカルパス / アップロード]	ローカルディレクトリのパスまたはアーカイブ	ローカルディレクトリまたはアップロードしたアーカイブからインストールします

   説明

   リモートリポジトリは、常にデーモン経由でインストールされます。npm パッケージは、デーモンがサポートしている場合に直接送信されます。ローカルパスとアップロードしたアーカイブでは、引き続きターミナルで data-agent extensions install を実行する必要があります。

4. [インストールを確認] をクリックして、インストールを完了します。インストールが成功したら、[エキスパートスイート] ページで、スイートがリストに表示されていることを確認します。インストールに失敗した場合は、スイートのエントリに表示されるエラーメッセージを確認してください。

インストール済みエキスパートスイートの管理

インストール後、操作メニューからスイートを有効化または無効化します。スイートの有効化と無効化 (一括操作を含む) は、現在のインスタンス内で有効になります：

タスクでのエキスパートスイートの使用

Data Agent のタスク入力ボックスで @ を入力し、メニューから [エキスパートスイート] を選択して、有効化されたエキスパートスイートを参照します。その後、エージェントはスイートに組み込まれた機能 (スキル、MCP サーバーなど) を使用してタスクを完了します。

組み込みスキル

Data Agent には、インストール不要の組み込み DataWorks スキルが付属しています。組み込みスキルを有効にすると、タスクで呼び出すことができます。[スキル] ページで [DataWorks] タブに切り替えると、現在のインスタンスで利用可能な組み込みスキルを表示し、必要に応じて有効化または無効化できます。次の表に、頻繁に使用される組み込みスキルの例を示します。実際のリストは製品の UI の表示に従います。

スキルのインストール

[オープンなスキル] タブで、スキルカードの [インストール] をクリックして、マーケットプレイスのスキルを直接インストールします。カスタムスキルをインストールするには、[スキルのインストール] ダイアログを使用して ZIP パッケージをアップロードするか、インストールコマンドを実行します。

1. Data Agent の左側メニューで、[エクステンション] > [スキル] をクリックします。

2. [スキル] ページで、[スキルのインストール] をクリックします。

3. [スキルのインストール] ダイアログで、インストール方法を選択し、必要な情報を入力します：

   ZIP パッケージのアップロード

   [インストール先] を選択します：

   インストール先	説明
   現在のインスタンスにインストール	インスタンスのローカルにのみ書き込み、プラットフォームにはアップロードしません。既存のローカルスキルを更新できます。
   スキルプラットフォームに公開	クラウドにアップロードして選択したスコープ内で共有し、現在のインスタンスにもインストールします。スコープとして [ワークスペース] または [テナント] を選択する必要があります。

   破線のボックス内をクリックまたはファイルをドラッグして、ZIP パッケージをアップロードします。サポートされているのは .zip ファイルのみで、1 ファイルあたり最大 50 MB です。

   重要

   ZIP パッケージには SKILL.md ファイルが含まれている必要があります。スキル名と説明は SKILL.md のメタデータから読み取られ、他のファイルは相対パスで参照されるリソース添付ファイルとして機能します。制限： SKILL.md ≤ 200 KB、ZIP パッケージ全体 ≤ 50 MB。

   ZIP パッケージは、次の 2 つの構造をサポートしています： SKILL.md とリソースファイルをルートディレクトリに直接配置するか、単一のトップレベルディレクトリ内に配置します：

   # 構造 1： ルートレベル構造
   my-skill.zip
   ├── SKILL.md         # 必須。名前、説明、本文を含みます
   ├── data/sample.csv  # リソース添付ファイル
   └── images/demo.png
   
   # 構造 2： 単一のトップレベルディレクトリラッパー
   my-skill.zip
   └── my-skill/
       ├── SKILL.md         # 必須。名前、説明、本文を含みます
       ├── data/sample.csv  # リソース添付ファイル
       └── images/demo.png

   [インスタンスにインストール] をクリックします。

   コマンドインストール

   [コマンドインストール] テキストボックスに、Qwen Code 用のスキルインストールコマンドを貼り付けます。

   [インストールの実行] をクリックします。

   コマンドインストールには、現在のリソースグループでのパブリックアクセスが必要です。

4. [スキル] ページで、対象のスキルがリストに表示されていることを確認します。

インストール済みスキルの管理

[スキル] ページで、対象のスキルに対して次の操作を実行します：

タスクでのスキルの使用

タスクの入力ボックスに / を入力して、対象のスキルを選択して呼び出します。エージェントは、スキルの事前に定義されたフローに従って現在のタスクを実行します。

MCP サーバーの追加

1. Data Agent の左側メニューで、[エクステンション] > [MCP] をクリックします。

2. [MCP サーバーの追加] をクリックします。

3. [MCP サーバーの追加] ダイアログで、次のパラメーターを設定します：

4. パラメーター	タイプ	必須	説明
   名前	テキスト入力	はい	MCP サーバーの一意の名前
   転送方法	選択	はい	ストリーマブル HTTP (デフォルト)、stdio、または SSE。 違いについては、次の表をご参照ください。
   入力方法	選択	いいえ	手動入力 (デフォルト) または JSON 解析。 JSON 解析を使用すると、JSON 設定を直接貼り付けることができます。

   3 つの転送方法の違い：

   転送方法	接続	ユースケース
   ストリーマブル HTTP	HTTP 経由でリモート MCP サーバーに接続します	ネットワークまたはクラウドにデプロイされた MCP サーバー
   stdio	ローカルプロセスを起動し、標準入出力を介して通信します	ローカルのコマンドライン MCP サーバー (npm パッケージや実行可能ファイルなど)
   SSE	サーバー送信イベント (SSE) の永続的な接続を介してリモートサービスに接続します	SSE プロトコルをまだ使用しているリモートサービス

   選択した転送方法に応じて、異なる接続パラメーターを入力します：

   ストリーマブル HTTP

   パラメーター	必須	説明
   サーバーエンドポイントアドレス	はい	ストリーマブル HTTP エンドポイントの URL (例： https://example.com/mcp)
   リクエストヘッダー	いいえ	1 行に 1 つの KEY=VALUE ペア (例： Authorization=Bearer xxxx)
   タイムアウト	いいえ	接続タイムアウト (ミリ秒単位)。 入力ボックスのヒントは 30000 です。 実際のネットワーク状況に基づいて値を入力してください。

   stdio

   パラメーター	必須	説明
   コマンド	はい	サービスを開始するためのコマンドラインコマンド
   引数	いいえ	コマンドライン引数 (文字列配列)
   環境変数	いいえ	環境変数 (キーと値のペア)
   タイムアウト	いいえ	接続タイムアウト (ミリ秒単位)

   SSE

   パラメーター	必須	説明
   URL	はい	SSE エンドポイントの URL
   リクエストヘッダー	いいえ	1 行に 1 つの KEY=VALUE ペア
   タイムアウト	いいえ	接続タイムアウト (ミリ秒単位)

5. (オプション) [このサービスを信頼する] をオンにします。 有効にすると、信頼された作業ディレクトリでのこのサーバーからのツールの呼び出しは確認が不要になります。

6. [OK] をクリックしてサーバーを作成します。 作成後、[MCP サーバー] リストで、新しく追加されたエントリのステータス列に [Connected] が表示されることを確認してください。 [Needs Auth] が表示された場合は、指示に従って OAuth 認証を完了してください。 [Error] が表示された場合は、アドレス、転送パラメーター、ネットワーク接続を確認し、再試行してください。

既存の MCP サーバーの管理

設定済みの MCP サーバーでは、次のアクションが利用できます：

タスクでの MCP サーバーの使用

タスクの入力ボックスに @ を入力して [MCP リソース] を選択すると、MCP サーバーのリソースを参照できます。 エージェントはタスク実行時に、MCP サーバーが提供する外部ツールとデータソースを呼び出します。