Copilot Studio で使用するスキルを実装する
この記事の対象: SDK v4
スキルは、他のボットから使用できるボットです。 そのため、ユーザー向けに 1 つのボットを作成し、1 つ以上のスキルを使用してそれを拡張することができます。 スキル全般の詳細については、「スキルの概要」を参照してください。構築方法については、「スキルを実装する」を参照してください。 また、Virtual Assistant テンプレートには、ゼロから構築するのではなく、カスタマイズしてデプロイできる一連の事前構築済みスキルが含まれています。
スキルが Copilot Studio のコパイロットから使用されることが予想される場合は、スキルに関するその他の制限を考慮する必要があります。
マニフェストの制限事項
Copilot Studio では、スキル マニフェストで宣言できる内容について、制限が設けられています。
- 宣言できるアクションの数は、最大で 100 個のみです。
- 各アクションは、25 個以下の入力または出力に制限されています。
- 入力または出力に配列型を使用することはできません。
同じテナントの制限
Copilot Studio 内で使用するために登録されているカスタム スキルのコンプライアンスと適切なガバナンスを確保するには、スキル ボットが Microsoft Entra ID に登録されているアプリケーションである必要があります。 スキルを追加すると、スキルのアプリケーション ID がサインインしたユーザーのテナント内にあり、スキルエンドポイントが登録済みアプリケーションの Home Page URL と一致するかどうかが検証されます。
ボットを Copilot Studio 内でスキルとして登録する前に、そのボットについて、Azure portal のホーム ページをボットのスキル マニフェストの URL に確実に設定する必要があります。
スキルの登録中に実行される検証
エンドユーザーがコパイロットからスキルに接続する場合は、まずスキルを Copilot Studio にインポートする必要があります。 スキルに対して、一連の検証チェックが行われます。 これらのチェックのいずれかが失敗すると、次の表に示すエラー メッセージが表示される場合があります。
| 検証手順 | エラー コード | エラー メッセージ | 説明または軽減策 |
|---|---|---|---|
| マニフェスト URL が有効です | URL_MALFORMED, URL_NOT_HTTPS |
The link isn't valid; The link must begin with https:// (リンクは無効です。リンクは https:// で始まる必要があります) | セキュリティで保護された URL としてリンクを再入力します。 |
| マニフェストは取得可能です | MANIFEST_FETCH_FAILED |
We ran into problems getting the skill manifest. (スキル マニフェストの取得中に問題が発生しました。) | マニフェスト URL がマニフェストへのリンクであることを確認します。Web ブラウザーでマニフェスト URL を開いてみてください。 URL がページを 10 秒以内に表示する場合は、スキルを再登録します。 |
| マニフェストは読み取り可能です | MANIFEST_TOO_LARGE |
マニフェストが大きすぎます。 | マニフェストは 500 KB 以下である必要があります。 |
| マニフェストは読み取り可能です | MANIFEST_MALFORMED |
マニフェストは互換性がありません。 | マニフェストが有効な JSON ファイルかどうかを確認します。 マニフェストに必要なプロパティ (name、msaAppId、など) が含まれているかどうかを確認します。 詳細については、「マニフェストの制限事項」をご覧ください。 |
| スキルがまだ登録されていません | MANIFEST_ALREADY_IMPORTED |
このスキルはすでにボットに追加されています。 | スキルを削除してから、再び登録してください。 |
| マニフェスト エンドポイントとホームページのドメインが一致しています | MANIFEST_ENDPOINT_ORIGIN_MISMATCH |
There's a mismatch in your skill endpoints. (スキル エンドポイントに不一致があります。) | Microsoft Entra ID アプリのホームページ URL ドメインとマニフェスト URL ドメインは一致している必要があります。 「同じテナントの制限」を参照してください |
| スキルは、サインイン中のユーザーのテナントでホストされています | APPID_NOT_IN_TENANT |
To add a skill, it must first be registered. (スキルを追加するには、事前に登録する必要があります。) | 全体管理者は、サインインしたユーザーの組織にスキルを登録する必要があります。 |
| アクションが制限されています | LIMITS_TOO_MANY_ACTIONS |
このスキルは 100 件のアクションに制限されています。 | スキル マニフェストで定義されているスキル アクションが多すぎます。 アクションをを削除し、やり直してください。 |
| アクション入力パラメーターが制限されています | LIMITS_TOO_MANY_INPUTS |
アクションは 25 入力に制限されています。 | スキル アクションの入力パラメーターが多すぎます。 パラメーターを削除し、やり直してください。 |
| アクション出力パラメーターが制限されています | LIMITS_TOO_MANY_OUTPUTS |
アクションは 25 出力に制限されています。 | スキル アクションの出力パラメーターが多すぎます。 パラメーターを削除して、もう一度やり直してください。 |
| スキル数が制限されています | LIMITS_TOO_MANY_SKILLS |
Your bot can have a maximum of 25 skills. (ボットのスキル数は最大 25 個です。) | ボットに追加されたスキルが多すぎます。 既存のスキルを削除して、やり直してください。 |
| セキュリティ トークンが有効です | AADERROR_OTHER |
It looks like something went wrong. (問題が発生した可能性があります。) | スキルをトリガーするためのセキュリティ トークンを取得する際に、一時的なエラーが発生している可能性があります。 スキルのインポートを再試行してください。 |
| スキルは正常です | ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED |
スキルの確認中に問題が発生しました。 | Copilot Studio で、EndOfConversation アクティビティをスキルに送信するときに不明な応答を受信しました。 スキルが正常に動作し、応答していることを確認します。 |
| スキルが承認されています | ENDPOINT_HEALTHCHECK_UNAUTHORIZED |
このスキルでは、ご利用のボットが許可リストに登録されていません。 | ボットがスキルの許可リストに登録されているかどうかを確認します。 詳細については、Copilot Studio でスキルを構成する方法を参照してください。 |