クイックスタート: Work IQ Dev Tools を使用して既存の宣言型エージェントをプラグインとしてパッケージ化する

既存の宣言型エージェントのローカル ソースで Work IQ Dev Tools を使用して、プラグインとして検証、プロビジョニング、パッケージ化、共有します。 このクイックスタートは、new-agent のスキャフォールドではなく、既存のソース プロジェクトから開始します。

重要

wiqd plugin コマンド ツリー全体がアルファ版であり、変更される可能性があります。 このチュートリアルの手順が機能しない場合は、「 Work IQ Dev Tools を使用してプラグインを構築する」で、現在のコマンド、サポートされているコンポーネントの組み合わせ、ターゲット エクスペリエンス、機能要件を確認してください。

ヒント

Watch Work IQ Dev Tools プロンプトから Copilot プラグインをビルドし、 対話型デモでエージェント ストアに公開します。

前提条件

  • アクティブな Copilot サブスクリプションがある GitHub Copilot CLI
  • GitHub Copilot CLI 用の WIQD コーディング アシスタント プラグイン (このセクションのインストール コマンドを参照してください)
  • Node.js 24.15 以降と npm ( PATH で使用可能な)、WIQD CLI およびインストール スクリプト用。 これらのツールは、会話型またはファイルベースのオーサリングを開始するためだけに必要なものではありません。
  • PowerShell 7 以降 (Windows のみ)
  • Copilot にアクセスできる Microsoft 365 アカウント
  • テナントで有効になっているカスタム アプリのアップロード
  • サポートされている宣言型エージェントのソース プロジェクト

GitHub Copilot CLI をインストールした後、WIQD コーディング アシスタント プラグインをインストールします。

copilot plugin install wiqd@awesome-copilot

または、WIQD マーケットプレースを追加し、そこからプラグインをインストールします。

copilot plugin marketplace add microsoft/wiqd
copilot plugin install wiqd@wiqd

インストール後、新しい GitHub Copilot CLI セッションを開始します。

コーディング アシスタント プラグインは作成ガイダンスを提供します。wiqd CLI はインストールされません。 検証コマンドとライフサイクル コマンドを実行する前に、CLI を個別にインストールしてください。 CLI のインストールを wiqd --version で確認し、その前提条件を wiqd doctor でチェックします。

サポートされている開始プロジェクトがあることを確認する

ローカル宣言型エージェント ソース プロジェクトのルート フォルダーから開始します。 フォルダーには、少なくとも次のものが含まれている必要があります。

contoso-support-agent/
|-- appPackage/
|   |-- manifest.json
|   |-- declarativeAgent.json
|   `-- <the instruction and action files referenced by the manifests>
`-- <a supported lifecycle file>

ライフサイクル ファイルには、 m365agents.yml、 m365agents.local.yml、 teamsapp.yml、または teamsapp.local.yml を指定できます。 プロジェクトには、他のフォルダーおよび環境ファイルを含めることができます。

このクイックスタートは、次の場合には適用されません。

  • 公開済みエージェントまたはインストール済みパッケージのみがあり、ローカル ソース プロジェクトはありません。 Work IQ 開発ツールでは、展開されたタイトルからソース プロジェクトを再構築するためにサポートされている方法が文書化されていません。 元のソース リポジトリを回復するか、元のオーサリング ツールを使用します。
  • エージェントは、Agent Builder や Copilot Studio などのマネージド オーサリング エクスペリエンスにのみ存在します。 そのツールの公開および共有手順を使用します。
  • カスタム エンジン エージェントがあります。 この Work IQ Dev Tools ルートでは、宣言型エージェントがサポートされます。
  • エージェント パッケージ .zipのみがあります。 ライフサイクル コマンドには、ソース プロジェクトとそのライフサイクル ファイルが必要です。

既存のプロジェクトがない場合は、「 チュートリアル: Microsoft 365 エージェント ツールキットと JSON を使用して宣言型エージェントを作成する 」の手順に従って、基本エージェントを作成できます。

注:

wiqd plugin importサポートされている Open Plugin、Claude プラグイン、または Cursor プラグイン形式をインポートします。 既存の Microsoft 365 宣言型エージェントのプロジェクトまたはパッケージはインポートされません。 詳細については、「 インポート/エクスポート (相互運用性)」を参照してください。

プラグインを作成する

  1. まだインストールしていない場合は、 Work IQ Dev Tools をインストールします。

  2. プラグインを作成するディレクトリで CLI を開き、次のコマンドを使用してサインインします。

    wiqd auth login --interactive
    
  3. CLI で、copilot コマンドを使用して GitHub Copilot を起動します。

  4. 既存の宣言型エージェント、スキル、または MCP サーバーを使用してプラグインを作成するように GitHub Copilot に依頼します。 例:

    Create a plugin named My Plugin by using the agent in "..\My Agent"
    

プラグイン プロジェクトを検証する

プラグインをプロビジョニングまたはパッケージ化する前に、オフライン ソース検証を明示的に選択してください。 GitHub Copilot CLI で、次のように質問します。

Validate the plugin source offline in the dev environment

オフライン検証 (wiqd plugin validate --mode source --env dev) に対して --mode source を明示的に選択します。モードを省略すると、既定でパッケージ検証になります。 ソース検証では、保存された宣言型エージェントのソースと参照、および基本的なプラグイン プロジェクト ガードがチェックされます。 スキル、ルート コネクタ、または完全なアプリ パッケージは完全に検証されず、パスではランタイム動作が確立されません。

プラグインをプロビジョニングする

重要

この例では、標準の共有 dev 環境を使用します。 共有をプロビジョニングする前に、有効なライフサイクル構成と選択した環境ファイルを environmentFolderPath (既定の env) で AGENT_SCOPE=shared を確認します。 dev という名前の環境だけでは、共有スコープは確立されません。 プロビジョニング、パッケージ化、検証、共有について同じ環境を維持します。

プラグインのプロビジョニングを GitHub Copilot に依頼します。

Provision the plugin using the dev environment

作成処理が完了するまで待機するかどうかを指定します。 プロビジョニングでは、Copilot Chat ですべてのプラグイン機能を使用できるというわけではありません。サポートは、コンポーネントと対象の Microsoft 365 エクスペリエンスによって異なります。

プラグインをパッケージ化する

プラグインをパッケージ化するように GitHub Copilot に依頼します。

Package the plugin using the dev environment

重要

パッケージ化する前にプラグインをプロビジョニングする必要があります。 プロビジョニングする前にパッケージ化すると、結果のパッケージは無効になります。

パッケージを検証する

パッケージ化した後、生成された ZIP を見つけて、ファイルが存在することを確認します。 GitHub Copilot CLI で、実際のパスを提供し、次のように質問します。

Validate this existing plugin ZIP in package mode using the dev environment

パッケージの検証では、自動ビルドではなく、--package-file で提供される --mode package と既存の ZIP が使用されます。 返された判定と結果を確認します。 終了コード 0 は、選択したチェックに合格したことを意味します。警告は引き続き報告できます。 ブロッキング結果や不完全な結果は合格ではなく、パッケージ検証ではランタイム動作が証明されません。

現在の検証モードは、 source、 package、 marketplace です。 sourceは、明示的なオフライン チェックです。 既定の package では、既存の ZIP が必要で、キャプチャされたコピーが Microsoft 365 検証サービスにアップロードされ、認証が必要になる場合もあります。 marketplace ポリシーと証拠のチェックを追加します。ストアの公式承認ではありません。 検証では、ZIP の構築、サインイン、プラグインのプロビジョニングは自動的には行われません。 詳細については、「 検証と MVL」を参照してください。

プラグインを共有する

GitHub Copilotに、organization内の特定のユーザーまたはorganization全体とプラグインのデプロイを共有するように依頼できます。 共有する前に、選択した環境で AGENT_SCOPE=shared を確認します。 共有対象ユーザー (--scope users または --scope tenant) では、展開スコープは変更されません。

Share the plugin with AmberR@contoso.com using the dev environment

または

Share the plugin with my organization using the dev environment

重要

カスタムプラグインの共有は、プラグインの共有を許可またはブロックするためのorganizationの設定によって異なります。 この手順でエラーが発生した場合は、管理者にチェックしてください。 詳細については、「 エージェントの共有と公開の設定」を参照してください。

プラグインを organization's plugin registry に公開する

プラグインを共有する代わりに、プラグインを organization のプラグイン レジストリに公開するようにリクエストできます。 organization の管理者はプラグインを確認し、リクエストを承認または拒否できます。

Submit my plugin to the organization catalog for admin approval using the dev environment

共有により直接アクセスが許可されます。カタログの提出は別の操作であり、管理者の承認や完了したユーザーのインストールではありません。

パッケージを削除する (オプション)

このプラグインが単なるテスト プラグインの場合は、プラグインを削除するように GitHub Copilot に依頼してください。 この操作により、プロビジョニングされたクラウド リソースがすべて削除されます。

Delete the plugin using the dev environment