Power Virtual Agents で使用できるスキルを実装する
この記事の対象: SDK v4
スキルは、他のボットから使用できるボットです。 そのため、ユーザー向けに 1 つのボットを作成し、1 つ以上のスキルを使用してそれを拡張することができます。 スキル全般の詳細については、「スキルの概要」を参照してください。構築方法については、「スキルを実装する」を参照してください。 また、仮想アシスタント テンプレートには、ゼロから構築するのではなく、カスタマイズしてデプロイできる一連の事前に構築されたスキルが含まれています。
Power Virtual Agents ボットから使用されると想定されるスキルの場合は、スキルについて考慮する必要がある追加の制限がいくつかあります。
マニフェストの制限事項
Power Virtual Agents によって、スキル マニフェストで宣言できる内容に制限が課せられます。
- 宣言できるアクションは 100 個以下です。
- 各アクションは、25 個以下の入力または出力に制限されています。
- 入力または出力に配列型を使用することはできません。
同じテナントの制限
Power Virtual Agents 内で使用するために登録されているカスタム スキルのコンプライアンスと適切なガバナンスを確保するには、スキル ボットが Microsoft Entra ID に登録されているアプリケーションである必要があります。 スキルを追加すると、スキルのアプリケーション ID がサインインしたユーザーのテナント内にあり、スキルエンドポイントが登録済みアプリケーションの Home Page URL と一致するかどうかが検証されます。
ボットを Power Virtual Agents 内でスキルとして登録する前に、そのボットについて、ボットのスキル マニフェストの URL に Azure portal のホーム ページを確実に設定する必要があります。
スキルの登録中に実行される検証
エンド ユーザーが Power Virtual Agents ボットからスキルに接続する場合、まずスキルを Power Virtual Agents にインポートする必要があります。 スキルによって一連の検証チェックが実行されます。 これらのチェックのいずれかが失敗すると、次の表に示すエラー メッセージが表示される場合があります。
| 検証手順 | エラー コード | エラー メッセージ | 説明または軽減策 |
|---|---|---|---|
| マニフェスト 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 |
スキルの確認中に問題が発生しました。 | Power Virtual Agents は、EndOfConversation アクティビティをスキルに送信するときに不明な応答を受信しました。 スキルが正常に動作し、応答していることを確認します。 |
| スキルが承認されています | ENDPOINT_HEALTHCHECK_UNAUTHORIZED |
このスキルでは、ご利用のボットが許可リストに登録されていません。 | ご利用のボットがスキルの許可リストに追加されているかどうかを確認します。 詳細については、Power Virtual Agents のスキルの構成方法に関する記事をご覧ください。 |