Power Virtual Agents で使用できるスキルを実装するImplement a skill for use in Power Virtual Agents

適用対象: SDK v4APPLIES TO: SDK v4

スキルは、他のボットから使用できるボットです。A skill is a bot that can be used by another bot. そのため、ユーザー向けに 1 つのボットを作成し、1 つ以上のスキルを使用してそれを拡張することができます。In this way you can create a single user-facing bot and extend it with one or more skills. スキル全般の詳細については、「スキルの概要」を参照してください。構築方法については、「スキルを実装する」を参照してください。You can learn more about skills in general in Skills Overview, and how to build them in Implement a skill. また、仮想アシスタント テンプレートには、ゼロから構築するのではなく、カスタマイズしてデプロイできる一連の事前に構築されたスキルが含まれています。Alternatively, the Virtual Assistant templates contain a set of pre-built skills you can customize and deploy instead of building one from scratch.

スキルが パワー仮想エージェント ボットから使用されることが予想される場合、お客様のスキルについて考慮する必要がある追加の制限がいくつかあります。If you expect that your skill will be consumed from a Power Virtual Agents bot, there are some additional restrictions placed on your skill you'll need to account for.

マニフェストの制限事項Manifest restrictions

Power Virtual Agents によって、スキル マニフェストで宣言できる内容に制限が課せられます。Power Virtual Agents places restrictions on what you may declare in your skill manifest.

  • 宣言できるのは、100以下のアクションだけです。You may declare only 100 or fewer actions.
  • 各アクションは、25 個以下の入力または出力に制限されています。Each action is limited to 25 or fewer inputs or outputs.
  • 入力または出力に配列型を使用することはできません。You cannot use the array type for inputs or outputs.

同じテナントの制限Same-tenant restriction

Power Virtual Agents 内で使用するために登録されているカスタム スキルのコンプライアンスと適切なガバナンスを確保するには、スキル ボットが Azure Active Directory に登録されているアプリケーションである必要があります。In order to ensure compliance and adequate governance of custom skills being registered for use within Power Virtual Agents, your skill bot must be a registered application in Azure Active Directory. スキルを追加すると、スキルのアプリケーション ID がサインインしたユーザーのテナント内にあり、スキルエンドポイントが登録済みアプリケーションの Home Page URL と一致するかどうかが検証されます。Upon adding a skill, we validate if the skill's application ID is the in the tenant of the signed in user and the skills endpoint matches the registered application's Home Page URL.

ボットを Power Virtual Agents 内でスキルとして登録する前に、そのボットについて、ボットのスキル マニフェストの URL に Azure portal のホーム ページを確実に設定する必要があります。Before you can register your bot as a skill within Power Virtual Agents, you must ensure that for the bot, the home page in the Azure Portal is set to the bot's skill manifest URL.

スキルの登録中に実行される検証Validation performed during registering a Skill

エンド ユーザーが Power Virtual Agents ボットからスキルに接続する場合、まずスキルを Power Virtual Agents にインポートする必要があります。When an end user attempts to connect to your skill from their Power Virtual Agents bot, they'll first need to import the skill to Power Virtual Agents. スキルによって一連の検証チェックが実行されます。Your skill will go through a series of validation checks. これらのチェックのいずれかが失敗すると、次の表に示すエラー メッセージが表示される場合があります。A failure of one of these checks may result in an error message as described in this table.

検証手順Validation step エラー コードError code エラー メッセージError message 説明または軽減策Description or mitigation
マニフェスト URL は有効ですManifest URL is valid URL_MALFORMED, URL_NOT_HTTPSURL_MALFORMED, URL_NOT_HTTPS The link isn't valid; The link must begin with https:// (リンクは無効です。リンクは https:// で始まる必要があります)The link isn't valid; The link must begin with https:// セキュリティで保護された URL としてリンクを再入力します。Re-enter the link as a secure URL.
マニフェストを取得するManifest is retrievable MANIFEST_FETCH_FAILED We ran into problems getting the skill manifest. (スキル マニフェストの取得中に問題が発生しました。)We ran into problems getting the skill manifest. マニフェスト URL がマニフェストへのリンクであることを確認します。web ブラウザーでマニフェストの URL を開いてみてください。Verify your manifest URL is a link to your manifest; try opening your manifest URL in a web browser. URL が10秒以内にページをレンダリングする場合は、スキルを再登録します。If the URL renders the page within 10 seconds, re-register your skill.
マニフェストは読み取り可能ですManifest is readable MANIFEST_TOO_LARGE マニフェストが大きすぎます。The manifest is too large. マニフェストは 500 KB 以下である必要があります。Your manifest must be 500 KB or less.
マニフェストは読み取り可能ですManifest is readable MANIFEST_MALFORMED マニフェストに互換性がありません。The manifest is incompatible. マニフェストが有効な JSON ファイルであるかどうかを確認します。Check if the manifest is a valid JSON file. マニフェストに必要なプロパティ (、など) が含まれているかどうかを確認し name msaAppId ます。Check if the manifest contains required properties, such as name, msaAppId, and so on. 詳細については、「 マニフェストの制限 」を参照してください。See Manifest restrictions for more information.
スキルがまだ登録されていませんSkill is not yet registered MANIFEST_ALREADY_IMPORTED This skill has already been added to your bot. (このスキルは既にボットに追加されています。)This skill has already been added to your bot. スキルを削除し、もう一度登録してください。Delete the skill and register it again.
マニフェストエンドポイントとホームページのドメインが一致するManifest endpoint and homepage domains match MANIFEST_ENDPOINT_ORIGIN_MISMATCH There's a mismatch in your skill endpoints. (スキル エンドポイントに不一致があります。)There's a mismatch in your skill endpoints. アプリのホームページの URL ドメインとマニフェストの URL ドメインが一致する必要があり Azure AD。You Azure AD app's homepage URL domain and manifest URL domain must match. 同じテナントの制限」を参照してくださいSee Same-tenant restriction
スキルはサインインしているユーザーのテナントでホストされていますSkill is hosted in signed in user's tenant APPID_NOT_IN_TENANT To add a skill, it must first be registered. (スキルを追加するには、事前に登録する必要があります。)To add a skill, it must first be registered. 全体管理者は、サインインしたユーザーの組織にスキルを登録する必要があります。A global administrator must register the skill into the signed in user's organization.
アクションは制限されていますActions are limited LIMITS_TOO_MANY_ACTIONS スキルは 100 アクションに制限されています。The skill is limited to 100 actions. スキル マニフェストで定義されているスキル アクションが多すぎます。There are too many skill actions defined in skill manifest. アクションを削除して、もう一度やり直してください。Remove actions and try again.
アクション入力パラメーターが制限されているAction input parameters are limited LIMITS_TOO_MANY_INPUTS Actions are limited to 25 inputs. (アクションは 25 個の入力に制限されています。)Actions are limited to 25 inputs. スキル アクションの入力パラメーターが多すぎます。There are too many skill action input parameters. パラメーターを削除して、もう一度やり直してください。Remove parameters and try again.
アクション出力パラメーターが制限されているAction output parameters are limited LIMITS_TOO_MANY_OUTPUTS Actions are limited to 25 outputs. (アクションは 25 個の出力に制限されています。)Actions are limited to 25 outputs. スキル アクションの出力パラメーターが多すぎます。There are too many skill action output parameters. パラメーターを削除して、もう一度やり直してください。Remove parameter and try again.
スキル数が制限されているSkill count is limited LIMITS_TOO_MANY_SKILLS Your bot can have a maximum of 25 skills. (ボットのスキル数は最大 25 個です。)Your bot can have a maximum of 25 skills. ボットに追加されたスキルが多すぎます。There are too many skills added into a bot. 既存のスキルを削除して、もう一度やり直してください。Remove an existing skill and try again.
セキュリティ トークンが有効ですSecurity token is valid AADERROR_OTHER It looks like something went wrong. (問題が発生した可能性があります。)It looks like something went wrong. スキルをトリガーするためのセキュリティ トークンを取得するときに、一時的なエラーが発生する可能性があります。There may be a transient error to acquire a security token to trigger the skill. スキルのインポートを再試行してください。Retry importing the skill.
スキルが正常であるSkill is healthy ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILEDENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED Something went wrong while checking your skill. (スキルの確認中に問題が発生した可能性があります。)Something went wrong while checking your skill. Power Virtual Agentsにアクティビティを送信するときに不明な応答 EndOfConversation を受け取った場合。Power Virtual Agents received an unknown response when sending an EndOfConversation activity to your skill. スキルが正常に動作し、応答していることを確認します。Make sure your skill is running and responding correctly.
スキルが承認されているSkill is authorized ENDPOINT_HEALTHCHECK_UNAUTHORIZED このスキルでは、ボットが許可リストに含まれるのではありません。This skill has not allow-listed your bot. ボットがスキルの許可リストに追加されていないか確認します。Check if your bot has been added to the skill's allow list. 詳細については、「スキルを構成するPower Virtual Agents」を 参照してくださいFor more information, see the Power Virtual Agents how to Configure a Skill.