Microsoft 365 Agents Toolkit を使用して Office アドイン プロジェクトを作成する

Office アドインを含む Microsoft 365 アプリとエージェントを開発するための主要なツールは、Microsoft 365 Agents Toolkit です。

Agents Toolkit で作成されたアドインでは、 Microsoft 365 の統合マニフェストが使用されます。

「 Microsoft 365 Agents Toolkit のインストール」の説明に従って、最新バージョンのエージェント ツールキットを Visual Studio Code にインストールします。

Office アドイン プロジェクトの作成

1. Visual Studio Code を開き、 アクティビティ バーの [エージェント ツールキット] アイコンを選択します。

   

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

3. [ 新しいプロジェクト ] ドロップダウン メニューが開きます。 一覧表示されるオプションは、エージェント ツールキットのバージョンによって異なります。 [ Office アドイン] を選択します。

   

4. [ Office アドインを使用したアプリ機能 ] ドロップダウン メニューが開きます。 一覧表示されるオプションは、エージェント ツールキットのバージョンによって異なります。 [作業ウィンドウ] を選択します。

   

5. 開いた [ワークスペース フォルダー] ダイアログで、プロジェクトを作成するフォルダーを選択します。

6. プロンプトが表示されたら、プロジェクトに名前を付けます (スペースなし)。 Agents Toolkit は、基本的なファイルとスキャフォールディングを使用してプロジェクトを作成します。 次に、 2 番目の Visual Studio Code ウィンドウでプロジェクトを開きます。 元の Visual Studio Code ウィンドウを閉じます。

   注:

   生成されたプロジェクトは、Excel、Outlook、PowerPoint、Wordにインストールできるように構成されています。 必要に応じてマニフェストファイルとソース ファイルを編集して、サポートされている Office アプリケーションを変更できます。

7. Visual Studio Code TERMINAL で、プロジェクトのルートに移動し、 npm installを実行します。

8. インストールが完了したら、Visual Studio Code からアドインをサイドロードできることを確認します。 サイドロードする手順は、アドインをテストする Office アプリケーションによって異なります。

Excel、PowerPoint、または Word でのサイドロード

1. Visual Studio Code で [表示 | Run] を 選択します。 [ 実行とデバッグ ] ドロップダウン メニューで、次のいずれかのオプションを選択します。

   • Excel Desktop (Edge Chromium)
   • PowerPoint デスクトップ (Edge Chromium)
   • Word デスクトップ (Edge Chromium)

2. F5 キーを押します。 プロジェクトがビルドされ、Node dev-server ウィンドウが開きます。 このプロセスには数分かかる場合があります。 最終的に、選択した Office アプリケーションのデスクトップ バージョンが開きます。

   注:

   コンピューターに Office アドインを初めてサイドロードした場合 (または 1 か月を超えて初めて) 場合は、古い証明書を削除したり、新しい証明書をインストールしたりするように求められる場合があります。 両方のプロンプトに同意します。

3. [ホーム] リボンに 2 つのボタンがある Contoso アドイン タブが表示されます。 1 つのボタンを使用して、開いている Office ドキュメントでアクションを実行します。 もう 1 つを使用して、アドインの作業ウィンドウを開きます。

   注:

   選択したボタンに関係なく、 WebView Stop On Load プロンプトが表示されます。 [OK] を選択します。

   ヒント

   Office on Windows でのサイドローディングでは、アドインをOffice on the webで使用できるため、そのプラットフォームでもテストできます。 この手順が完了したら、Windows 上の Office アプリケーション ウィンドウを最小化し、ブラウザーで[ https://excel.cloud.microsoft/]、[ https://word.cloud.microsoft/]、[ https://powerpoint.cloud.microsoft/] の順に移動します。どちらかがテスト対象のアドインに適しています。 Web 上の Office アプリケーションで新しいドキュメントまたは既存のドキュメントを開きます。 ボタンは、Windows 上の Office と同じように [ホーム ] リボンに表示されます。

4. デバッグを停止してアドインをアンインストールするには、[Visual Studio Code で 実行 | Stop デバッグ ] を選択します。

   注:

   上記の手順で効果がない場合は、Visual Studio Code で TERMINAL を 開き、コマンド npm run stopを実行してアドインをアンインストールします。 サーバー ウィンドウを閉じてもサーバーが確実に停止せず、Office アプリケーションを閉じても、Office がアドインの取得を解除する可能性は確実にありません。

サイドロードするその他の方法

Teams のアプリ ストアを通じて、Excel、PowerPoint、または Word アドインをサイドロードする別の方法については、「Microsoft 365 の統合マニフェストを使用する Office アドインをサイドロードする」を参照してください。

Outlook でのサイドロード

1. Microsoft 365 開発者テナントのアカウントが、デスクトップ Outlook のメール アカウントでもあることを確認します。 そうでない場合は、「 メール アカウントを Outlook に追加する」のガイダンスに従ってください。

2. Outlook デスクトップを閉じます。

3. Visual Studio Code で、[エージェント ツールキット] を開きます。

4. [ ACCOUNTS ] セクションで、Microsoft 365 にサインインしていることを確認します。

5. Visual Studio Code で [表示 | Run] を 選択します。 [実行とデバッグ] ドロップダウン メニューで、[Outlook Desktop (Edge Chromium)] オプションを選択し、F5 キーを押します。 プロジェクトがビルドされ、Node dev-server ウィンドウが開きます。 このプロセスには数分かかる場合があり、Outlook デスクトップが開きます。

   注:

   コンピューターに Office アドインを初めてサイドロードした場合 (または 1 か月を超えて初めて) 場合は、古い証明書を削除したり、新しい証明書をインストールしたりするように求められる場合があります。 両方のプロンプトに同意します。

6. Microsoft 365 アカウント ID の受信トレイを開き、任意のメッセージを開きます。 2 つのボタンを含む Contoso アドイン タブが [ホーム ] リボン (またはメッセージ リボン (独自のウィンドウで メッセージ を開いている場合) に表示されます。

7. [ タスクウィンドウの表示 ] ボタンをクリックすると、作業ウィンドウが開きます。 [ アクションの実行 ] ボタンをクリックすると、メッセージの上部近くに小さな通知が表示されます。

   注:

   選択したボタンに関係なく、 WebView Stop On Load プロンプトが表示されます。 [OK] を選択します。

8. デバッグを停止してアドインをアンインストールするには、[Visual Studio Code で 実行 | Stop デバッグ ] を選択します。

   注:

   上記の手順で効果がない場合は、Visual Studio Code で TERMINAL を 開き、コマンド npm run stopを実行してアドインをアンインストールします。 サーバー ウィンドウを閉じてもサーバーが確実に停止せず、Office アプリケーションを閉じても、Office がアドインの取得を解除する可能性は確実にありません。

プロジェクトを開発する

これで、プロジェクトを変更して開発できます。 Office アドインドキュメントのガイダンスが、使用されているマニフェストの種類に応じて分岐する場所では、統合マニフェストのガイダンスに従ってください。