注:
この記事の機能は標準ハーネスを利用しており、標準ハーネスを利用するエージェントのライセンスで説明されている請求オプションを使用します。 Access標準エージェントおよびエージェントフローで標準機能にアクセスする方法を学びましょう。
エージェントを公開した後、TeamsやMicrosoft 365のユーザー向けに提供してください。 こうすることで、皆さんや皆さんのチームメイト、そしてより広い組織で、このプロジェクトとやり取りすることができます。 ユーザーが Teams とMicrosoft 365でエージェント<操作するには>エージェントを少なくとも 1 回公開する必要があります。
次のようにすることができます。
- TeamsやMicrosoft 365 Copilotでエージェントの外観をカスタマイズできます。
- TeamsとMicrosoft 365 Copilotで自分用のエージェントをインストールしてください。
- エージェントのインストールリンクを他のユーザーと共有してください。
- Teams アプリ ストアでエージェントを表示します。
- エージェントを共有ユーザーに表示するには、Teams アプリ ストアのPower Platform で構築するセクションに追加します。
- エージェントを提出して管理者の承認を得ることで、Teams アプリ ストアの組織用に構築セクションに掲載され、エージェントを組織で共有できます。
- エージェントをチーム チャネルに追加します。
- エージェントのアプリ マニフェストをダウンロードして、Teams テナント内で配布します。
エージェントを Teams に追加すると、エージェント コンテンツやユーザー チャット コンテンツなどの一部のデータは、Teams と共有されます。 データは 組織のコンプライアンスと地理的または地域的な境界 外に流出する可能性があります。 詳細については、 Teams アプリの権限とアクセスされる情報を理解するを参照してください。
前提条件
組織内のすべてのエージェント ユーザーは、Microsoft 365 Copilotを使用できます。
エージェント作成者はCopilot Studio環境の作成およびアクセス権限を持っています。
他のユーザーとエージェントを共有 Teams やMicrosoft 365 Copilotでエージェントをインストールしてチャットできるようにします。
組織がPower PlatformアプリをTeamsに追加することを許可しなければ、あなたや他のユーザーは以下のことをできません:
- Teamsに直接エージェントをインストールするか、
- Teamsアプリストアの 「Power Platformで構築 」セクションでエージェントを探してください。
組織で無効になっている場合は、管理者と協力してMicrosoft Teams 管理センターで Microsoft Power Platform アプリを管理してください。
管理者は、Teams管理センターの「Manage Apps Manage」ページで「組織用に構築された」セクション(管理者によって承認された)に表示されるエージェントを別々に管理します。
自分用にエージェントをインストールしたり、他人と共有したりする前に、少なくとも一度は エージェントを公開 してください。
エージェントを Teams と Microsoft 365 Copilot チャネルに接続する
エージェントを少なくとも一度公開した後は、 TeamsとMicrosoft 365 Copilot のチャンネルに接続し、TeamsとMicrosoft 365 Copilotの両方でチャットできます。
注:
組織外の個人がこれらのエージェントを使用できないようにするには、Teams、Microsoft 365 Copilot、または社内従業員用に構築されたエージェントのセキュリティ設定を有効にします。
Microsoft 365 CopilotとTeamsの両方でエージェントを利用できるようにするには、「Microsoft 365を有効にする」の下で「エージェントをMicrosoft 365 Copilotで利用可能にする」が選択されていることを確認してください。
注:
Microsoft 365 Copilotでエージェントを使用可能にする
を選択しない場合、エージェントはTeamsでのみ使用できます。 [チャネルを追加] を選択します。
Teams とMicrosoft 365 Copilotのエージェントの外観をカスタマイズする
エージェントを他のユーザーに提供する前に、適切な説明と外観を提供しましょう。 この情報は、ユーザーがエージェントの目的やブランドを理解するのに役立ちます。
詳細の編集を選択し、エージェントのアイコン、色、説明を変更します。 これらの属性は、ユーザーがエージェントをインストールした後、Teams アプリ ストアとアプリの 情報 タブで表示されます。 Teams のアプリ アイコン形式のガイドライン を確認します。
Important
共有リンクやTeamsアプリストアの 「Power Platformで構築 」セクションからエージェントをインストールしたユーザーは、エージェントの詳細変更を見ることはありません。 ユーザーはアップデートを受けるためにエージェントを再インストールする必要があります。
管理者によって既に承認されたエージェントの場合は、再度承認のためにエージェントを提出しなければなりません。
その他を選択して以下の情報を追加します:
- 開発者名
- Web サイト
- プライバシーに関する声明
- 使用条件
この情報を提供して、エージェントについてユーザーに知らせてください。 詳細については、「
Microsoft Teams を参照してください。保存を選びます。 色、アイコン、短い説明に対する変更が構成パネルに表示されるようになります。
注:
このセクションのアイコンカスタマイズは 、管理者によって承認されたエージェントのエージェントアバターにのみ適用されます。直接 インストールリンク やTeamsアプリストアの 「Power Platformで構築された 」セクションからエージェントをインストールしたユーザーには適用されません。 エージェントのアバターは、エージェントのルック アンド フィールのカスタマイズ でカスタマイズできます。
Teams と Microsoft 365 Copilot にエージェントをインストールする
エージェントを発行したら、Copilot Studio から直接 Teams プロファイルに追加できます。
Important
新しく公開されたエージェントの新しいコンテンツは、現在進行中の会話には表示されません。
既存の会話にやり直すと入力すると、すぐに新しい会話を開始して、エージェントの最新の更新を確認できます。
まずはTeamsで自分のプロフィールにエージェントを追加し、その後に他の人と共有してください。
Teams でエージェントを表示する を選択します。
最初にチャネルを追加したときに Microsoft 365 Copilot でエージェントを使用できるように構成した場合は、[ Teams でエージェントを表示 ] を選択すると、Teams と Microsoft 365 Copilot の両方にエージェントがインストールされます。 Microsoft 365 Copilot用にエージェントを構成しなかった場合、エージェントは Teams にのみインストールされます。
[] を選択し、[] を追加します。
左側のエージェントの一覧にエージェントが表示されます。
Microsoft 365 Copilotで新しいエージェントに質問をするには、 @を入力し、表示されたリストからエージェントを選択し、質問を入力して Enterを選択してください。
リンクを共有して、他の人がエージェントをインストールできるようにする
可用性オプションを選択します。
[リンクのコピー] を選択します。
リンクをユーザーと共有し、ユーザーが Teams にエージェントをインストールできるようにします。
Important
このリンクを使用してエージェントをインストールできるのは、エージェントにアクセスできるユーザーだけです。 エージェントを共有する ことで、ユーザーがエージェントとのチャットにアクセスできるようになります。
Teams モバイル アプリではインストール リンクを使用できません。 エージェント を Teams モバイル ユーザーが利用できるようにするには、Teams アプリ ストアに表示するように構成 します。
TeamsアプリストアまたはMicrosoft 365エージェントストアでエージェントを表示する
エージェントを公開すると、TeamsアプリストアやMicrosoft 365エージェントストアに表示でき、ユーザーが見つけてインストールできます。
Teamsの共有ユーザーに表示
エージェントを Teams アプリ ストアのPower Platform で構築するセクションに追加することで共有できます。 共有ユーザー のみがエージェントを見つけることができます。
Important
共有ユーザーのみが、Teams アプリ ストアの Power Platform で構築するセクションでエージェントを見つけてインストールできます。 すべての人がエージェントを使用できるように構成されている場合でも、組織内のすべての人にエージェントが表示されるわけではありません。 エージェントを 組織に表示するには、管理者の承認を得て、Teamsアプリストアの 「あなたの組織のためにビルド 」セクションやMicrosoft 365エージェントストアの「 あなたの組織によってビルド 」セクションに表示してください。
エージェントは、共有ユーザー総数がテナントの Teams アプリ ストア検出ポリシーで定められた制限を超えない場合にのみ、Teamsアプリストアの Power Platformで構築するセクションに表示されます。 エージェントをより多くのユーザーが利用できるようにするには、管理者と協力して組織に エージェントを表示します。
可用性オプションを選択します。
チームメイトと共有ユーザーに表示する を選択して、エージェントにアクセスできるユーザーを確認します。
「同僚作の表示」チェックボックスが選択されていることを確認し、「更新」を選択してください。
エージェントは Teams アプリストアのPower Platform で構築するセクションで利用可能になり、利用可能オプションページに緑色のTeams に追加済みラベルが表示されます。
注:
アプリがPower Platform で構築セクションに表示されない場合は、Teams アプリが情報をキャッシュしている可能性があります。
サインアウトして再度サインインするか (Teams デスクトップ アプリを使用している場合)、ブラウザーを更新してみてください (Teams Web アプリを使用している場合)。
Power Platform で構築セクションからエージェントを削除します
Power Platform で構築セクションからエージェントを削除できます。 このセクションからエージェントを削除しても、エージェントをインストールしているユーザーには影響しません。
可用性オプションを選択します。
「 チームメイトや共有ユーザーに表示 」を選択し、「 同僚が作ったに表示 」のチェックボックスを消してください。
共有 を選択します。 エージェントは、Teams アプリ ストアの Power Platform で構築セクションに表示されなくなります。
組織に表示する
Teams アプリ ストアの組織向けに構築セクションで紹介されるように管理者の承認を得るために申請することで、エージェントを組織内で共有できます。 Microsoft 365にもエージェントを公開した場合、管理者承認のために提出するとMicrosoft 365エージェントストアも適用されます。 Teams アプリ ストアと Microsoft 365 エージェント ストアでアプリをフィーチャーすることは、管理者と連携してエージェントを広範に配布し、組織内のすべてのユーザーまたはユーザーのサブセットに展開する優れた方法です。
管理者は アプリのセットアップ ポリシーを使用して 組織内のユーザーのエージェントを自動的にインストールしてピン留めし、Teams のアプリ バーから直接アクセスできるようにすることもできます。
エージェントを組織に送信する前に、次のことを確認してください:
- エージェントのリリース準備が整っていること、および会社の標準、ルール、ポリシーに準拠していること。
- 他のエージェント マネージャーと調整します。 一度エージェントを投稿すると、管理者が前回の投稿を承認または却下するまで、別のユーザーが再投稿することはできません。
- 該当する場合、Teams アプリ ストアの Power Platform で構築 セクションから エージェントを削除します。 そうしないと、管理者の承認のために エージェントを送信すると、2 つの場所に表示される可能性があります。
注:
管理者によってエージェントが承認されると、管理者はTeamsアプリストアの 「Built for your org 」セクションやMicrosoft 365 Agent Storeの 「Built by your org 」セクションでエージェントの可用性を管理します。 管理者のみがこれらのセクションからエージェントを削除できます。
管理者の承認のためにエージェントを提出してください
可用性オプションを選択します。
エージェントがチームメイトや共有ユーザーに表示されていないことを確認します。 Teams に追加と表示されている場合は、削除します。
組織内の全員に表示するを選択します。
送信の要件を確認し、管理者の承認のために送信するを選択します。
注:
コンテンツを確認し、管理者が確認できるようになっていることを確認してください。 以前に承認されたエージェントのアイコンと説明を更新するには、新しい承認リクエストを提出する必要があります。
エージェントが承認されると、Teams およびMicrosoft 365 Copilotのエージェントのすべての新規ユーザーと既存のユーザーが更新プログラムを受け取ります。
新しい承認は、エージェントの詳細を変更する場合にのみ必要です。 エージェントのコンテンツを更新し、必要な頻度で公開できます。 このようなコンテンツの変更を公開した後は、エージェントを再度送信して承認を受ける必要はありません。
最終確認プロンプトが表示されます。
はいを選択して続行します。 エージェントは管理者に承認のために 送信され、送信の状態を示すメモが表示されます。
注:
管理者承認のためにエージェントを提出した後は、組織内の全員より少ないアクセス設定に変更しないでください。
アクセスを全員未満に設定すると、Teams アプリ ストアまたは Microsoft 365 エージェント ストアからエージェントをインストールした後、組織内のユーザーはエージェントとチャットできなくなります。
Microsoft Teams アプリ ポリシー で管理者と協力して、エージェントを見つけてインストールできるユーザーを特定します。
管理者の承認 を待機します。 最新のステータスは、更新を選択するか、公開ページのエージェントを他のユーザーが利用可能にするウィンドウを開くと確認できます。
管理者がエージェントを承認すると、状態は承認済みに更新されます。 エージェントを直接開いて、承認されたバージョンのリンクを他のユーザーと共有できます。
オプションとして、組織内のユーザーにエージェントを自動的にインストールして固定ピン留めするよう、管理者に依頼してください。これにより、ユーザーは Teams のアプリバーから直接アクセスできるようになります。
注:
アプリが 承認 済みと表示されていても、Teamsアプリストアの 「組織用に構築 」セクションに表示されない場合、Teamsアプリが情報をキャッシュしている可能性があります。
サインアウトして再度サインインするか (デスクトップ アプリを使用している場合)、ブラウザーを更新してみてください (Teams Web アプリを使用している場合)。
ユーザーが Teams のチームにエージェントを追加できるようにする
Teams では、ユーザーは特定のチームにエージェントを追加することができます。 エージェントがチームで利用できるようになると、チーム メンバーはチーム内のどのチャネルでもそのエージェントを「@mention」でき、チームメイト全員がそのエージェントからの応答を見ることができます。 この機能は、次の例のような状況で役立ちます:
- エージェントは、最新の販売レポートのインサイトを他の営業チームと共有するなど、コラボレーションをサポートします。
- エージェント自体を手動でインストールすることなく、すべてのチーム メンバーがチーム チャネルまたはプライベート チャットを介してエージェントとやり取りできるようにする必要があります。
2 つのオプションによって、ユーザーが所属しているチームにエージェントを追加できるかどうか、または Teams のグループ チャットや会議チャットに追加できるかどうかが決まります。 これらのオプションを選択すると、エージェントはチームチャンネル、グループチャット、ミーティングチャットの会話履歴にアクセスでき、会話の文脈により適した回答を提供できます。
ユーザーが Teams アプリ ストア またはインストール リンクを使用して、エージェントをインストールするとエージェントに設定したコラボレーション スコープに応じて、次のいずれかのオプションが表示されます。
- エージェントをチーム チャネルに追加する
- Teams のグループ チャットと会議チャットにエージェントを追加する
チームメンバーもチームからエージェントを削除することができます。
Important
エージェントを組織内の全員がチャットできるように設定してください。 この設定により、すべてのチームメンバーがチーム チャネルでエージェントとチャットするアクセス許可を確保できます。 この機能を有効にした後はエージェントのセキュリティ設定を変更しないでください。 そうしないと、Teamsチャンネルやグループチャットでエージェントとやり取りしようとした際に権限エラーが表示されるかもしれません。
ユーザーにチームへのエージェントの追加を許可する方法:
詳細の編集 を選択します。
ユーザーにチームへのこのエージェントの追加を許可するを選択します。
保存を選びます。
Teams が情報をキャッシュするため、ユーザーがエージェントをチームまたはグループチャットに追加するオプションが表示されるまでに時間がかかる場合があります。 ユーザーは、ブラウザを更新 (またはTeams デスクトップ クライアントからサインアウトしてサインインし直す) することで、最新の変更を取得できます。
以前に管理者の承認を得るためにエージェントを送信している場合は、このオプションを有効にした後に再度送信する必要があります。 ユーザーが Teams アプリ ストアの組織向けに構築セクションからエージェントをチームに追加するには、管理者が変更を承認する必要があります。
ユーザーがチーム、グループ、会議のチャットにエージェントを追加できないようにする
このオプションをオフにすると、ユーザーは新しいチーム、グループ、ミーティングチャットにエージェントを追加できなくなります。 すでに使っているユーザーに対してはエージェントが削除されません。 エージェントを手動で 削除 する必要があります。
ユーザーがチームに エージェント を追加できないようにする方法:
詳細の編集 を選択します。
[ ユーザーがこのエージェントをチームに追加できる ] チェック ボックスをオフにします。
保存を選びます。
プライベート挨拶の動作を設定する
エージェントからのプライベートな挨拶は、チームメンバーがエージェントと一対一で話せるようにしたい場合に役立ちます。また、自分でエージェントを手動でインストールする必要がありません。
注:
プライベート グリーティングの設定は、クラシック チャットボットでのみ使用できます。
この動作を設定すると、エージェントは自動的にチームメンバーとの会話を開始します。 エージェントのグリーティング メッセージをカスタマイズするには、挨拶システム トピックを変更する を参照してください。
エージェントがチーム メンバーにどの程度関連性があるかを検討してください。 エージェントの挨拶が、顧客がその使い方を理解できるようにし、制限について説明し、何よりもそれと親しみを持ってもらえるようにしましょう。
エージェントがプライベート挨拶を送信するタイミングを設定する方法:
設定を選択します。
非公開のあいさつオプションを設定します。
保存を選びます。
エージェント用 Teams アプリのマニフェストをダウンロードします (詳細)
エージェントの Teams アプリ マニフェストをダウンロードして、マニフェストに詳細な変更を直接加え、管理者またはテナントのユーザーと共有できます。 また、組織のポリシーでカスタム アプリケーションのアップロードが許可されている場合は、Teams に直接アプリケーション マニフェストをアップロードすることもできます。
可用性オプションを選択します。
.zip のダウンロードを選択します。 マニフェストは .zip ファイルとして生成され、ブラウザの設定に従って保存されます。
Teams で、アプリ>アプリの管理>アプリのアップロード を選択します。
[ カスタマイズされたアプリのアップロード] を選択します。
ダウンロードした .zip ファイルを探します。
エージェントを Teams から接続解除する
エージェントをオフラインにして、ユーザーがTeamsでチャットできなくなります。 エージェントがオフラインの場合、チャットを試みても応答しません。 その前にエージェントとの接続を切る必要性を考慮してください。
切断されたエージェントは、Teams アプリ ストアの Power Platform で構築セクションに表示されず、共有リンクからインストールできません。 ユーザーがそのような エージェントを既に Teams にインストールしている場合は、ユーザーがアンインストールするまで引き続き使用できます。
管理者が承認したエージェントを切断しても、そのエージェントはTeamsアプリストアの 「あなたの組織のためにビルド 」セクションに表示され続けます。 管理者に削除を依頼する必要があります。
[ チャネルの削除] を選択します。
エージェントの接続解除に関する情報を確認し、切断を選択して続行します。
Teams と Microsoft 365 Copilot チャネルの構成パネルで [ チャネルの追加] を選択し、再発行してから Teams にエージェントを再インストールすることで、いつでもエージェントを再接続できます。
注:
TeamsからエージェントをアンインストールせずにTeamsチャンネルを再追加すると、「Add Button」の代わりに「Update Now」ボタンが表示されます。 この場合は、[ 今すぐ更新 ] を選択して Teams にエージェントを再インストールします。
Teams と Microsoft 365 Copilot チャネルの構成パネルを開く
Copilot Studio でエージェントを開きます。
上部のメニュー バーの チャネル を選択します。
Teams と Microsoft 365 Copilot タイルを選択します。 構成パネルが表示されます。
既知の制限
既知の制限は、Teams と Microsoft 365 Copilot のどちらを使用しているかによって異なります。
Teams の既知の制限事項
アップグレードされた統一オーサリングキャンバスを使用するエージェントは、プライベートのグリーティング設定をサポートしていません。
管理者に承認されたエージェントは、詳細ページで アバターアイコンを設定する オプションがありません。 これらのエージェントはアプリのアイコンをアバターとして使っています。
Teamsは エージェントにレート制限を 適用します。 ビジネスのニーズによっては、Teamsに公開するエージェントのコンテンツは簡潔にまとめておくと良いかもしれません。
エージェントが ユーザー認証をサポートしている場合、ユーザーは明示的にサインアウトできません。この動作は、エージェントをセラーダッシュボードに公開している場合、Teams Marketplaceの認証に合格しません。 この制限は、エージェントの個人使用またはテナントでの使用には適用されません。 Teamsストアへのアプリの公開方法やマーケットプレイスの認証ポリシーについて学びましょう。
Teamsチャンネルからエージェントを切断した後、Teamsのユーザーがエージェントに連絡できなくなるまで数分かかることがあります。
Teams グループのチャットとチャネルでは、Copilot Studio エージェントは、SharePoint などのエンド ユーザー認証を必要とするナレッジ ソースを使用できません。 この制限は設計上のものであり、意図しないデータの漏えいを防ぐのに役立ちます。 これらのエージェントは、1 対 1 のチャットでのみサポートされます。
グループチャットとミーティング チャットは、Teams のシングルサインオン (SSO) で手動認証用に構成されたエージェントをサポートしません。 ビジネス ニーズに応じて、Microsoft で認証する か、手動認証から Teams 用 SSOを削除することができます。
カスタマイズされた回答に対して引用文献が表示されない
エージェントが カスタマイズされた応答を持つ生成応答ノードを使用する場合、応答の引用文献は Teams に表示されません。 標準の (カスタマイズされていない) 生成回答とは異なり、Teams はカスタマイズされた回答に引用文献を自動的に追加しません。
Teams でカスタマイズされた生成回答の応答から引用文献をレンダリングするには:
[ 生成応答のプロパティの作成 ] パネルで、[ 詳細設定 ] セクションを展開し、[ LLM 応答の保存] を [完了] (推奨) に設定します。 この設定は、引用メタデータを含む完全な応答をキャプチャします。
トピックのコード エディターで、生成応答ノードの後に
SendActivityノードを追加します。citationEntitiesの下にtext属性とactivity属性を含め、引用文献と応答テキストを保持する変数を指します。- kind: SearchAndSummarizeContent id: search-content latencyMessageSettings: allowLatencyMessage: false autoSend: false variable: Topic.Answer userInput: =System.Activity.Text responseCaptureType: FullResponse - kind: SendActivity id: sendActivity_SnMFMq activity: text: - "{Topic.Answer.Text.Content}" citationEntities: =Topic.Answer.Text.CitationSources
コード エディターを使用したトピックの編集の詳細については、コード エディターを使用したトピックの編集に関 するページを参照してください。
エージェントを公開または再公開した後のSystemError(システムエラー)
ユーザーが Teams でCopilot エージェントと対話すると、次のメッセージが表示されることがあります。
すみません、予期せぬことが起こりました。 調査中です。
エラーコード: システムエラー
この問題は、エージェントを公開または再公開した後もTeamsが以前に公開されたバージョンを使い続ける場合に発生します。 場合によっては、Teamsが更新されたエージェント設定をすぐに更新しないこともあります。 この問題はエージェント実行時に一般的な SystemError を引き起こします。
Workaround
エージェント設定をリフレッシュするには、以下の手順を試してください:
- Microsoft Teams管理センターでエージェントアプリを見つけて無効化し、数秒待ってから再度有効にします。
- Copilot Studio で、エージェントの Teams チャネルをオフにし、変更を保存してから、チャネルをオンに戻します。
- 最新バージョンがTeamsで利用可能になるようにエージェントを再公開してください。
問題が続く場合は、Microsoft サポートに連絡し、 会話ID、 エージェントID、エラー 発生時刻を 伝えてください。
Microsoft 365 Copilot の既知の制限事項
会話の開始トピックがサポートされていません: Microsoft 365 Copilot チャネルは 会話の開始 トピックをサポートしていないため、一般的なあいさつはできません。 代わりにエージェントは提案されたプロンプトを提示します。 アクティビティイベントでトリガーされたトピックで変数を設定できますが、この方法は副作用のため挨拶には最適ではありません。
サポートされていないメディアタイプ:GIF画像のようなメディアはレンダリングされません。
埋め込み URL: Microsoft 365 Copilot は、セキュリティのために埋め込み URL を削除する場合があります。 生成的回答からの引用には、引用文献のセクションに URL を含める必要があります。
サポートされていないノードの種類:
- スピーチ操作
- 顧客サービス担当者への引き渡し
- アダプティブ カード の
Action.Executeの使用
サポートされていないメッセージの種類:
- 基本カード (
ContentFilteredエラー) - ビデオ (
ContentFilteredエラー) - 画像 (
ContentFilteredエラー) - ファイル
- 音声 (送信なし)
注:
アダプティブ カードを使用して画像を表示できます。
- 基本カード (
非アクティブ トリガーは起動しますが、メッセージを Microsoft 365 Copilot にポストバックしません。
Microsoft 365 Copilot に公開されたエージェントは、ユーザー フィードバック (反応) をサポートしていません。