Microsoft 365 Copilotのエージェントとしてボットベースのメッセージ拡張機能を拡張する

注:

• organizationでMicrosoft 365 Copilotが使用可能であることを確認します。 Microsoft 365 Copilotの開発環境を取得するには、次の 2 つの方法があります。
  • Microsoft 365 Copilotを持つサンドボックス Microsoft 365 テナント (TAP メンバーシップを通じて限定プレビューで利用できます)。
  • Microsoft 365 Copilot ライセンスを持つ適格な Microsoft 365 またはOffice 365運用環境。
• ボットベースの検索メッセージ拡張エージェントは、 パブリック開発者プレビューで使用できます。
• Microsoft 365 Copilotのエージェントとして拡張できるのは、検索コマンドを含むボットベースのメッセージ拡張機能のみです。

高度な処理とオーケストレーション エンジンを搭載したMicrosoft 365 Copilot、Microsoft 365 アプリ、Microsoft Graph、および L 言語モデル (LLM) を統合して、単語を強力な生産性ツールに変換します。 Microsoft 365 Copilotは Microsoft 365 エコシステム内のアプリとデータを利用できますが、多くのユーザーは、仕事の管理とコラボレーションのためにさまざまな外部ツールとサービスに依存しています。 Microsoft 365 Copilotでエージェントとしてメッセージ拡張機能を拡張することで、ユーザーがサード パーティのツールやサービスと対話できるため、Microsoft 365 Copilotでより多くの機能を実現できます。 この拡張機能を実現するには、エージェントを開発するか、外部データ ソースに接続します。

エージェントとは

エージェントを使用すると、Microsoft 365 Copilotはサード パーティのデータ、アプリ、サービスと直接やり取りし、その機能を強化し、その機能の範囲を広げることができます。 エージェントでは、次のMicrosoft 365 Copilotを許可します。

• 製品発売時の最新ニュースカバレッジなど、リアルタイムの情報を取得します。
• Figma でチームのデザイン ファイルなどの知識ベースの情報を取得します。

説明は、メッセージ拡張エージェントの使いやすさと有効性を高めます。 次の説明では、アプリの機能の明確で簡潔な概要を示します。

• アプリの説明: アプリの説明は、Teams ストアでのアプリの検出可能性を向上させるのに役立ちます。
• コマンドの説明: コマンドの説明は、ユーザーの意図と発話をマップしてエージェント内のコマンドを検索し、ユーザーの意図とキーワードの分析に基づいて構築する必要があります。
• パラメーターの説明: パラメーターの説明では、出力形式の自然言語でのシステムの要件について説明します。
• セマンティックの説明: セマンティックの説明は Microsoft 365 Copilot、エージェントの機能とシナリオの概念的な理解を提供し、ユーザーの目標を達成し、ユーザーの意図をエージェントの機能と一致させることで、コンテンツを生成するのに役立ちます。

詳細については、「 エージェントを作成およびアップグレードするためのガイドライン」を参照してください。

エージェントサポートの対象となるすべてのボットベースの検索メッセージ拡張機能は 、ポリシー要件 を満たす必要があり、エージェントが品質、セキュリティ、プライバシー、および有用性の期待を満たしていることを確認するために検証の対象となります。 ボットベースの検索メッセージ拡張機能は、Teams Toolkit for Visual Studio Code、Visual Studio、Teams Toolkit コマンド ライン インターフェイス (CLI)、または開発者ポータル for Teams を使用して作成し、メッセージ拡張機能を拡張して、Microsoft 365 Copilotでエージェントとして機能させることができます。

前提条件

作業を開始する前に、Microsoft 365 Copilotのメッセージ拡張エージェントを構築するための次の標準とガイドラインに精通していることを確認してください。

• Teams ストアの検証ガイドラインに記載されているコンプライアンス、パフォーマンス、セキュリティ、およびユーザー エクスペリエンスに関する標準。

• Microsoft 365 Copilotのメッセージ拡張エージェントを作成またはアップグレードするためのガイドライン。

ボットベースのメッセージ拡張機能を作成する

重要

Microsoft 365 Copilotのエージェントはプレビュー段階にあり、Microsoft 365 Copilot in Teamsでのみ機能します。

Teams 用のボットベースの検索メッセージ拡張機能エージェントを作成し、Microsoft Teams クライアントの新規作成メッセージ領域を通じて結果をMicrosoft 365 Copilotして共有しましょう。

Visual Studio Code

作業を開始する前に、次のツールをインストールして、メッセージ拡張機能をビルドして展開してください。

• 最新の Teams Toolkit プレリリース バージョンをインストールします。
• [Copilot プラグインの開発] 機能フラグが有効になっていることを確認します。 機能フラグを有効にするには、次の手順に従います。
  1. Visual Studio Code を開きます。
  2. [管理>設定] に移動します。
  3. [検索設定] 検索ボックスに「Teams Toolkit」と入力します。
  4. [ 拡張機能] で、[ Fx 拡張機能: Copilot プラグインの開発 ] チェック ボックスをオンにします。

Visual Studio Code を使用してボットベースの検索メッセージ拡張機能エージェントを作成するには、次の手順に従います。

1. Visual Studio Code を開きます。

2. 左側のウィンドウで、[ Teams ツールキット] を選択します。

3. [ 新しいアプリの作成] を選択します。

4. [ メッセージ拡張機能] を選択します。

5. [ カスタム検索結果] を選択します。

6. [ ボットから開始] を選択します。

   

7. プログラミング言語を選択します。

8. [ 既定のフォルダー] を選択します。

9. アプリの名前を入力し、[Enter] を選択 します。 Teams Toolkit によってアプリがスキャフォールディングされ、メッセージ拡張機能が作成されます。

Teams でメッセージ拡張機能を実行するには、次の手順に従います。

1. 左側のウィンドウで、[ Teams ツールキット] を選択します。

2. [ ACCOUNTS] で、次の手順を実行します。

   1. [ Microsoft 365 にサインイン] を 選択し、Microsoft 365 資格情報を入力します。

   2. [ Azure にサインイン] を 選択し、Azure 資格情報を入力します。

      

3. 左側のウィンドウで、 実行とデバッグ (Ctrl + Shift + D) を選択します。

4. [ Teams でのデバッグ (Edge)] または [ Teams でのデバッグ (Chrome)] の順に選択します。 Teams Toolkit は、Web ブラウザーを使用して Teams でアプリを起動します。

5. [追加] を選択します。 アプリは Teams にインストールされます。

6. チャットに移動し、[ アクションとアプリ] を選択します。

7. メッセージ拡張機能のポップアップ メニューから、検索ボックスにメッセージ拡張機能の名前を入力します。

8. メッセージ拡張機能を選択し、検索クエリを入力します。

9. 一覧から製品を選択します。 Teams は、メッセージ作成領域で製品をアダプティブ カードとして展開します。

10. [送信] を選びます。

Microsoft 365 Copilotでメッセージ拡張機能をトリガーする

Microsoft 365 Copilot in Teamsでエージェントとしてメッセージ拡張機能をトリガーするには、次の手順に従います。

1. [アプリ] を選択します。

2. Copilot を検索し、Microsoft 365 Copilotを開きます。

3. 右上隅にある [パネル] を選択します。

4. 右側のウィンドウから必要なエージェントを選択します。

   

5. メッセージ作成領域からMicrosoft 365 Copilotにメッセージを送信して、Teams とMicrosoft 365 Copilotから最新の更新プログラムを検索します。

   

注:

このプロンプトでは、Microsoft 365 Copilotでメッセージ拡張機能からの応答が必ずしも確実に行われるとは限りません。 これが発生した場合は、別のプロンプトを試すか、Microsoft 365 Copilot応答をダウンボッティングしてメッセージを残してフィードバックを送信します。

Visual Studio

作業を開始する前に、次のツールをインストールして、メッセージ拡張機能をビルドして展開してください。

• Visual Studio Enterprise 2022 Preview バージョン 17.9.0 Preview 1.0 以降をインストールし、ASP.NET および Web 開発ワークロードの下にMicrosoft Teams開発ツールをインストールします。
• Copilot 機能フラグが有効になっていることを確認します。 機能フラグを有効にするには、次の手順に従います。
  1. Visual Studio を開きます。
  2. [ツール>オプション] に移動します。
  3. [検索設定] 検索ボックスに「Teams Toolkit」と入力します。
  4. [ プレビュー機能 ] セクションで、[ Teams ツールキット: Copilot プラグインの開発 ] チェック ボックスをオンにします。
• マルチプロジェクト起動プロファイルが有効になっていることを確認します。 プロファイルを有効にするには、次の手順に従います。
  1. Visual Studio を開きます。
  2. [ツール>オプション] に移動します。
  3. [ プレビュー機能 ] セクションで、[ 複数プロジェクト起動プロファイルを有効にする ] チェック ボックスをオンにします。

Visual Studio を使用してボットベースの検索メッセージ拡張機能エージェントを作成するには、次の手順に従います。

1. Visual Studio を開きます。

2. [ファイル>New>Project... または [新しいプロジェクトの作成] に移動します。

3. Teams を検索し、[アプリのMicrosoft Teams] を選択します。

4. プロジェクトの詳細を入力します。 [ ソリューションとプロジェクトを同じディレクトリに配置する ] チェック ボックスがオンになっていないことを確認します。

5. [作成] を選択します。

6. [ カスタム検索結果] を選択します。

   

7. [作成] を選択します。 プロジェクトはスキャフォールディングされています。

8. [デバッグ] ドロップダウン メニューで、[ Dev Tunnel>トンネルの作成] を選択します。

   
   

   1. トンネルを作成するアカウントを選択します。 Azure、 Microsoft アカウント (MSA)、 GitHub は、サポートされているアカウントの種類です。
   2. [名前]: トンネルの名前を入力します。
   3. トンネルの種類: [永続的] または [ 一時的] を選択します。
   4. アクセス: [ パブリック] を選択します。
   5. [OK] を選択します。 Visual Studio では、トンネルが作成されたことを示す確認メッセージが表示されます。

   作成したトンネルは、 Dev Tunnel > (トンネルの名前) の下に一覧表示されます。

9. [ソリューション エクスプローラー] に移動し、プロジェクトを選択します。

10. プロジェクト メニューを右クリックし、 Teams Toolkit>Prepare Teams アプリの依存関係を選択します。

    

    メッセージが表示されたら、Microsoft 365 アカウントでサインインします。

11. [デバッグ] ドロップダウン メニューで、[ Microsoft Teams (ブラウザー)] を選択します。 Visual Studio が Teams Web クライアントを起動します。

12. [追加] を選択します。 メッセージ拡張機能が Teams に追加されます。

    

13. チャットに移動し、[ アクションとアプリ] を選択します。

14. メッセージ拡張機能のポップアップ メニューから、検索ボックスにメッセージ拡張機能の名前を入力します。

15. メッセージ拡張機能を選択し、検索クエリを入力します。

    

16. 一覧から製品を選択します。 Teams は、メッセージ作成領域のアダプティブ カードに製品を展開します。

17. [送信] を選びます。 アダプティブ カードがチャットに送信されます。

    

Microsoft 365 Copilotでメッセージ拡張機能をトリガーする

Microsoft 365 Copilotでエージェントとしてメッセージ拡張機能をトリガーするには、次の手順に従います。

1. Visual Studio に移動します。

2. デバッグ ドロップダウンで、[ Copilot (ブラウザー)] を選択します。 Visual Studio が Teams Web クライアントを起動します。

   

3. Teams Web クライアント>Apps に移動します。

4. Copilot を検索し、Microsoft 365 Copilotを開きます。

5. 右上隅にある [パネル] を選択します。

6. 右側のウィンドウから必要なエージェントを選択します。

   

7. メッセージ作成領域からMicrosoft 365 Copilotにメッセージを送信して、Teams とMicrosoft 365 Copilotから最新の更新プログラムを検索します。

   

注:

このプロンプトでは、Microsoft 365 Copilotでメッセージ拡張機能からの応答が必ずしも確実に行われるとは限りません。 これが発生した場合は、別のプロンプトを試すか、Microsoft 365 Copilot応答をダウンボッティングしてメッセージを残してフィードバックを送信します。

Toolkit CLI

作業を開始する前に、環境変数DEVELOP_COPILOT_PLUGINを true に設定してください。 環境変数を設定するには、次の手順に従います。

1. コンピューターで、 Windows + X キーを選択します。

2. [ システム] を選択します。

3. [ バージョン情報>デバイスの仕様] で、[ システム設定の詳細設定] を選択します。

4. [ システムのプロパティ] で、[環境変数]を選択 します。

5. [ ユーザー変数] で[新規]を選択 します。[ 新しいユーザー変数] ダイアログが開きます。

6. 次のフィールドを更新します。

   1. 変数名: DEVELOP_COPILOT_PLUGIN
   2. 変数値: true

7. [OK] を選択します。

   

Teams Toolkit CLI を使用してボットベースの検索メッセージ拡張機能エージェントを作成するには、次の手順に従います。

1. [コマンド プロンプト] に移動します。

2. 次のコマンドを入力します:

   npm install -g @microsoft/teamsapp-cli
   

3. ターミナルに「 teamsapp new 」と入力します。

4. [ メッセージ拡張機能] を選択します。 方向キーを使用してオプションを切り替えます。

   

5. [ カスタム検索結果] を選択します。

6. [ ボットから開始] を選択します。

   

7. プロジェクトの場所を入力し、[Enter] を選択 します。

8. アプリケーションの名前を入力し、[Enter] を選択 します。

   Teams Toolkit は、指定した場所にプロジェクトをスキャフォールディングして作成します。

9. プロジェクトが作成されるフォルダー パスに移動し、次のコマンドを入力して Azure でアプリをプロビジョニングします。

    teamsapp provision --env dev
   

   Teams Toolkit CLI によってブラウザー ウィンドウが開き、Microsoft アカウントへのサインインを要求します。

10. Microsoft アカウントにサインインします。 Teams Toolkit CLI は、Azure で検証を実行し、アプリをプロビジョニングします。

11. 一覧からサブスクリプションを選択します。

    

12. 一覧からリソース グループを選択します。

13. メッセージを受信した場合は、 使用量に応じてコストが発生する可能性があります。上記のアカウントを使用して開発環境でリソースをプロビジョニングしますか?、 「Y」と入力します。

    

    Teams Toolkit は、アプリ マニフェストを検証し、Azure でアプリをプロビジョニングします。

14. コマンド プロンプト ウィンドウで、次のコマンドを入力して、Teams でアプリをプレビューします。

     teamsapp preview --env dev
    

    Teams Web クライアントが表示された新しいブラウザー ウィンドウが開きます。 アプリを Teams に追加できます。

15. [追加] を選択します。 メッセージ拡張機能が Teams に追加されます。

16. チャットに移動し、[ アクションとアプリ] を選択します。

17. メッセージ拡張機能のポップアップ メニューから、検索ボックスにメッセージ拡張機能の名前を入力します。

18. メッセージ拡張機能を選択し、検索クエリを入力します。

Microsoft 365 Copilotでメッセージ拡張機能をトリガーする

Microsoft 365 Copilot in Teamsでエージェントとしてメッセージ拡張機能をトリガーするには、次の手順に従います。

1. [アプリ] を選択します。

2. Copilot を検索し、Microsoft 365 Copilotを開きます。

3. 右上隅にある [パネル] を選択します。

4. 右側のウィンドウから必要なエージェントを選択します。

   

5. メッセージ作成領域からMicrosoft 365 Copilotにメッセージを送信して、Teams とMicrosoft 365 Copilotから最新の更新プログラムを検索します。

   

注:

このプロンプトでは、Microsoft 365 Copilotでメッセージ拡張機能からの応答が必ずしも確実に行われるとは限りません。 これが発生した場合は、別のプロンプトを試すか、Microsoft 365 Copilot応答をダウンボッティングしてメッセージを残してフィードバックを送信します。

Teams の開発者ポータル

Teams 用開発者ポータルを使用してボットベースのメッセージ拡張機能を作成するには、次の手順に従います。

1. Teams 用開発者ポータルに移動します。

2. [アプリ] に移動します。

3. [ + 新しいアプリ] を選択します。

4. [ アプリの追加] ページで、名前を更新し、マニフェストバージョンを パブリック開発者プレビュー (devPreview) として選択します。

   

5. [ 構成] で、[ アプリの機能] を選択します。

6. [ メッセージング拡張機能] を選択します。

7. [ メッセージ拡張機能の種類] で、[ボット] を選択 します。

   1. API Message 拡張機能を読み取る免責事項がユーザーによって既に使用されている場合。メッセージ拡張機能の種類を bot に変更しますか? [ はい、変更] を選択します。

      

8. 既存のボットがある場合は、[ 既存のボット ] を選択するか、ボット ID がある場合は [ ボット ID の入力] を選択します。

   1. ボット ID がない場合は、[ 新しいボットの作成] を選択して新しいボットを作成し、作成した新しいボットのボット ID を入力できます。

      

9. [保存] を選択します。

10. [ コマンド] で、[ + コマンドの追加] を選択します。

    コマンド ページの追加が表示されます。

11. [コマンドの追加] ページ で、コマンド の種類として [検索 ] を選択し、次のフィールドを更新します。

    • コマンド ID
    • コマンドのタイトル
    • コマンドの説明
    • コマンドが機能するコンテキスト
    • パラメーター名
    • パラメーターのタイトル
    • パラメータの説明

12. [保存] を選択します。 コマンドがメッセージ拡張機能に追加されます。

13. [保存] を選択します。

ボットベースの検索メッセージ拡張機能が作成されます。

Teams 用開発者ポータルで作成されたボットベースのメッセージ拡張機能をテストするには、次の方法を使用します。

• Teams でのプレビュー: 開発者ポータルでメッセージ拡張機能を開き、右上隅 にある [Teams でプレビュー ] を選択します。 Teams にリダイレクトされ、アプリを Teams に追加してアプリをプレビューできます。

• アプリ パッケージのダウンロード: メッセージ拡張機能ページで、左側のウィンドウで [ アプリ パッケージ ] を選択し、ウィンドウの左上隅にある [ アプリ パッケージのダウンロード] を選択します。 アプリ パッケージは、.zip ファイル内のローカル コンピューターにダウンロードされます。 アプリ パッケージをチームにアップロードし、メッセージ拡張機能をテストできます。

Microsoft 365 Copilotでのエージェントのテストの詳細については、「デバッグ エージェントの選択」を参照してください。

ステップ バイ ステップのガイド

詳細なガイドに従って、Microsoft 365 Copilot用のボットベースの検索メッセージ拡張エージェントを構築します。

関連項目

• API を使用してメッセージ拡張機能をビルドする
• メッセージ拡張機能のアクション コマンドを定義する
• Microsoft 365 Copilot の拡張
• エージェントのMicrosoft 365 Copilotに関する FAQ