宣言型エージェントのスキル

この記事では、宣言型エージェントにアタッチされたスキルについて説明します。 エージェントを作成せずに Microsoft 365 Copilot Chat で直接使用するスキルを作成するには、「Copilot Chat のスキルの構築」を参照してください。 この記事のサポート マトリックスは、すべてのスキルやプラグイン パッケージではなく、エージェント スコープのスキルに適用されます。

重要

Microsoft Purview 情報バリア (IB) を使用するテナントでは、管理者はスキルを備えた宣言型エージェントをデプロイできますが、エンド ユーザーは作成した宣言型エージェントにスキルを追加できません。

スキルは、宣言型エージェントが特定のタスクをより確実かつ反復的に実行できるようにするために追加するモジュール機能です。 スキルは、必要な SKILL.md ファイルに加えて、オプションのリソース ファイルとスクリプトを含むファイル ディレクトリです。 SKILL.md ファイルには、モデルにタスクを完了するよう指示する命令が保持されます。

スキルは宣言型エージェントの別個の構成要素です。 以前のガイダンスでは、 スキル という言葉は、エージェントの指示内にインラインで記述したタスクの説明を指していました。 スキルはそのアプローチに取って代わります: タスクの詳細を指示に直接記述する代わりに、エージェントが参照する別のコンポーネントとしてパッケージ化します。 命令でスキルを参照する方法のガイダンスについては、「 宣言型エージェントの効果的な指示を記述する」を参照してください。

Agent Builder または Microsoft 365 Agents Toolkit を使用して、宣言型エージェントにスキルを追加できます。

スキルとは

スキルは、次の内容を含むディレクトリです。

  • 以下を含む必要な SKILL.md ファイル。
    • YAML フロント マターのスキル名と説明。
    • スキルの指示。これは 20,000 文字未満である必要があります。
  • テンプレート、参照データ、定義などのオプションのリソース ファイル。
  • オプションのスクリプトとサポート フォルダー。

たとえば、財務チームは、レビューを作成するための指示、データを変換してグラフを生成するスクリプト、財務モデル、KPI 定義、ブランド化されたスライド テンプレートなどの資産をバンドルした四半期ごとのビジネス レビュー スキルを構築することができます。 ユーザーがそのタスクを要求すると、エージェントはスキルを使用します。

宣言型エージェントでスキルを使用する理由

スキルは、より信頼性が高く反復可能なエージェント ワークフローを構築するのに役立ちます。

  • コンテキストの使用が最適化され、精度が向上しました。 スキルはプログレッシブ開示を使用します:モデルは、タスクが必要とする場合にのみ、スキルの指示とコンテンツをコンテキストにロードします。 スキルライブラリが増大しても、エージェントのコンテキストは焦点を合わせたままです。 また、モデル生成コードに依存するのではなくスクリプトを提供することで、ワークフローの再現性も向上します。
  • 品質を損なうことなく命令をスケーリングします。 複雑な命令をモジュール式の再利用可能なスキルに分解できます。 この方法により、命令に従う品質を損なうことなく、また宣言型エージェント命令の 8,000 文字の制限に達することなく、より長く、より具体的なガイダンスを提供できます。
  • 再利用可能な資産をパッケージ化します。 命令、リソース、スクリプトをスキルとしてパッケージ化し、その機能を宣言型エージェントに統合できます。
  • エンタープライズ対応。 スクリプトは安全なサンドボックスで実行され、スキル ファイルの秘密度ラベルは保持および尊重され、管理ガバナンスが利用可能です。

サポート マトリックス

Agent BuilderまたはAgents Toolkitのどちらでスキルを追加するかによって、一部の制限が異なります。

アイテム エージェント ビルダー エージェント ツールキット
エージェントあたりの最大スキル 8 8
スキル パッケージ 圧縮 .zip、最大 50 MB スキル ディレクトリ。 .zip はサポートされていません
最大ファイル サイズ ファイルあたり 25 MB スキルレベルの制限はありません。アプリ パッケージ全体は 10 MB に制限されています
パッケージあたりの最大ファイル数 すべてのスキルで 350 ファイル すべてのスキルで 350 ファイル
個々のアップロードからスキルを構築する サポートされていません。完了したファイルをアップロードする .zip 完全なスキル ディレクトリを追加またはインポートする
ディレクトリ階層 ディレクトリの最大深度は 3 です ディレクトリの最大深度は 3 です
エージェント間での再利用 サポート対象外 サポート対象外

サポートされているファイルとスクリプトの種類

スキルには、次のファイルの種類を含めることができます。

カテゴリ ファイルの種類
手順とリソース ファイル .json, .xml, .yaml, .yml, .ini, .config, .utf8, .docx, .doc, .docm, .pdf, .txt, .rtf, .md, .ppt, .pptx, .ppsm, .xlsx, .xls, .xlsm, .csv, .tsv, .html, .htm, .png, .jpg, .jpeg, .gif, .bmp, .log
スクリプトとバイナリ .py, .js, .mjs, .cjs, .ts, .mts, .sh, .bash

スクリプト実行サンドボックス

スキル スクリプトはセキュリティで保護されたサンドボックスで実行されますが、次の制限があります。

機能 サポート
スクリプトからのインターネットまたはネットワーク アクセス サポートされていません。 サンドボックスには、実行時にネットワーク アクセス権がありません。
パッケージのインストール サポートされていません。 スキルは、実行時にパッケージをインストールできません。
スクリプトからの認証済みネットワーク呼び出し サポートされていません。
プレインストールされたパッケージ スキルは、サンドボックスに既に存在するパッケージを使用できます。 利用可能が確認されていない限り、パッケージに依存しないでください。
コネクタ、API プラグイン、MCP サーバー エージェントは、オーケストレータを介して有効な機能を使用できます。 スクリプトは、サンドボックスを介してそれらを呼び出すことはできません。

秘密度とストレージ

アイテム サポート
秘密度ラベル サンドボックスは秘密度ラベルを保持し、ラベル ポリシーを尊重します。 ユーザー定義のアクセス許可や二重キー暗号化はサポートされていません。
ストレージ システムは、アップロードされたスキル ファイルをテナント スコープの SharePoint Embedded コンテナーに格納します。