クイックスタート: Work IQ Dev Tools を使用して最初のプラグインを作成する

Work IQ Dev Toolsコマンドラインインターフェイス(CLI)を使用すると、既存の宣言型エージェント、スキル、またはモデルコンテキストプロトコル(MCP)サーバーをプラグインとしてパッケージ化できます。 CLI では、パッケージの検証、プラグインのプロビジョニング、テナントとの共有もできます。

重要

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

前提条件

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

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

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 がプラグインを自動的に検証しなかった場合は、プロビジョニングまたはパッケージ化する前にプロジェクトを検証するように依頼します。

Validate the plugin

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

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

Provision the plugin using the dev environment

作成処理が完了するまで待機するかどうかを指定します。 これで、Microsoft Copilot Chat でプラグインをテストできます。

重要

エージェント共有を有効にするには、プロジェクトの dev 環境を使用してプラグインをプロビジョニングする必要があります。

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

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

Package the plugin

重要

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

パッケージを検証する

パッケージ化されたプラグインの検証を GitHub Copilot に依頼します。 この手順では、生成された ZIP パッケージに対してより詳細な検証を実行します。

Validate the packaged zip

プラグインを共有する

これで、GitHub Copilot にパッケージを共有するよう依頼できます。これは、organization 内の特定のユーザーまたはグループ、または organization 全体と共有することです。

Share the plugin with AmberR@contoso.com

または

Share the plugin with my organization

重要

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

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

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

Publish my package to the plugin registry so all users in my tenant can use it

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

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

Delete the plugin

関連コンテンツ

  • Last updated on