ラボ M0 - 前提条件
このラボでは、Microsoft 365 Copilot の機能を拡張するプラグインを構築、テスト、デプロイするための開発環境をセットアップします。
Teams メッセージ拡張ラボのナビゲーション (Extend Path)
このラボで学ぶこと:
- ラボ全体で使用する開発者テナントのセットアップ方法
- Visual Studio Code 用 Agents Toolkit とその他ツールのインストールおよび構成方法
- ベースプロジェクトを使用した開発環境のセットアップ方法
注意
Microsoft 365 Copilot を拡張するには、開発環境が 要件 を満たしている必要があります。
演習 1: Teams アプリのアップロードを有効化する
カスタム Teams アプリをアップロードできる権限を持つ Microsoft の職場または学校アカウントが必要です。
既定では、エンドユーザーはアプリを直接アップロードできません。管理者がエンタープライズ アプリ カタログにアップロードする必要があります。この手順では、Microsoft 365 Agents Toolkit による直接アップロードが可能になるようテナントを設定します。
- 管理者資格情報で Microsoft Teams 管理センター にサインインします。
- Teams アプリ > セットアップ ポリシー > グローバル に移動します。
- カスタム アプリのアップロード を「オン」に切り替えます。
- 「保存」を選択します。これでテスト テナントでカスタム アプリのアップロードが許可されます。
変更が反映されるまで最大 24 時間かかる場合がありますが、通常はもっと速く反映されます。
演習 2: Agents Toolkit と前提ツールをインストールする
これらのラボは Windows、Mac、Linux いずれのマシンでも実施できますが、前提条件をインストールできる権限が必要です。アプリのインストールが許可されていない場合は、別のマシン (または仮想マシン) を使用してください。
手順 1: Visual Studio Code をインストールする
Agents Toolkit for Visual Studio Code は Visual Studio Code が必須です。以下からダウンロードしてください: Visual Studio Code。
手順 2: NodeJS をインストールする
Node.js は コンピューター上で JavaScript を実行できるランタイムです。Google Chrome や Chromium ベースの Microsoft Edge といった一般的なブラウザーで使用されているオープンソースの V8 エンジンを利用しています。本ワークショップ全体で使用する Web サーバー コードを実行するために Node.js が必要です。
https://nodejs.org/en/download/ にアクセスし、OS に合わせてバージョン 18 または 16 をインストールしてください。本ラボは NodeJS バージョン 18.16.0 でテスト済みです。すでに別バージョンの NodeJS がインストールされている場合は、同じコンピューターで Node のバージョンを簡単に切り替えられる Node Version Manager (または Microsoft Windows 向け こちらのバリエーション) の設定を検討してください。
手順 3: ツールをインストールする
これらのラボは、最新の一般提供版 Agents Toolkit を基盤としています。以下のスクリーンショットの手順に従ってください。
1️⃣ Visual Studio Code を開き、拡張機能ツールバー ボタンをクリック
2️⃣ 「Teams」で検索し、Agents Toolkit を探します
3️⃣ 「Install」をクリック
Agents Toolkit をインストール済みで非表示にしている場合
以前に Agents Toolkit をインストールした後、Visual Studio のサイドバーで非表示にした場合、アイコンが見当たらないかもしれません。左サイドバーを右クリックし、Agents Toolkit にチェックを入れて再表示してください。
Azure Storage Explorer
Azure Storage Explorer (任意) - Northwind データベースを閲覧・編集したい場合はダウンロードしてください
演習 3 - プロジェクトと開発者テナント データをセットアップする
手順 1 - サンプル コードをダウンロードする
ブラウザーで こちらのリンク を開きます。Northwind.zip という ZIP ファイルのダウンロードを促されます。
-
ZIP ファイルをコンピューターに保存します。
-
ZIP を展開すると Northwind フォルダーが作成されます。
-
Visual Studio Code を開きます。
Visual Studio Code で:
-
「ファイル」メニューから「フォルダーを開く...」を選択
-
Northwind フォルダーを開きます。
以降のラボでは、この Northwind フォルダーを「ルート フォルダー」または「作業フォルダー」と呼びます。
手順 2 - Agents Toolkit でアカウントを設定する
左側の Agents Toolkit アイコン 1️⃣ を選択します。新規プロジェクト作成オプションが表示される場合は、フォルダーが間違っています。Visual Studio Code のファイル メニューで「フォルダーを開く」を選び、Northwind フォルダーを直接開いてください。下図のように Accounts、Environment などのセクションが見えるはずです。
「Accounts」内の「Sign in to Microsoft 365」2️⃣ をクリックし、自身の Microsoft 365 アカウントでサインインします。
ブラウザーが開き、Microsoft 365 へのサインインを促します。「You are signed in now and close this page」と表示されたら、そのページを閉じてください。
次に、「Custom App Upload Enabled」チェッカーに緑のチェックマークが付いていることを確認します。付いていない場合は、Teams アプリのアップロード権限がないことを意味します。演習 1 の手順を再確認してください。
続いて、「Copilot Access Enabled」チェッカーに緑のチェックマークが付いていることを確認します。付いていない場合は、Copilot のライセンスがアカウントに付与されていないことを示します。これはラボを続行するために必須です。
手順 3 - サンプル ドキュメントをテスト ユーザーの OneDrive にコピーする
サンプル アプリには、ラボ中に Copilot が参照するドキュメントが含まれています。この手順では、これらのファイルをユーザーの OneDrive にコピーして Copilot が検索できるようにします。テナントの設定によっては、多要素認証の設定を求められる場合があります。
ブラウザーで Microsoft 365 (https://www.office.com/) にアクセスし、このラボで使用する Microsoft 365 アカウントでサインインします。多要素認証の設定が求められる場合があります。
ページ左上の「ワッフル」メニュー 1️⃣ から Microsoft 365 の OneDrive アプリ 2️⃣ に移動します。
OneDrive で「マイ ファイル」1️⃣ に移動します。documents フォルダーがある場合はそこに入ります。ない場合は、そのまま「マイ ファイル」で作業してかまいません。
次に「新規作成」1️⃣ →「フォルダー」2️⃣ をクリックして、新しいフォルダーを作成します。
フォルダー名を「Northwind contracts」と入力し、「作成」をクリックします。
新しいフォルダー内で、再び「新規作成」1️⃣ →「ファイルのアップロード」2️⃣ をクリックします。
作業フォルダー内の sampleDocs フォルダーを開き、すべてのファイルを選択 1️⃣ し、「OK」2️⃣ をクリックしてアップロードします。
この手順を早めに行うことで、Microsoft 365 検索エンジンがファイルをインデックスする時間を確保できます。
おめでとうございます
前提条件ラボが完了しました。次はアプリを実行する準備が整いました。下の「Next」ボタンを選択してください。