こんにちは、Power Platform サポートチームの竹内です。
本記事では Copilot Studio (旧称 Power Virtual Agents) で作成したエージェントを Microsoft Teams (以降 Teams) に公開する方法についてご案内致します。
- 目次
- 1. 概要
- 2. Web 版 Copilot Studio で作成したエージェントを Teams で利用する
- 3. Teams 版 Copilot Studio で作成したエージェントを Teams で利用する
- 補足
1. 概要
今回はよくあるお問い合わせとして、Copilot Studio で作成したエージェントを Teams に公開する方法についてご案内いたします。
この方法では Copilot Studio の設定だけでなく、Teams 管理センターなどの設定も必要となります。
そのため、一部 Teams 管理センターにアクセスできる権限がある管理者にてご実行いただく必要がある操作もございますので、ご留意ください。
Note
<Teams管理者様がご確認ください>
Teams 管理センターでアクセス許可ポリシーを設定している場合、事前にカスタムアプリのアクセスを許可するようポリシーを設定する必要がございます。
本記事執筆時点で、アクセス許可ポリシーからアプリ中心の管理への移行が推奨されておりますので、本記事では詳細は割愛します。
アクセス許可ポリシーの設定方法等については下記の公開情報をご参照ください。
Microsoft Teams のアプリのアクセス許可ポリシーを管理する - Microsoft Teams | Microsoft Learn
2. Web 版 Copilot Studio で作成したエージェントを Teams で利用する
※Dataverse for Teams 環境のボットをWeb版で作成することはサポートされていません。
2-1. エージェントを公開する
エージェントを作成、編集した場合、そのエージェントを他の人が使えるようにするため、まずは公開する必要があります。
作成、編集したエージェントを開き、画面右上の「公開」ボタンよりエージェントを公開してください。
下記のようなロード画面が表示され、しばらくすると公開が完了します。
2-2. 他のユーザーと共有する
作成したエージェントを、他のユーザーが利用できるようにします。
他のユーザーとエージェントを共有するには 2 つの方法がございます。
- セキュリティグループ、組織に利用者として共有する（エージェントと会話するユーザーとして）（設定方法はこちら）
Note
<Power Platform 管理者様がご確認ください>
利用者としてエージェントを共有する場合、利用者のユーザーは Power Platform 環境のメンバーである必要はありません。
また、セキュリティロールを割り当てる必要もありません。
ただし、エージェントを通して環境内のデータやその他データソースへアクセスする場合には、別途データソースへのアクセス権限をユーザーに割り当てる必要があります。
一方、エージェントにナレッジとして直接追加されたファイルへアクセスする際には、アクセス権限やセキュリティロールを割り当てる必要はありません。
- ユーザーに共同編集者として共有する（エージェントと会話、およびエージェントを編集、管理するユーザーとして）（設定方法はこちら）
Note
<Power Platform 管理者様がご確認ください>
共同編集者としてエージェントを共有する場合、共有先のユーザーは環境のメンバーであり、環境作成者以上のセキュリティロールを持っている必要があります。
詳細については下記の公開情報をご参照ください。
他のユーザーとエージェントを共有する - Microsoft Copilot Studio | Microsoft Learn
2-3. Teamsチャネルに接続する
次に、公開したエージェントを Teams で使えるようにするため、Teams チャネルと接続します。
重要
<Teams管理者様がご確認ください>
Teams でエージェントを利用するためには、Teams 管理センターからカスタムアプリの使用を許可する必要があります。
具体的な設定方法は下記の公開情報をご参照ください。
Microsoft Teams 管理センターで Microsoft Power Platform アプリを管理する - Microsoft Teams | Microsoft Learn
Note
<Power Platform 管理者様がご確認ください>
Power Platform 管理センターより Teams チャネルへの接続を許可するよう DLP を設定しておく必要があります。
下記の「Microsoft Teams + M365 Channel in Copilot Studio」のコネクタを許可してください。
なお、Copilot Studio に関する DLP の詳細については下記の公開情報をご参照ください。
エージェントのデータ損失防止ポリシーを構成する - Microsoft Copilot Studio | Microsoft Learn
該当のエージェントを開き、画面上部の「チャネル」タブより「Microsoft Teams」をご選択ください。
チャネルが追加されると下記の画面が表示されます。
「詳細の編集」より Teams に公開する際のエージェントの外観等を編集することが可能です。
また、エージェントを Teams チームに追加することの許可などもここから可能です。
エージェントを Teams チームに追加する詳細については、2-5 項で後述します。
「エージェントを開く」を選択すると、Teams が開き、下記の画面が表示されます。
「追加」を選択することで、Teams でエージェントを利用することが可能になります。
ここまでの操作で、編集権限を持つユーザーだけが Teams で該当エージェントを使える状態となります。
警告
Teams 管理センターの設定が適切に行われていない場合、下画像のようなエラーが表示されることがあります。
<Teams管理者様がご確認ください>
Teams 管理センターの設定をご確認ください。
具体的な設定方法は下記の公開情報をご参照ください。
Microsoft Teams 管理センターで Microsoft Power Platform アプリを管理する - Microsoft Teams | Microsoft Learn
2-4. 他のユーザーが Teams でエージェントを利用する
他のユーザーが Teams でこのエージェントと会話したり、エージェントにアクセスしたりできるようにするには、対象エージェントを他のユーザーが Teams で追加登録できるようにする作業が必要となります。
その追加登録を可能にするための作業として、主に 3 つの方法があります。
- リンクの共有
- Teams アプリストアに公開する
- zip としてダウンロード・アップロード
Copilot Studio 「チャネル」タブより「Microsoft Teams」を選択すると、下記の画面が表示されます。
他のユーザーがこのエージェントを利用できるようにするには、「可用性オプション」をご選択ください。
以降、3 つの方法それぞれの手順等について説明します。
2-4-1. リンクの共有
まず、リンクの共有によって共有する方法です。
この方法は事前に共有したいユーザーを入れたセキュリティグループに、エージェント自体を共有しておく必要があります。
共有の方法については 2-2 項 をご参照ください。
下記の画面で「リンクのコピー」を選択します。
すると、クリップボートに Teams でエージェントを利用するための URL がコピーされます。
エージェントにアクセス権がある他ユーザーがその URL を入力すると、下記画面が表示されます。
「追加」を選択することで、Teams でエージェントを利用することが可能となります。
この方法の詳細については下記の公開情報も合わせてご参照ください。
Microsoft Teams 用コパイロットの接続と構成 - Microsoft Copilot Studio | Microsoft Learn
2-4-2. Teamsアプリストアに公開する
次に、Teams アプリストアに公開する方法です。
※Teams チャネルに接続して公開する場合、Azure AD 認証 (Entra ID 認証) を利用していないとTeamsアプリストアに表示できません。
Teams アプリストアに公開するには下記の二つの公開範囲別の方法があります。
ご要件の公開範囲に応じた設定を行ってください。
なお、この手順全体の詳細については下記の公開情報をご参照ください。
接続 を設定し、エージェント を設定します Microsoft Teams - Microsoft Copilot Studio | Microsoft Learn
2-4-3. zipとしてダウンロード・アップロード
この方法は .zip ファイルとしてエージェントをダウンロードし、直接マニフェストファイルを編集したり、他ユーザーと共有してアップロードする方法となります。
ダウンロードするには、下記の画面で「.zip のダウンロード」を選択します。
ダウンロードしたファイルを Teams にアップロードして利用する方法については下記の公開情報をご参照ください。
カスタム アプリをアップロードする - Teams | Microsoft Learn
なお、この方法の詳細については下記の公開情報も合わせてご参照ください。
接続 を設定し、エージェント を設定します Microsoft Teams - Microsoft Copilot Studio | Microsoft Learn
2-5. Teams チームにエージェントをインストールする
Teams 内のチームにエージェントをインストールし、チームの他のメンバーがエージェントを利用できるように設定することができます。
Copilot Studio 「チャネル」タブより「Microsoft Teams」を選択すると、下記の画面が表示されますので、「詳細の編集」をご選択ください。
「このエージェントのチームへの追加をユーザーに許可する」のチェックボックスを埋めてください。
上記の設定を行っている状態で、リンクの共有、または Teams アプリストアに公開を経由し、下記の「追加」ボタンを選択してください。
すると、下記のように、Teams で開くか、特定のチームを選択してエージェントをインストールするか、選択が可能となります。
チームにエージェントをインストールする場合、インストール先のチームを選択し、インストールしてください。
なお、この方法の詳細については下記の公開情報も合わせてご参照ください。
Microsoft Teams のエージェントを接続して構成します - Microsoft Copilot Studio | Microsoft Learn
3. Teams 版 Copilot Studio で作成したエージェントを Teams で利用する
Note
Dataverse for Teams 環境にCopilotを作成します。
Dataverse for Teams 環境の管理方法 | Japan Dynamics CRM & Power Platform Support Blog
※作成されるのはクラシックボットで、Web版で作成されるボットと機能が異なります。
3-1. エージェントを公開する
エージェントを作成、編集した場合、そのエージェントを他の人が使えるようにするため、まずは公開する必要があります。
作成、編集したエージェントを開き、「公開」メニューより「公開」ボタンを選択し、エージェントを公開してください。
3-2. 他のユーザーと共有する
作成したエージェントを、他のユーザーがで利用できるようにします。
Web 版と同様に、他のユーザーとエージェントを共有するには 2 つの方法がございます。
- セキュリティグループに利用者として共有する（エージェントと会話するユーザーとして）
- ユーザーに共同編集者として共有する（エージェントと会話、およびエージェントを編集、管理するユーザーとして）
手順の詳細等については下記の公開情報をご参照ください。
他のユーザーとエージェントを共有する - Microsoft Copilot Studio | Microsoft Learn
Note
<Power Platform 管理者様がご確認ください>
利用者としてエージェントを共有する場合、利用者のユーザーは Power Platform 環境のメンバーである必要はありません。
また、セキュリティロールを割り当てる必要もありません。
ただし、エージェントのナレッジソースを通して環境内のデータやその他データソースへアクセスする場合には、別途データソースへのアクセス権限をユーザーに割り当てる必要があります。
一方、エージェントにナレッジとして直接追加されたファイルへアクセスする際には、セキュリティロールを割り当てる必要はありません。
3-3. 他のユーザーが Teams でエージェントを利用する
Web 版 Copilot Studio でエージェントを公開した直後や、下記の画面で「このエージェントの使用を他のユーザーに許可する」を選択すると、次の画面が表示されます。
2-4 項で説明した画面と同様の画面となります。
それ以降の公開範囲に応じて、Web 版と同様の設定を行ってください。
補足
本手順は執筆時点でのユーザー インターフェイスを基に紹介しています。バージョンアップによって UI の遷移などが若干異なる場合があります。その場合は画面の指示に従って進めてください。
※本情報の内容（添付文書、リンク先などを含む）は、作成日時点でのものであり、予告なく変更される場合があります。