ボットベースのメッセージ拡張機能をCopilot for Microsoft 365のプラグインとして拡張する

注:

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

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

Teams メッセージ拡張機能を使用したCopilot for Microsoft 365の拡張の詳細については、ビデオを参照してください。

プラグインとは何ですか?

プラグインを使用すると、Copilot for Microsoft 365はサードパーティのデータ、アプリ、およびサービスと直接対話し、その機能を強化し、その機能の範囲を広げることができます。 プラグインを使用すると、次のCopilot for Microsoft 365を実行できます。

• 製品発売時の最新ニュースカバレッジなど、リアルタイムの情報を取得します。
• Figma でチームのデザイン ファイルなどの知識ベースの情報を取得します。
• Contoso チケットの作成など、ユーザーに代わってアクションを実行します。

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

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

詳細については、「説明の 定義」を参照してください。

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

前提条件

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

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

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

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

重要

Microsoft Copilot for Microsoft 365のプラグインはプレビュー段階であり、Microsoft Teams のMicrosoft 365 Chatでのみ機能します。

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

Visual Studio Code

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

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

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

1. Visual Studio Code を開きます。

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

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

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

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

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. [送信] を選びます。

M365 チャットでメッセージ拡張機能をトリガーする

M365 Chat でメッセージ拡張機能をプラグインとしてトリガーするには、次の手順に従います。

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

2. M365 Chat のSearchし、M365 チャット アプリを開きます。

3. [ プラグイン] を選択します。

4. プラグインの一覧から、メッセージ拡張機能のトグルをオンにします。

   

5. メッセージ作成領域から M365 Chat にメッセージを送信して、Teams と Copilot で npm パッケージ情報を検索します。 たとえば、npm-searchlocal で teamsfx-react の npm パッケージ情報を見つけます。

   

注:

このプロンプトでは、M365 チャットにメッセージ拡張機能からの応答が含まれているとは限りません。 その場合は、他のプロンプトを試すか、M365 チャット応答をダウンボッティングしてフィードバックを送信し、メッセージを残します。

Visual Studio

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

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

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

1. Visual Studio を開きます。

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

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

4. [カスタム Search結果] を選択します。

   

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

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

   
   

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

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

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

8. プロジェクト メニューを右クリックし、[Teams ツールキット>] [Teamsアプリの依存関係の準備] を選択します。

   

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

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

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

    

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

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

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

    

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

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

    

M365 チャットでメッセージ拡張機能をトリガーする

M365 Chat でメッセージ拡張機能をプラグインとしてトリガーするには、次の手順に従います。

1. Visual Studio に移動します。

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

   

3. [Teams Web クライアント>アプリ] に移動します。

4. M365 Chat のSearchし、M365 チャット アプリを開きます。

5. [ プラグイン] を選択します。

6. プラグインの一覧から、アプリのトグルをオンにします。

   

7. メッセージ作成領域から M365 Chat にメッセージを送信して、Teams と Copilot で npm パッケージ情報を検索します。 たとえば、npmsearchlocal で teamsfx-react で npm パッケージ情報を見つけます。

   

注:

このプロンプトでは、M365 チャットにメッセージ拡張機能からの応答が含まれているとは限りません。 その場合は、他のプロンプトを試すか、M365 チャット応答をダウンボッティングしてフィードバックを送信し、メッセージを残します。

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/teamsfx-cli@beta
   

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

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

   

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

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

   

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

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

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

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

    teamsfx provision --env dev
   

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

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

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

    

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

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

    

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

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

     teamsfx preview --env dev
    

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

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

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

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

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

M365 チャットでメッセージ拡張機能をトリガーする

M365 チャットを使用してメッセージ拡張機能をトリガーするには、次の手順に従います。

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

2. M365 Chat のSearchし、M365 チャット アプリを開きます。

3. [ プラグイン] を選択します。

4. プラグインの一覧から、アプリのトグルをオンにします。

   

5. メッセージ作成領域から M365 Chat にメッセージを送信して、Teams と Copilot で npm パッケージ情報を検索します。 たとえば、npm-searchlocal で teamsfx-react の npm パッケージ情報を見つけます。

   

注:

このプロンプトでは、M365 チャットにメッセージ拡張機能からの応答が含まれているとは限りません。 その場合は、他のプロンプトを試すか、M365 チャット応答をダウンボッティングしてフィードバックを送信し、[MessageExtension] というタグが付いたメッセージを残します。

Teams の開発者ポータル

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

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

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

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

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

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

   

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

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

   

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

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

   

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

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

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

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

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

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

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

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

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

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

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

Copilot for Microsoft 365 チャットでのプラグインのテストの詳細については、「プラグインの選択のデバッグ」を参照してください。

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

詳細 なガイド に従って、M365 Chat 用のボットベースの検索メッセージ拡張機能プラグインを構築します。

関連項目

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