クラシックチャットボットを Bot Framework ボットのスキルとして使用する

[アーティクル]
03/19/2025

注意

この記事は、クラシックチャットボットにのみ適用されます。この機能は、新規の Copilot Studio エクスペリエンスでは利用できません。

クラシックチャットボットと共に Bot Framework ボットをスキルとして使用する場合、Bot Framework ボットは、ユーザーの発言がクラシックチャットボットのトリガーフレーズに一致するかどうかを判断します。一致する場合、Bot Framework ボットはクラシックチャットボットに会話を渡します。クラシックチャットボットは、任意のエンティティを抽出し、一致するトピックをトリガーします。

Bot Framework Composer からの入力として変数を Copilot Studio スキルトピックに渡し、返される出力を使用することもできます。

重要

クラシックチャットボットをスキルとして使用するには、試用版またはフル Copilot Studio ライセンスが必要です。この機能は、Teams Copilot Studio ライセンスでは使用できません。

クラシックチャットボットをスキルとして設定する方法:

Bot Framework ボットをクラシックチャットボットの許可リストに追加します。
クラシックチャットボットのスキルマニフェストをダウンロードします。
ダウンロードしたスキルマニフェストを Bot Framework Composer で使用し、ボット間の接続を作成します。
Bot Framework Emulator を使用して、ボットがスキルとして機能することを確認します。

前提条件

ご利用の Bot Framework ボットをクラシックチャットボットの許可リストに追加する

スキルとして使用するクラシックチャットボットの許可リストに Bot Framework ボットのアプリ ID を追加します。ボットは同一テナント内に存在する必要があります。

Bot Framework Composer でスキルを使用するボットを開きます。構成を選択し、開発リソース を選択します。 Microsoft アプリ ID の ID をコピーします。
Copilot Studio でスキルとして使用するクラシックチャットボットを開きます。
ナビゲーションメニューで設定に移動して セキュリティ を選択します。続いて 許可リストを選択します。
許可された呼び出し元の追加 を選択します。
Bot Framework ボットのアプリ ID を貼り付け、次へを選択します。

注意

従来のチャットボットは、他の従来のチャットボットのスキルとして機能することはできません。 Power Virtual Agent ボットに属するアプリ ID を許可リストに追加しようとすると、エラーが発生します。 Bot Framework ボットのアプリ ID のみを追加できます。

Copilot Studio は Bot Framework ボットのアプリ ID を検証し、同じテナントのボットに属していることを確認します。
(オプション) 追加したボットの表示名 を許可リストに追加します。
保存を選択します。

Bot Framework ボットは、入力した場合は表示名で表示され、表示名を入力しなかった場合はアプリ ID で表示されます。いつでも削除または編集するには、ボットの表示名またはアプリ ID の右側にあるアイコンを選択します。

Note

許可リストに追加された Bot Framework ボットは、ボットコンテンツの一部としてエクスポートされません。

クラシックチャットボットのクラシックチャットボットスキルマニフェストをダウンロードする

Bot Framework ボットは Copilot Studio スキルマニフェストを使用して、マニフェストを作成したクラシックチャットボットへの接続を構成することができます。

すべての従来のチャットボットにはスキルマニフェストがあります。スキルマニフェストは、スキルの名前、インターフェース、トリガーフレーズを含む JSON ファイルです。

Bot Framework ボットは、スキルマニフェストを使用して、クラシックチャットボットをトリガーするタイミングを把握できます (例: ユーザーからの発言に対する反応)。

Copilot Studio のスキルマニフェストは、Bot Framework のスキルマニフェストスキーマのバージョン 2.2 に従い、intents.lu ファイルと manifest.json ファイルで構成されます。

Bot Framework ボットは、マニフェストデータに基づいて、クラシックチャットボットがユーザーリクエストを処理する必要があると判断する場合があります。ユーザーの発言をすべてをクラシックチャットボットに渡します。そして、クラシックチャットボットは、ユーザーの発言を Copilot Studio トピックと照合し、スロット充填に必要なエンティティを抽出して、Copilot Studio トピックをトリガーします。

Copilot Studio スキルマニフェストは自動的に生成され、更新されます。クラシックチャットボットには 2 つのスキルマニフェストがあります。

テストマニフェスト: Bot Framework ボットがクラシックチャットボットのテスト版に接続できるようにします。スキルを公開する前に、テストマニフェストを使用して、スキルの変更を検証します。
- テストマニフェストは、新たに作成されたすべてのクラシックチャットボットですぐに利用できます。
- クラシックチャットボットを保存するたびに、変更内容が自動的に反映されます。
公開マニフェスト: Bot Framework ボットが公開バージョンのクラシックチャットボットに接続できるようにします。
- 公開マニフェストは、一度でも公開されたことのあるクラシックチャットボットでのみ利用できます。
- エージェントを公開するたびに、変更内容を反映して自動的に更新されます。

注意

公開されたことのないクラシックチャットボットでは、公開マニフェスト は使用できません。

ボットの 公開マニフェスト を作成するには、クラシックチャットボットを公開します。

両方のスキルマニフェストが 許可リストの管理 パネルに表示されます。

スキルマニフェストは、コパイロットの詳細ページにも表示されます。ナビゲーションメニューで設定を選択し、詳細を選択します。詳細ページには、環境 ID、テナント ID、ボットのアプリ ID などのメタデータが表示されます。

マニフェストをダウンロードするには、そのマニフェストを選択します。 公開マニフェスト の場合は <bot name>manifest、テストマニフェスト の場合は <bot name>test__manifest という名前の .zip ファイルでダウンロードされます。

注意

スキルマニフェストには、クラシックチャットボットに追加されるシステムトピックや Composer ダイアログは含まれません。ボットの作成者によって作成されたトピックと、作成者がコパイロットに追加する Composer インテントトリガーのみが含まれます。

Composer の Copilot Studio スキルに接続する

Copilot Studio のスキルマニフェストを使用して、Composer の Bot Framework ボットにスキル接続を作成します。

Bot Framework Composer のプロジェクトで、追加を選択し、スキルに接続 を選択します。
Copilot Studio マニフェスト .zip アーカイブを参照して選択し、次へを選択します。
Bot Framework ボットに追加するクラシックチャットボットでトピックまたはインテントを選択し、次へを選択します。
クラシックチャットボットのトリガーフレーズを確認して編集し、次へを選択します。
複数のボットプロジェクトにオーケストレーターを使用する が選択されていることを確認し、続行を選択します。
Copilot Studio スキルが Bot Framework ボットに正しく追加され、クラシックチャットボットの名前を持つ新規トリガーが Composer のプロジェクトに表示されていることを確認します。

スキルマニフェストでトピックを検索する

イベントを使用して、スキルで Copilot Studio トピックをトリガーします。 Composer から特定のトピックを呼び出すには、スキルマニフェストにある関連イベントの名前でトピックを参照します。

スキルに接続する アクションを選択します。
スキルダイアログ名 で、スキルマニフェストを表示する を選択します。
activities をマニフェストで検索します。このプロパティには、クラシックチャットボットで利用可能なトピックを表すネストされたプロパティが含まれます。
呼び出すトピックを検索し、name プロパティを探します。 Copilot Studio スキルがこの名前のイベントを受け取ると、トピックをトリガーします。

この例では、イベント活動名は dispatchTo_new_topic_87609dabd86049f7bc6507c6f7263aba_33d です。

Copilot Studio スキルトピックを呼び出す

Copilot Studio スキルトピックをトリガーするユーザーの発言に依存するのではなく、直接呼び出すことができます。スキルマニフェストに一覧表示されている Copilot Studio トピックのみを直接呼び出すことができます。

Composer 作成キャンバスで追加を選択し、次に 外部リソースにアクセスする を選択して、スキルに接続する を選択します。
スキルダイアログ名 のリストで、クラシックチャットボットを選択します。
呼び出すクラシックチャットボットトピックのイベント活動名を検索します。引用符を省略して値をコピーし、次の手順で使用するために保存します。
クローズを選択します。
活動セクションで コードの表示 を選択します。
次のコードを入力または貼り付けます。 TOPIC_ACTIVITY_NAME をトピックのイベント活動名に置き換えます。 name プロパティに引用符がないことを確認してください。
```
[Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]
```

入力変数を Copilot Studio スキルトピックに渡す

Copilot Studio Composer は、変数を入力として Bot Framework スキルトピックに渡すことができます。入力変数を受け入れる Copilot Studio トピックを作成する方法については、変数を使った作業を参照してください。

入力変数を受け取ることができる Copilot Studio トピックがスキルマニフェストに記載されている場合は、Composer 変数を渡すことができます。

Composer 作成キャンバスで追加を選択し、次に 外部リソースにアクセスする を選択して、スキルに接続する を選択します。
スキルダイアログ名 のリストで、クラシックチャットボットを選択します。
呼び出すクラシックチャットボットトピックのイベント活動名を検索します。引用符を省略して値をコピーし、次の手順で使用するために保存します。
トピックの value プロパティを検索します。 value プロパティには、$ref プロパティが含まれます。その値をコピーして保存し、次の手順で使用します。

警告

Copilot Studio トピックに入力がない場合、value プロパティはありません。
definitions プロパティを検索してから、前の手順で検索した $ref 値と一致するネストされたプロパティを検索します。 Copilot Studio トピックの入力の名前と種類に注意してください。次の手順で使用します。
クローズを選択します。
活動セクションで コードの表示 を選択します。
次のコードを入力または貼り付けます。これらの値を置き換えます:
1. TOPIC_ACTIVITY_NAME をトピックのイベント活動名に置き換えます。
2. PVA_INPUT_VARIABLE をトピックからの入力変数に置き換えます。
3. COMPOSER_INPUT_VARIABLE を、値を提供する Composer 変数に置き換えます。
```
[Activity
    Type = event
    Name = TOPIC_ACTIVITY_NAME
    Value = ${addProperty(json("{}"), 'PVA_INPUT_VARIABLE', COMPOSER_INPUT_VARIABLE)}
]
```
この例では、Composer 変数 dialog.storeLocation が、クラシックチャットボットトピック dispatchTo_new_topic_127cdcdbbb4a480ea113c5101f309089_21a34f16 で、入力変数 pva_StoreLocation に値を提供します。

Copilot Studio スキルトピックから出力変数を受け取る

Composer では、Copilot Studio スキルトピックから出力を受け取ることができます。出力を返す Copilot Studio トピックの作成方法については、変数を使った作業を参照してください。

Composer 作成キャンバスで追加を選択し、次に 外部リソースにアクセスする を選択して、スキルに接続する を選択します。
スキルダイアログ名 のリストで、クラシックチャットボットを選択します。
呼び出すクラシックチャットボットトピックのイベント活動名を検索します。引用符を省略して値をコピーし、次の手順で使用するために保存します。
トピックの resultValue プロパティを検索します。 resultValue プロパティには、$ref プロパティが含まれます。その値をコピーして保存し、次の手順で使用します。

警告

Copilot Studio トピックに出力がない場合、resultValue プロパティはありません。
definitions プロパティを検索してから、前の手順で検索した $ref 値と一致するネストされたプロパティを検索します。 Copilot Studio トピックの出力変数の名前と種類に注意してください。次の手順で使用します。

この例では、Copilot Studio トピックは、文字列型の 2 つの出力 pva_State および pva_Item を返します。
クローズを選択します。
活動セクションで コードの表示 を選択します。
次のコードを入力または貼り付けます。 TOPIC_ACTIVITY_NAME をトピックのイベント活動名に置き換えます。 name プロパティに引用符がないことを確認してください。
```
[Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]
```
コード領域で、プロパティ を Composer 変数に設定して、Copilot Studio スキルトピックからの出力値を受け取り、格納します。
Composer 作成キャンバスで追加を選択し、次に プロパティを管理 を選択して、プロパティ設定 を選択します。
プロパティ を抽出された値を保存する Composer 値に設定します。そのあと、値をトピックの出力をに保存した Composer 変数に設定します。

この例では、dialog.skillResult.pvaState と dialog.skillResult.pvaItem からの出力値は、新しい Composer 変数 dialog.State と dialog.Item に抽出されます。

Bot Framework ボットを使用して、ご利用のクラシックチャットボットをスキルとしてテストする

Bot Framework Emulator を使用して、Bot Framework ボットがクラシックチャットボットをスキルとして正しく呼び出していることをテストします。

重要

スキルの接続を行うためには、ご利用の Bot Framework ボットがクラシックチャットボットの許可リストに追加されている必要があります。

マルチテナント Bot Framework ボットをシングルテナントボットに更新する

次の図は、Bot Framework SDK 上に構築された Bot Framework ボットがクラシックチャットボットを呼び出してスキルとして使用するシナリオを示しています。

Bot Framework ボットとクラシックチャットボットの相互作用を示す図。

Bot Framework ボットと従来のチャットボットの両方に Microsoft Entra ID アプリ登録があり、これは Azure Bot インスタンスによって参照されます。これらの Microsoft Entra ID アプリの登録は、マルチテナントとして作成されています。 Bot Framework ボットは Bot Framework テナントからトークンを要求し、このトークンを使用して Azure Bot Service を通じて Copilot Studio に認証します。 Copilot Studio は、同じメカニズムを使用して Bot Framework ボットに接続します。

Copilot Studio チャットボットのアプリケーション登録がシングルテナントとして作成されたため、この通信は機能しなくなりました。 Microsoft Entra ID は、同じテナント内にないシングルテナントアプリケーション登録のトークンの作成を拒否します。

さらに、Copilot Studio は受信トークンを検証し、従来のチャットボットのアプリケーション登録が作成されたテナント ID など、予期しないテナントからの要求を拒否します。

この問題を解決するには、2 つの修正方法があります。

Bot Framework ボットと同じテナント内のクラシックチャットボット

Copilot Studio チャットボットが Bot Framework ボットと同じテナントに既にデプロイされており、このボットによってのみ使用されているシナリオでは、ボットをシングルテナント構成に更新してから、Bot Framework ボットを再デプロイします。シングルテナント用に Bot Framework ボットを構成する方法の詳細については、ボットのプロビジョニングと公開を参照してください。

シングルテナントに更新できない Copilot Studio チャットボット

Copilot Studio チャットボットが Bot Framework ボットと同じテナントに既にデプロイされており、ボットをシングルテナントで更新できないシナリオでは、Bot Framework ボットのコードを更新して、Copilot Studio チャットボットと通信するためのトークンを作成する必要があります。トークンは、Copilot Studio チャットボットも作成されたテナント用に作成する必要があります。また、応答を受け入れる必要があるため、既存のスキルをマルチテナントからシングルテナントに変換するの手順に従う必要があります。

次の方法で共有

クラシックチャットボットを Bot Framework ボットのスキルとして使用する

前提条件

ご利用の Bot Framework ボットをクラシックチャットボットの許可リストに追加する

クラシックチャットボットのクラシックチャットボットスキルマニフェストをダウンロードする

Composer の Copilot Studio スキルに接続する

スキルマニフェストでトピックを検索する

Copilot Studio スキルトピックを呼び出す

入力変数を Copilot Studio スキルトピックに渡す

Copilot Studio スキルトピックから出力変数を受け取る

Bot Framework ボットを使用して、ご利用のクラシックチャットボットをスキルとしてテストする

マルチテナント Bot Framework ボットをシングルテナントボットに更新する

Bot Framework ボットと同じテナント内のクラシックチャットボット

シングルテナントに更新できない Copilot Studio チャットボット

詳細情報

フィードバック

その他のリソース

次の方法で共有

クラシック チャットボットを Bot Framework ボットのスキルとして使用する

前提条件

ご利用の Bot Framework ボットをクラシック チャットボットの許可リストに追加する

クラシック チャットボット のクラシック チャットボット スキルマニフェストをダウンロードする

Composer の Copilot Studio スキルに接続する

スキル マニフェストでトピックを検索する

Copilot Studio スキル トピックを呼び出す

入力変数を Copilot Studio スキル トピックに渡す

Copilot Studio スキル トピックから出力変数を受け取る

Bot Framework ボットを使用して、ご利用のクラシック チャットボットをスキルとしてテストする

マルチテナント Bot Framework ボットをシングルテナント ボットに更新する

Bot Framework ボットと同じテナント内のクラシック チャットボット

シングルテナントに更新できない Copilot Studio チャットボット

詳細情報

フィードバック

その他のリソース

クラシックチャットボットを Bot Framework ボットのスキルとして使用する

ご利用の Bot Framework ボットをクラシックチャットボットの許可リストに追加する

クラシックチャットボットのクラシックチャットボットスキルマニフェストをダウンロードする

スキルマニフェストでトピックを検索する

Copilot Studio スキルトピックを呼び出す

入力変数を Copilot Studio スキルトピックに渡す

Copilot Studio スキルトピックから出力変数を受け取る

Bot Framework ボットを使用して、ご利用のクラシックチャットボットをスキルとしてテストする

マルチテナント Bot Framework ボットをシングルテナントボットに更新する

Bot Framework ボットと同じテナント内のクラシックチャットボット