Copilot Studio では、スキルを使用することでエージェントを拡張できます。 組織内で特定のシナリオ向けに (Microsoft 365 エージェント SDK またはその他のプロ向けコードツールを使用して) エージェントを構築、展開済みの場合、それらのボットをスキルに変換し、そのスキルを Copilot Studio エージェントに登録できます。
注意
Microsoft Teams 内の Copilot Studio アプリからスキルを追加するには、Microsoft Copilot Studio のスタンドアロン サブスクリプションが必要です。
この記事は、 スキルに精通しているシステム管理者または IT プロフェッショナルを対象としています。
スキルを Copilot Studio エージェントに登録すると、会話内でシームレスにスキル アクションをトリガーできます。
前提条件
重要
Copilot Studio エージェントは、レガシーの Bot Framework SDK バージョン 4.12.0+ および Microsoft 365 エージェント SDK v1.0.0+ を使用して構築されたスキルのみをサポートします。 Microsoft 365 エージェント SDK を使用して新しいスキルを構築する必要があります。
スキルを構成するには、スキルに関連付けられたアプリ登録を Microsoft Entra ID でシングル テナント構成に設定します。
エージェント フローとスキルを使用するタイミング
以下の表は、会話においてエージェント フローとスキルをいつ使用すべきかを判断する際に役立ちます。
| 要素 | エージェント フローを使用するタイミング | スキルを使用するタイミング |
|---|---|---|
| ペルソナ | エージェントの作成者は、エージェントの会話に埋め込むために、再利用可能なフローを構築できる。 | 開発者は、独自の環境でカスタム スキルを作成、展開、およびホストできます。 |
| 会話の種類 | 単純な単一ターンの操作にはフローを使用します。 たとえば、受注したり、受注状態を取得したりします。 | 複雑な複数ターン操作にはスキルを使用します。 たとえば、会議をスケジュールしたり、フライトを予約したりします。 |
| 応答 | フローを使用してエージェントの応答を発行します。 たとえば、パーソナライズされたメッセージやインライン画像を表示します。 | スキルを使用して、サポートされているエージェントの応答を発行します。 たとえば、アダプティブ カードを表示するか、ランダムな応答を送信します。 |
| アクション | フローを使用して、サーバー側の単一ターン アクションをトリガーします。 たとえば、HTTP API を呼び出すか、カスタム コネクタをトリガーします。 | スキルを使用して、サーバー側とクライアント側のイベントとアクションをトリガーします。 たとえば、エージェントの応答時にページに移動します。 |
スキルを構成する
まず、Copilot Studio を使用してエージェントを作成し、プロ向けコードツールを使用してスキルを作成し、組織内に展開します。 次のサンプルを参照してください。
スキルを登録する前に、エージェントがスキルでアクションを呼び出すことを承認するよう、エージェントの ID をスキル開発者に提供します。 スキル許可リストの詳細。 エージェントの ID は スキルの追加 ウィンドウから取得できます。
エージェントにスキルを追加する方法:
エージェントに移動します。
設定>スキル を選択してスキル ページに移動します。
スキルの追加を選択します。
エージェントの ID をコピーします。 エージェントの ID をスキル開発者に提供する必要があります。
スキル マニフェストに URL を入力します。 スキルのマニフェストには、エージェントがスキル内のアクションをトリガーするために必要な情報が含まれています。
次へを選択して検証プロセス を開始します。 検証が成功すると、スキルがエージェントに追加されます。 このスキルをトピックで使用 できます。
コンプライアンスに関する考慮事項
ユーザー プライバシーを保護するために、サインイン ユーザーの Microsoft Entra ID テナントで、アプリとしてスキルを登録することが必要です。
スキル登録時のエラーのトラブルシューティング
一連の検証チェックが URL に対して行われます。 これらのチェックは、エージェントに追加されるスキルのコンプライアンス、ガバナンス、使いやすさを確認します。 スキルを登録する前に、これらのエラーを修正する必要があります。
| エラー メッセージ | トラブルシューティング / 軽減策 |
|---|---|
| スキル マニフェストの取得中に問題が発生しました。 ( MANIFEST_FETCH_FAILED) |
Web ブラウザーでマニフェスト URL を開いてみてください。 URL がページを 10 秒以内に表示する場合は、スキルを再登録します。 |
| マニフェストは互換性がありません。
( MANIFEST_MALFORMED) |
(a) マニフェストは有効な JSON ファイルかどうかを確認します。
(b) マニフェストに必要なプロパティが含まれているかどうかを確認します 例: ( name、msaAppId、単一の endpoint、activities/id、activities/description、activities/type (サポートされている event または message のみ))。 |
| エンドポイントに不一致があります ( MANIFEST_ENDPOINT_ORIGIN_MISMATCH) |
スキル エンドポイントが Microsoft Entra ID アプリケーション登録 Publisher domain (優先) または Home page URL フィールドと一致しているかどうかを確認します。
エンドポイントのホーム ページの設定の詳細。 |
| まず登録してからスキルを追加する必要があります。 ( APPID_NOT_IN_TENANT) |
スキルのアプリケーション ID が組織の Microsoft Entra ID テナントに登録されているかどうかを確認します。 |
| リンクは無効です; リンクは https:// ( URL_MALFORMED, URL_NOT_HTTPS) で始まる必要があります |
リンクを修正して、セキュリティで保護された URL を追加します。 |
| マニフェストが大きすぎます; ( MANIFEST_TOO_LARGE) |
マニフェストのサイズを確認します。 500KB 以下である必要があります。 |
| このスキルはすでにエージェントに追加されています。
( MANIFEST_ALREADY_IMPORTED) |
スキルを削除して、もう一度登録してみてください。 |
| このスキルは 100 件のアクションに制限されています。
( LIMITS_TOO_MANY_ACTIONS) |
スキル マニフェストで定義されているスキル アクションが多すぎます。 アクションをを削除し、やり直してください。 |
| アクションは 25 入力に制限されています。
( LIMITS_TOO_MANY_INPUTS) |
スキル アクションの入力パラメーターが多すぎます。 パラメーターを削除し、やり直してください。 |
| アクションは 25 出力に制限されています。
( LIMITS_TOO_MANY_OUTPUTS) |
スキル アクションの出力パラメーターが多すぎます。 パラメーターを削除し、やり直してください。 |
| エージェントは最大 100 のスキルを持つことができます。
( LIMITS_TOO_MANY_SKILLS) |
エージェントに追加されたスキルが多すぎます。 既存のスキルを削除して、やり直してください。 |
| 問題が発生しました。 ( AADERROR_OTHER) |
スキルの検証中に一時的なエラーが発生しました。 再試行。 |
| スキルの確認中に問題が発生しました。
( ENDPOINT_HEALTHCHECK_FAILED、HEALTH_PING_FAILED) |
スキル エンドポイントがオンラインであり、メッセージに応答しているかどうかを確認します。 また、シングル テナント スキルのアプリ登録が同じテナントに展開されていることを確認します。 |
| このスキルはエージェント ( ENDPOINT_HEALTHCHECK_UNAUTHORIZED) を許可リストに追加していません |
エージェントがスキルの許可リストに追加されているか確認します。 |