Microsoft 365 Agents Toolkit で作成された宣言型エージェントにスキルを追加する

ヒント

推奨事項: サポートされているプロコード宣言型エージェントとプラグイン シナリオ用の 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 設定では、既に実行されているプロセスは変更されません。

エージェントにスキルを追加する

  1. 既存のプロジェクトで、スキルを追加します。 新しいスキルを作成するには、名前と説明を入力します。

    atk add skill --name skill-name --description description
    

    既存のスキル フォルダーを追加するには、 --from オプションを使用します。

    atk add skill --from PATH_TO_SKILL
    

    確認:プロジェクトにはスキル ディレクトリとSKILL.mdが含まれており、宣言型エージェント マニフェストはそのスキルを参照します。 サポート マトリックスに従ってください。このインポート オプションでは、エージェント間での再利用は確立されません。

  2. タスクの指示、リソース、サポートされているスクリプトを使用してスキルの SKILL.md を編集します。

    確認:保存されたファイルには、必要なメタデータが保持され、タスク、予想される出力、および境界が記述されます。

  3. 宣言型エージェントをプロビジョニングして、環境で使用できるようにします。

    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 経由で発行を続行します。