ヒント
推奨事項: サポートされているプロコード宣言型エージェントとプラグイン シナリオ用の Work IQ 開発ツール から始めます。 WIQD クイックスタートを参照してください。 Toolkit ベースの手順は、それらを必要とする既存のプロジェクトおよびワークフローで引き続き使用できます。 ツールを選択する前に 、機能とターゲット エクスペリエンスのサポート を確認します。WIQD はカスタム エンジン エージェントを対象としません。
重要
Microsoft Purview 情報バリア (IB) を使用するテナントでは、管理者はスキルを備えた宣言型エージェントをデプロイできますが、エンド ユーザーは作成した宣言型エージェントにスキルを追加できません。
スキルは、特定のタスクの命令、リソース、スクリプトをパッケージ化するために宣言型エージェントに追加するモジュラー・コンポーネントです。 ビルドまたは 再利用中に、選択したプロジェクトで既に Microsoft 365 Agents Toolkit (ATK) を使用している場合は、この記事を使用します。 エージェントに登録されたスキル、保存されたタスク手順、プロビジョニングされたテストバージョンで終了します。
新しいプロフェッショナル開発者プラグイン プロジェクトの場合は、 Work IQ Dev Tools と 文書化された環境から始めます。 プロジェクト コントロールが選択したエージェント ルートに適合する場合は、この Toolkit プロシージャを保持します。これは、すべてのプラグインに必要なものではありません。
スキルの概要、スキルを使用する理由、および完全なサポート マトリックス、サポートされるファイルの種類、サンドボックスの動作、ガバナンスについては、「 宣言型エージェントのスキル」を参照してください。
このガイドは、エージェント スコープのスキルを追加します。 プラグインを通じて Copilot Chat で直接使用するスキルを配布するには、「Copilot Chat のスキルを構築する」を参照してください。
重要
このガイドは、「 Microsoft 365 Agents Toolkit と JSON を使用して宣言型エージェントを作成する」 チュートリアルを完了していることを前提としています。 スキルを追加するには、宣言型エージェント マニフェスト バージョン 1.9 が必要です。 以前のバージョンの Agents Toolkit で作成されたエージェントを使用している場合は、エージェント マニフェストのバージョンを更新する必要がある場合があります。 詳細については、「 宣言型エージェント マニフェスト リファレンス」を参照してください。
前提条件
エージェント スキルを有効にする
エージェント スキルのサポートは、 TEAMSFX_AGENT_SKILLS 環境変数によって制御されます。 CLI または Visual Studio Code を起動する前に設定します。
Windows (PowerShell) - セッション間で変数を保持するには、ユーザー環境変数に追加します。
[System.Environment]::SetEnvironmentVariable("TEAMSFX_AGENT_SKILLS", "true", "User")macOS または Linux - 変数を設定します:
export TEAMSFX_AGENT_SKILLS=true変数を保持するには、
~/.bashrc、~/.zshrc、または同等のシェル プロファイルにexport行を追加します。
Visual Studio Code 拡張機能のインストール後に変数を設定する場合は、Visual Studio Code を完全に再起動します。
確認:再起動されたツール プロセスでは、TEAMSFX_AGENT_SKILLS が true に設定されます。 ユーザー レベルの Windows 設定では、既に実行されているプロセスは変更されません。
エージェントにスキルを追加する
既存のプロジェクトで、スキルを追加します。 新しいスキルを作成するには、名前と説明を入力します。
atk add skill --name skill-name --description description既存のスキル フォルダーを追加するには、
--fromオプションを使用します。atk add skill --from PATH_TO_SKILL確認:プロジェクトにはスキル ディレクトリと
SKILL.mdが含まれており、宣言型エージェント マニフェストはそのスキルを参照します。 サポート マトリックスに従ってください。このインポート オプションでは、エージェント間での再利用は確立されません。タスクの指示、リソース、サポートされているスクリプトを使用してスキルの
SKILL.mdを編集します。確認:保存されたファイルには、必要なメタデータが保持され、タスク、予想される出力、および境界が記述されます。
宣言型エージェントをプロビジョニングして、環境で使用できるようにします。
atk provision --env local確認:目的のテナントと環境のプロビジョニングは成功します。 意図したエージェントでスキルのタスクをテストします。プロビジョニングが成功しても、ランタイム動作は確立されません。
制限
エージェント ツールキットでは、スキルをディレクトリとして追加し ( .zip は使用できません)、アプリ パッケージ全体は 10 MB に制限されます。 エージェントごとに最大 8 つのスキルを追加でき、ディレクトリの深さは最大 3 個、すべてのスキルで最大 350 個のファイルを追加できます。 完全なサポート マトリックスについては、「 宣言型エージェントのスキル」を参照してください。
エージェントを発行する
独立系ソフトウェア ベンダー (ISV) は、スキルを含む宣言型エージェントを Microsoft Marketplace に送信できます。 Work IQ Dev Tools を使用して、既存の宣言型エージェント プロジェクトから送信可能なパッケージを検証およびビルドします。 プラグイン パッケージの場合、パートナー センター オファーの作成、下書きの一覧への設定、パッケージとイメージのアップロード、個別の承認による認定への提出、状態の追跡を行う wiqd publish pc できます。 パートナー センター アカウントの登録と確認はポータルの手順のままであり、Microsoft が認証と公開を管理します。
前提条件、パッケージの検証、登録の設定、送信、状態の追跡については、「 WIQD を使用してパートナー センターに公開する 」に従ってください。 ポータル提出は依然として代替手段です。 Microsoft Marketplace 提出ガイドを参照してください。 Office アドインの例や構成されたプラグインの想定されるオファーの種類ではなく、確認済みのエージェント提出ルートに従います。
次のステップ
パッケージ & を入力して テスト する コンポーネントを統合してテストします。 エージェントを一般配布する準備ができたら、 Microsoft Marketplace 経由で発行を続行します。