Microsoft 365 Copilot Chat のスキルが一般提供されています。 スキルは、タスク固有の指示、品質基準、オプションのサポート ファイルまたはスクリプトをパッケージ化するため、ユーザーは会話ごとに同じワークフローを繰り返す必要がなくなります。
宣言型エージェントを作成せずに、Copilot Chat で直接使用するスキルを作成できます。 ユーザーは、インストールされているスキルを明示的に選択することも、関連するときに Copilot に自動的に選択させることもできます。 ユーザーは、各スキルの自動呼び出しを制御します。
重要
Microsoft Purview 情報バリア (IB) を使用するテナントでは、Copilot Chat でスキルはサポートされていません。 この制限は、個人のスキルおよびプラグインの一部として配布されるスキルに適用されます。
スキルのスコープを選択する
| ターゲット | 作成と配布のパス |
|---|---|
| Copilot Chat で直接使用する個人スキル | スタンドアロンの SKILL.md ファイルまたはスキル ZIP を作成します。 ユーザーは、 Copilot Chat を使用して個人スキルを作成および編集することもできます。 |
| プラグインの一部として配布されるスキル | Work IQ Dev Tools を使用して Microsoft 365 アプリ パッケージを作成し、サポートされている共有または発行方法を使用します。 |
個人用スキルを作成する
ヒント
スキルをプラグインとしてパッケージ化する場合は、代わりに プラグイン でスキルをパッケージ化 する の手順に従ってください。 Work IQ 開発ツールは、このセクションのほとんどの手順を自動化します。
各スキルには、 SKILL.md という名前のファイルが必要です。 オプションのリソースおよびスクリプトは、タスクで必要な場合にのみ追加します。
release-notes/
|-- SKILL.md
|-- references/
| `-- release-note-format.md
`-- scripts/
`-- format_release_notes.py
名前と説明を含む YAML フロント マターで SKILL.md を開始します。 WIQD プラグイン スキルの場合、名前は含まれるフォルダーと正確に一致する必要があります。 1 - 64 文字の小文字の英数字とハイフンを使用し、先頭、末尾、連続するハイフンは使用しないでください。 説明には 1 から 1,024 文字を含めることができ、スキルをアクティブ化する要求を特定する必要があります。
次に例を示します。
---
name: release-notes
description: Draft release notes or a changelog from a supplied list of changes, grouped into Features, Fixes, and Other.
---
# Release notes
Use this skill when the user asks for release notes or a changelog.
1. Use the change list supplied by the user. If it is missing, ask for it.
2. Group the changes into Features, Fixes, and Other.
3. Use references/release-note-format.md for the output structure.
4. Preserve issue and pull request links from the supplied input.
5. Don't invent changes, links, version numbers, or release dates.
6. Return the draft and identify any missing information.
手順が参照するすべてのファイルを含めます。 たとえば、書式設定スクリプトを追加する場合は、そのスクリプトを実行するタイミング、受け入れる入力、エラーの処理方法を説明します。 資格情報、トークン、シークレットはスキルに含まれないようにします。
設計ガイドライン
スキルの集中を維持する
- 明確な入力、出力、境界を持つ、定義されたジョブを 1 つスキルに与えます。
- ユーザーがそのジョブで使用する可能性が高い語句を説明に含めます。
- 作成に関する推奨事項として、
SKILL.md文字数を 20,000 文字未満にしてください。 詳細な参照資料をサポート ファイルに移動し、いつ読むかを説明します。 - ディレクトリは浅い状態に保ち、タスクに必要なファイルのみを含めます。 各ターゲット ホストのファイル数、ディレクトリ深度、パッケージ サイズの制限を確認します。
サポートされているリソースとスクリプトを追加する
チャット スキル ランタイムでサポートされているファイルの種類を使用します。
| [カテゴリ] | ファイルの種類 |
|---|---|
| 手順とリソース ファイル |
.json, .xml, .yaml, .yml, .ini, .config, .utf8, .docx, .doc, .docm, .pdf, .ppt, .pptx, .ppsm, .xlsx, .xls, .xlsm, .csv, .tsv, .txt, .rtf, .md, .html, .htm, .png, .jpg, .jpeg, .gif, .bmp, .log |
| 上付き/下付き文字 |
.py, .js, .mjs, .cjs, .ts, .mts, .sh, .bash |
チャット スキルとエージェント添付スキルには、個別のアップロード パスがあります。 エージェントビルダーおよびエージェントツールキットの制限を個人のチャットスキルのアップロードに適用しないでください。
スクリプト ランタイムの境界を尊重する
スキル スクリプト:
- 実行時にインターネットまたはネットワークにアクセスできません。
- ランタイムにパッケージをインストールできません。
- ランタイムで既に利用可能なパッケージのみを使用できます。
- 認証されたネットワーク呼び出しを発信できません。
タスクに外部データまたはアクションが必要な場合は、有効なコネクタまたはその他のサポートされている外部機能を Copilot に呼び出しさせます。 代わりとしてスキル スクリプトにネットワーク呼び出しを配置しないでください。
リモート MCP コネクタを含むプラグインの場合は、アプリ マニフェストの agentConnectors 構成を使用します。 スキルの説明書で、Copilot がコネクタを使用するタイミングと理由を説明します。 接続設定とユーザー権限は、スキルの指示とは別に残ります。
データ保護のアカウント
アップロードされたチャット スキル ファイルは、テナント スコープの SharePoint Embedded コンテナーに保存されます。 秘密度ラベルは保持され、ラベル ポリシーは遵守されます。 ユーザー定義のアクセス許可と二重キー暗号化はサポートされていません。
組織の要件に照らし合わせた指示、リソース、スクリプト、データ アクセス、出力を確認します。 広範なソリューションには 、プラン データ、プライバシー、セキュリティ を使用します。
スキルをアップロードする
スキルを直接アップロードする場合は、 SKILL.md 単独で、またはルートに SKILL.md が含まれ、その下のサポート ファイルのある ZIP を指定します。 ZIP で SKILL.md より上の余分な囲みディレクトリを含めないでください。
Copilot Chat で、[エージェント>その他のエージェント] を選択します。 [ 追加] の横にあるドロップダウンを選択し、[ スキルのアップロード] を選択します。
SKILL.md または ZIP ファイルを追加し、[ アップロード] を選択します。
スキルをプラグインにパッケージ化する
Work IQ Dev Tools は、スキルベースのプラグインを作成、検証、プロビジョニング、パッケージ化、共有するためのプロコードワークフローを提供します。
プラグインのビルドの WIQD のインストールと認証の前提条件に従い ます。
プラグイン プロジェクトを作成し、スキルを追加します。
wiqd plugin create --name release-notes-plugin Set-Location release-notes-plugin wiqd plugin add skill --name "Release Notes"設計ガイドラインのガイダンスに従って、生成された
appPackage/skills/release-notes/SKILL.mdを編集し、参照されているリソースまたはスクリプトを追加します。WIQD ワークフローに従って、目的の環境をプロビジョニングし、プラグインをパッケージ化し、実際にビルドされた ZIP を検証します。 ソース検証だけでは、スキル コンテンツを検査したり、実行時の動作を証明したりすることはできません。
プラグインを公開または共有し、目的のユーザーが 使用 できるようにします。
注
Microsoft 365 アプリ マニフェストでは、 agentSkills を通じてプラグイン レベルのスキルが登録されます。 宣言型エージェントは、宣言型エージェント マニフェストの agent_skills を通じてエージェント スコープのスキルを参照します。 これらのプロパティを交換したり、一方のサーフェスでスキルを宣言すると他方のサーフェスでもスキルが登録されると想定したりしないでください。
フォーマットのルール、マニフェストの詳細、およびホスト固有の制約については、 WIQD プラグインの作成リファレンスを参照してください。 チャットとコワークの両方を目的としたスキルは、両方のホストの要件を満たす必要があります。
検出と呼び出しのテスト
サポートする予定の各 Microsoft 365 エクスペリエンスで、インストールされているスキルをテストします。
- 目的のユーザーがスキルを検索して選択できることを確認します。
- スキルを明示的に選択し、代表的な入力を提供し、その出力ファイルとサポート ファイルを確認します。
- 自動呼び出しを有効にし、スキルの説明に一致する要求を使用します。 Copilot が目的のスキルを選択していることを確認します。
- 自動呼び出しをオフにし、スキルが自動的に選択されていないことを確認します。 明示的な選択は別のユース ケースです。
- 入力の欠落、要求のあいまいさ、ツール使用不可、スクリプト エラーをテストします。 不完全な結果を黙って返すのではなく、応答で問題が特定されるようにします。
- プラグインに他の機能が含まれている場合は、それらを一緒にテストします。 目的のコネクタまたは MCP ツールが実際に呼び出されたことを確認します。
- チャットと Cowork の両方をサポートする場合は、両方で検出、インストール、実行を確認します。 ある製品の可用性や編集サポートを、他の製品のテストの成功から推測しないでください。
公開、展開、共有、インストールは別個の手順です。 パッケージのアップロードの成功を、スキルが検出可能であるという証拠として扱うのではなく、対象ユーザーのインストールされたエクスペリエンスを確認します。