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 の関連アプリ登録をマルチテナント構成に設定する必要があります。
フロー アクションとスキル アクション
次の表は、会話にスキルをいつ使用するかを決定するのに役立ちます。
| フロー アクション | スキル アクション | |
|---|---|---|
| ペルソナ | Copilot の作成者は、コパイロットの会話に埋め込むために、再利用可能なフローを構築できる | 開発者は、独自の環境でカスタム スキルを作成、展開、およびホストできる |
| 会話 | 単純な単一ターンの操作にはフローを使用します。 たとえば、受注したり、受注状態を取得したりします。 | 複雑な複数ターン操作にはスキルを使用します。 たとえば、会議をスケジュールしたり、フライトを予約したりします。 |
| 回答 | フローを使用してコパイロット応答を発行します。 たとえば、パーソナライズされたメッセージやインライン画像を表示します。 | スキルを使用して、サポートされているコパイロット応答を発行します。 たとえば、アダプティブ カードを表示するか、ランダムな応答を送信します。 |
| アクション | フローを使用して、サーバー側の単一ターン操作をトリガーします。 たとえば、HTTP API を呼び出すか、カスタム コネクタをトリガーします。 | スキルを使用して、サーバー側とクライアント側のイベントとアクションをトリガーします。 たとえば、コパイロットの応答時にページに移動します。 |
スキルを構成する
まず、Copilot Studio を使用して コパイロットを作成 し、組織に プロコード ツールを使用してスキルを作成および展開 します。
スキルを登録する前に、コパイロットがスキルでアクションを呼び出すことを承認するよう、コパイロットの ID をスキル開発者に提供します。 スキル許可リストの詳細について。 コパイロットの ID は スキルの追加 ウィンドウから取得できます。
コパイロットにスキルを追加するには:
ナビゲーション ウィンドウで 設定 を展開し、スキル を選択します。
スキル ページの上部で、スキルを追加 を選択します。
コパイロットの ID をコピーして、スキルの開発者に提供します。
![[スキルの追加] ウィンドウの横にあるコパイロット ID を強調表示したスクリーンショット。](media/configuration-add-skills/skills-get-bot-id.png)
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) |
コパイロットがスキル許可リストに追加されているかどうかを確認します。 |