Copilot Studioエージェントで使うためのAzure Bot Serviceスキルを設定する

Note

本記事では 、標準ハーネスで駆動されるエージェントやエージェントフローで使用される機能について説明します。

Important

この記事では、標準ハーネスにおけるエージェントの機能を拡張するためのコードベースの方法であるAzure Bot Serviceスキルに関する情報が含まれています。 Azure Bot Serviceスキルは以下とは異なります:

  • エージェントスキルとは、GitHub Copilot または Customer Conversation ハーネスでサポートされるエージェントに追加する指示ベースのスキルです。 エージェント のスキル概要で詳しくはこちらをご覧ください。
  • プラグインスキル、Microsoft 365 Copilot プラグインが含め得る機能。 詳細は「Skills as plugin capabilities」をご覧ください。

Copilot Studio Azure Bot Serviceスキルを使ってエージェントを拡張できます。 もし組織内で特定のシナリオ向けにエージェントを構築・展開しているなら(Microsoft 365 エージェント SDKや他のプロコードツールを使って)、それらのボットをAzure Bot Serviceスキルに変換し、Copilot Studioエージェントに登録できます。

Note

Microsoft TeamsのCopilot Studioアプリ内でAzure Bot Serviceスキルを追加するには、Microsoft Copilot Studioスタンドアロンのサブスクリプションが必要です。

この記事は、Azure Bot Serviceスキルに精通しているシステム管理者またはIT専門家を対象としています。

Copilot StudioエージェントにAzure Bot Serviceスキルを登録すると、会話中にAzure Bot Serviceスキルアクションをシームレスに発動させることができます。

Prerequisites

Important

Copilot Studioエージェントは、Legacy Bot Framework SDKバージョン4.12.0+およびMicrosoft 365 エージェント SDK v1.0.0+で構築されたAzure Bot Serviceスキルのみをサポートします。 新しいAzure Bot ServiceスキルはMicrosoft 365 エージェント SDKを使って構築する必要があります。

Azure Bot Service スキルを設定するには、Microsoft Entra ID でスキルに関連付けられたアプリ登録をシングルテナント構成に設定してください。

エージェントフローやAzure Bot Serviceスキルを使うべき時

以下の表は、会話でエージェントフローやAzure Bot Serviceスキルを使うべきタイミングを判断するのに役立ちます。

要因 エージェントフローの使用タイミング Azure Bot Serviceスキルを使うタイミング
個人 エージェントの作成者は、エージェントの会話に埋め込むために、再利用可能なフローを構築できる。 開発者は、自社環境内でカスタムAzure Bot Serviceスキルを作成、展開、ホストすることができます。
会話の種類 単純な単一ターンの操作にはフローを使用します。 たとえば、受注したり、受注状態を取得したりします。 複雑で複数ターンの操作にはAzure Bot Serviceスキルを活用しましょう。 たとえば、会議をスケジュールしたり、フライトを予約したりします。
Response フローを使用してエージェントの応答を生成します。 たとえば、パーソナライズされたメッセージやインライン画像を表示します。 Azure Bot Serviceスキルを使って、サポートされている任意のエージェント応答を出力できます。 たとえば、アダプティブ カードを表示するか、ランダムな応答を送信します。
操作 フローを使用して、サーバー側の単一ターン アクションをトリガーします。 たとえば、HTTP API を呼び出すか、カスタム コネクタをトリガーします。 Azure Bot Serviceスキルを使ってサーバーサイドやクライアントサイドのイベントやアクションをトリガーしましょう。 たとえば、エージェントの応答時にページに移動します。

Azure Bot Serviceスキルを設定する

まず、Copilot Studioを使ってエージェントを作成し、プロコードツールを使ってAzure Bot Serviceスキルを作成し、組織内に展開しましょう。 次のサンプルを参照してください。

Azure Bot Serviceスキルを登録する前に、エージェントIDをスキル開発者に渡して、開発者がエージェントによるスキル内のアクションの呼び出しを認可できるようにしてください。 Azure Bot Serviceスキルの許可リストについて詳しく学びましょう。 エージェントIDは スキル追加 ウィンドウから取得できます。

エージェントにAzure Bot Serviceスキルを加えるには:

  1. エージェントに行ってください。

  2. > スキルを選択します。

  3. スキルの追加を選択します。

  4. エージェントの ID をコピーします。 スキル開発者にエージェントIDを提供する必要があります。

  5. Azure Bot ServiceスキルマニフェストのURLを入力してください。 スキルのマニフェストには、エージェントがスキル内のアクションを発動するために必要な情報が含まれています。

  6. 次へを選択して検証プロセス を開始します。 検証が成功すると、あなたのスキルはエージェントに追加されます。 このスキルをトピックで 使用できます。

コンプライアンスに関する考慮事項

ユーザーのプライバシーを守るために、サインインしたユーザーのMicrosoft Entra IDテナントでAzure Bot Serviceスキルをアプリとして登録する必要があります。

Azure Bot Service のスキル登録中のエラーのトラブルシューティング

システムは、URL に対して一連の検証チェックを実行します。 これらのチェックにより、エージェントに加えたスキルのコンプライアンス、ガバナンス、使いやすさが保証されます。 Azure Bot Service スキルを登録する前に、これらのエラーを修正する必要があります。

エラー メッセージ トラブルシューティング / 軽減策
スキルマニフェストの取得に問題がありました。
(MANIFEST_FETCH_FAILED)
Web ブラウザーでマニフェスト URL を開いてみてください。 URL がページを 10 秒以内に表示する場合は、スキルを再登録します。
マニフェストは互換性がありません。
(MANIFEST_MALFORMED)
(a) マニフェストは有効な JSON ファイルかどうかを確認します。
(b) マニフェストに必要な属性が含まれているか確認
例えば、(name、 msaAppId、シングル 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)
エージェントがスキルの許可リストに追加されているか確認してください。