【Standard Harness】Copilot Studio のエージェントを Teams に公開する方法

こんにちは、Power Platform サポートチームの竹内です。
本記事では Copilot Studio (旧称 Power Virtual Agents) で作成したエージェントを Microsoft Teams (以降 Teams) に公開する方法についてご案内致します。

重要

本記事は Copilot Studio の Standard Harness を使用した場合を前提としています。

目次
1. 概要
2. Web 版 Copilot Studio で作成したエージェントを Teams で利用する
3. Teams 版 Copilot Studio で作成したエージェントを Teams で利用する
補足

1. 概要

今回はよくあるお問い合わせとして、Copilot Studio で作成したエージェントを Teams に公開する方法についてご案内いたします。
この方法では Copilot Studio の設定だけでなく、Teams 管理センターなどの設定も必要となります。
そのため、一部 Teams 管理センターにアクセスできる権限がある管理者にてご実行いただく必要がある操作もございますので、ご留意ください。
※本稿では Microsoft 365 Copilot への公開方法・ご利用方法については扱わず、 Teams でのご利用方法についてご案内いたします。

Note

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 と Microsoft 365 Copilot チャネルに接続する

次に、公開したエージェントを Teams で使えるようにするため、Teams と Microsoft 365 Copilot チャネルと接続します。

重要

<Teams管理者様がご確認ください>

Teams でエージェントを利用するためには、Teams 管理センターからカスタムアプリの使用を許可する必要があります。

具体的な設定方法は下記の公開情報をご参照ください。

Microsoft Teams 管理センターで Microsoft Power Platform アプリを管理する - Microsoft Teams | Microsoft Learn

Note

Power Platform 管理センターより Teams チャネルへの接続を許可するよう DLP を設定しておく必要があります。

下記の「Microsoft Teams + M365 Channel in Copilot Studio」のコネクタを許可してください。

なお、Copilot Studio に関する DLP の詳細については下記の公開情報をご参照ください。

エージェントのデータ損失防止ポリシーを構成する - Microsoft Copilot Studio | Microsoft Learn

該当のエージェントを開き、画面上部の「チャネル」タブより「Microsoft Teams と Microsoft 365 Copilot」をご選択ください。

チャネルが追加されると下記の画面が表示されます。

「詳細の編集」より Teams に公開する際のエージェントの外観等を編集することが可能です。
また、エージェントを Teams チームに追加することの許可などもここから可能です。
エージェントを Teams チームに追加する詳細については、2-5 項で後述します。

「Teams でエージェントを表示する」を選択すると、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 と Microsoft 365 Copilot」を選択すると、下記の画面が表示されます。

他のユーザーがこのエージェントを利用できるようにするには、「可用性オプション」をご選択ください。

以降、3 つの方法それぞれの手順等について説明します。

2-4-1. リンクの共有

まず、リンクの共有によって共有する方法です。
この方法は事前に共有したいユーザーを入れたセキュリティグループに、エージェント自体を共有しておく必要があります。
共有の方法については 2-2 項をご参照ください。

下記の画面で「リンクのコピー」を選択します。

すると、クリップボートに Teams でエージェントを利用するための URL がコピーされます。
エージェントにアクセス権がある他ユーザーがその URL を入力すると、下記画面が表示されます。
「追加」を選択することで、Teams でエージェントを利用することが可能となります。

この方法の詳細については下記の公開情報も合わせてご参照ください。
Teams と Microsoft 365 Copilot 向けのエージェントを接続し、構成する - Microsoft Copilot Studio | Microsoft Learn

警告

エージェントが共有されていないユーザーが、リンクにアクセスした場合、下画像のエラーが表示されます。

2-2 項をご参照のうえ、適切にエージェントが共有されいているかご確認ください。

2-4-2. Teams アプリストアに公開する

次に、Teams アプリストアに公開する方法です。
※Teams チャネルに接続して公開する場合、Microsoft 認証 (Entra ID 認証) を利用していないと Teams アプリストアに表示できません。

Teams アプリストアに公開するには下記の二つの公開範囲別の方法があります。
ご要件の公開範囲に応じた設定を行ってください。

共有ユーザーに表示する（設定方法はこちら）
組織に表示する（設定方法はこちら）

なお、この手順全体の詳細については下記の公開情報をご参照ください。
Teams と Microsoft 365 Copilot 向けのエージェントを接続し、構成する - Microsoft Copilot Studio | Microsoft Learn

2-4-3. zip としてダウンロード・アップロード

この方法は .zip ファイルとしてエージェントをダウンロードし、直接マニフェストファイルを編集したり、他ユーザーと共有してアップロードする方法となります。

ダウンロードするには、下記の画面で「.zip のダウンロード」を選択します。

ダウンロードしたファイルを Teams にアップロードして利用する方法については下記の公開情報をご参照ください。
カスタムアプリをアップロードする - Teams | Microsoft Learn

なお、この方法の詳細については下記の公開情報も合わせてご参照ください。
Teams と Microsoft 365 Copilot 向けのエージェントを接続し、構成する - Microsoft Copilot Studio | Microsoft Learn

2-5. Teams チームにエージェントをインストールする

Teams 内のチームにエージェントをインストールし、チームの他のメンバーがエージェントを利用できるように設定することができます。

Copilot Studio 「チャネル」タブより「Microsoft Teams と Microsoft 365 Copilot」を選択すると、下記の画面が表示されますので、「詳細の編集」をご選択ください。

「ユーザーはこのエージェントをチームに追加できます」のチェックボックスを埋めてください。

上記の設定を行っている状態で、リンクの共有、または Teams アプリストアに公開を経由し、下記の「追加」ボタンを選択してください。

すると、下記のように、Teams で開くか、特定のチームを選択してエージェントをインストールするか、選択が可能となります。

チームにエージェントをインストールする場合、インストール先のチームを選択し、インストールしてください。

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 環境のメンバーである必要はありません。

また、セキュリティロールを割り当てる必要もありません。

ただし、エージェントのナレッジソースを通して環境内のデータやその他データソースへアクセスする場合には、別途データソースへのアクセス権限をユーザーに割り当てる必要があります。

一方、エージェントにナレッジとして直接追加されたファイルへアクセスする際には、セキュリティロールを割り当てる必要はありません。

3-3. 他のユーザーが Teams でエージェントを利用する

Web 版 Copilot Studio でエージェントを公開した直後や、下記の画面で「このエージェントの使用を他のユーザーに許可する」を選択すると、次の画面が表示されます。

2-4 項で説明した画面と同様の画面となります。
それ以降の公開範囲に応じて、Web 版と同様の設定を行ってください。

補足

本手順は執筆時点でのユーザーインターフェイスを基に紹介しています。バージョンアップによって UI の遷移などが若干異なる場合があります。その場合は画面の指示に従って進めてください。

※本情報の内容（添付文書、リンク先などを含む）は、作成日時点でのものであり、予告なく変更される場合があります。