Copilot Studio で使用する Bot Framework スキルを構成する
Copilot Studio は、Bot Framework のスキルを使用してエージェントを拡張できます。 特定のシナリオでボットを (Bot Framework SDK とプロコード ツールを使用して) 組織にすでに構築および展開している場合、ボットをスキルに変換し、スキルを Copilot Studio のエージェントに登録することができます。
ヒント
Microsoft Teams の Copilot Studio アプリ内からスキルを追加するには、Microsoft Copilot Studio スタンドアロン サブスクリプション が必要です。
この記事は、Bot Framework スキルに精通しているシステム管理者または IT プロフェッショナルを対象としています。 スキルが Copilot Studio のエージェントで登録された後、作成者はシームレスに会話中にスキル アクションをトリガーする ことができます。
前提条件
重要
Copilot Studio のエージェントは Bot Framework SDK バージョン 4.12.0+ を使用して構築されたスキルのみをサポートします。
クラシック チャットボットは Bot Framework SDK バージョン 4.7+ を使用して構築したスキルのみをサポートします。
Bot Framework Composer を使用している場合は、Composer 2.x を使用することを強くお勧めします。 既存の Composer 1.x のエージェントを使用する場合は、スキルとして使用する前に最初に Composer 2.x に移行します。
スキルを構成するには、スキルに関連付けられた Microsoft Entra ID のアプリ登録をマルチテナント構成に設定する必要があります。
フロー アクションとスキル アクション
次の表は、会話にスキルをいつ使用するかを決定するのに役立ちます。
| フロー アクション | スキル アクション | |
|---|---|---|
| ペルソナ | エージェントの作成者は、エージェントの会話に埋め込むために、再利用可能なフローを構築できる | 開発者は、独自の環境でカスタム スキルを作成、展開、およびホストできます。 |
| 会話 | 単純な単一ターンの操作にはフローを使用します。 たとえば、受注したり、受注状態を取得したりします。 | 複雑な複数ターン操作にはスキルを使用します。 たとえば、会議をスケジュールしたり、フライトを予約したりします。 |
| 回答 | フローを使用してエージェントの応答を発行します。 たとえば、パーソナライズされたメッセージやインライン画像を表示します。 | スキルを使用して、サポートされているエージェントの応答を発行します。 たとえば、アダプティブ カードを表示するか、ランダムな応答を送信します。 |
| アクション | フローを使用して、サーバー側の単一ターン操作をトリガーします。 たとえば、HTTP API を呼び出すか、カスタム コネクタをトリガーします。 | スキルを使用して、サーバー側とクライアント側のイベントとアクションをトリガーします。 たとえば、エージェントの応答時にページに移動します。 |
スキルを構成する
まず、Copilot Studio を使用してエージェントを作成し、プロ コードツールを使用してスキルを作成して、組織に展開します。
スキルを登録する前に、エージェントがスキルでアクションを呼び出すことを承認するよう、エージェントの ID をスキル開発者に提供します。 スキル許可リストの詳細について。 エージェントの ID は スキルの追加 ウィンドウから取得できます。
エージェントにスキルを追加する方法:
ナビゲーション ウィンドウで 設定 を展開し、スキル を選択します。
スキル ページの上部で、スキルを追加 を選択します。
エージェントの ID をコピーして、スキルの開発者に提供します。
URL をスキル マニフェストに入力します。 スキルのマニフェストには、エージェントがスキル内のアクションをトリガーするために必要な情報が含まれています。
次へを選択して検証プロセス を開始します。 検証が成功すると、スキルがエージェントに追加されます。 このスキルをトピックで使用 できます。
コンプライアンスに関する考慮事項
ユーザー プライバシーを保護するために、サインイン ユーザーの Microsoft Entra ID テナントで、アプリとしてスキルを登録することが必要です。
スキル登録時のエラーのトラブルシューティング
一連の検証チェックが URL に対して行われます。 これらのチェックは、エージェントに追加されるスキルのコンプライアンス、ガバナンス、使いやすさを確認します。 スキルを登録する前に、これらのエラーを修正する必要があります。
| エラー メッセージ | トラブルシューティング / 軽減策 |
|---|---|
| スキル マニフェストの取得中に問題が発生しました。 ( MANIFEST_FETCH_FAILED) |
Web ブラウザーでマニフェスト URL を開いてみてください。 URL がページを 10 秒以内に表示する場合は、スキルを再登録します。 |
| マニフェストは互換性がありません。
( MANIFEST_MALFORMED) |
(a) マニフェストが有効な JSON ファイルかどうかを確認します。 (b) マニフェストに必要なプロパティが含まれているかどうかを確認します 例: ( name、msaAppId、single 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) を許可リストに追加していません |
エージェントがスキル許可リストに追加されているかどうかを確認します。 |