Microsoft 365 Copilot カスタム プラグインを使いこなす:ステップバイステップ ガイド
By Mirko Peters ·
Microsoft 365 Copilot のカスタム プラグインを使いこなすための総合ガイドへようこそ。手作業の自動化、ワークフローの効率化、お気に入りの外部アプリケーションと日々の生産性スイートの連携を実現したいなら、まさにうってつけの場所です。カスタム プラグインを構築すると、標準機能の枠を超えて Microsoft 365 を拡張でき、組織をより効率的かつ安全に運用できます。
Automatically translated with AI from the original post. Read the English original
Microsoft 365 カスタム プラグインを使いこなすための総合ガイドへようこそ。日々の作業の手作業を自動化し、ワークフローを効率化し、お気に入りの外部アプリケーションを日々の生産性スイートに直接連携させたい方には、まさにうってつけの内容です。カスタム プラグインを構築すると、標準機能の枠を超えて Microsoft 365 を拡張でき、組織をより効率的かつ安全に運用できるようになります。
これらの概念が実際の業務シナリオにどう当てはまるのかを具体的に理解するには、関連ポッドキャスト エピソードの「Build Custom Microsoft 365 Copilot Plugins」をお聴きいただくことをお勧めします。このエピソードでは、アーキテクチャ、デプロイ戦略、実践的なユースケースを詳しく解説しており、Microsoft 365 のカスタマイズ スキルを次のレベルへ引き上げるのに役立ちます。
カスタム プラグインとは
カスタム プラグインを使うと、Microsoft 365 を自社の要件に合わせて拡張し、カスタマイズできます。タスクを自動化し、異なるアプリを連携させ、データを操作する新しい方法を作成できます。カスタム プラグインを構築すると、ワークフローをより細かく制御でき、生産性が向上します。
Microsoft 365 のプラグインの種類
Microsoft 365 にはいくつかの種類のプラグインがあります。それぞれ目的が異なり、適したシナリオも異なります。
- Plugins:Microsoft Dynamics 365 のイベント ハンドラーとして動作します。特定の操作が行われたときに実行され、ビジネス ロジックの追加や変更ができます。
- Extensions:Dynamics 365 に機能を追加します。カスタム アプリの作成やワークフローの自動化に使用できます。
- Teams Message Extensions:Teams のチャットから直接 Web サービスとやり取りできます。自然言語を使って検索したり、アクションを実行したりできます。
- Microsoft Power Platform Connectors:Microsoft 365 とother apps や サービスを接続し、自動化を容易にします。
カスタム プラグインと標準の拡張機能を比較した概要は次のとおりです。
| 項目 | カスタム プラグイン | 標準の拡張機能 |
|---|---|---|
| 適用範囲 | より広範なカスタマイズが可能 | カスタマイズの範囲は限定的 |
| 連携 | さまざまなサービスと連携できるが、認定が必要になる場合がある | Microsoft サービスとの連携が容易 |
| 機能 | 没入型のエクスペリエンスやコンテキストに沿ったアクションに対応 | 主に標準的な機能に重点を置いている |
ユースケースとメリット
カスタム プラグインは、日々の業務を改善するさまざまな用途に使えます。
- 承認や通知など、複雑なビジネス プロセスを自動化する。
- システムに保存される前にデータを検証または変更する。
- Microsoft 365 を外部のアプリやデータベースと連携させる。
- 特定のイベント発生時のデータの動作を制御する。
- カスタム ダッシュボードやレポートを作成し、より良い洞察を得る。
カスタム プラグインを使うと、不要な手順を省いて時間を節約できます。タスクの完了を長時間待つ必要もなくなります。また、エラーを減らし、システムの信頼性を高められます。ユーザー主導の操作とシステム タスクを分離しておくことで、将来の拡張にも備えられます。
ヒント:重要度の低いタスクはバックグラウンドで実行するようにオフロードしましょう。これにより、メインの作業を速くスムーズに保てます。
Copilot プラグインの例
Copilot プラグインは、Microsoft 365 全体でデータを統合し、ワークフローを効率化する方法を示すものです。このプラグインは Planner、SharePoint、Teams の更新情報をまとめます。簡単な質問を投げかけるだけで、プロジェクトのリアルタイムな状況がわかります。たとえば「「Project Apollo」の進捗はどこまで進んでいますか?」と尋ねると、すぐに正確な回答が得られます。
Copilot プラグインは、最新の情報を取得するために Microsoft Graph と SharePoint REST API を使用します。外部のデータソースに接続するため、常に最新の詳細を確認できます。また、シンプルなマニフェストと安全な認証も使用します。これにより、データが保護され、組織のルールにも従えます。
開発環境のセットアップ
Microsoft 365 向けのカスタム プラグインの構築を始める前に、開発環境を準備する必要があります。このセットアップにより、スムーズな作業に必要なツールと構成が揃います。
必要なツール
作業を始めるにはいくつかのツールが必要です。それぞれのツールがプラグイン開発で重要な役割を果たします。
- Visual Studio 2022 または同様の統合開発環境(IDE)は、コードの記述とデバッグに役立ちます。
- Microsoft.CrmSdk.CoreAssemblies などの Dynamics 365 SDK や NuGet パッケージには、プラグイン開発用のライブラリとテンプレートが含まれています。
- Dynamics 365 インスタンスを使うと、実際の環境でプラグインを登録してテストできます。
- Microsoft 365 Agents Toolkit と Office アドイン向けの Yeoman Generator を使うと、プロジェクトの雛形作成と管理を効率よく行えます。
- 最良の開発環境を得るため、常に最新バージョンの Visual Studio をインストールし、Office/SharePoint 開発ワークロードを含めてください。
開発者アカウント
Microsoft 365 の開発者アカウントが必要です。このアカウントがあれば、プラグイン開発に必要なツールやサービスを利用できます。無料の Microsoft 365 開発者プログラムに登録して始めることができます。
IDE と拡張機能
作業の流れに合った IDE を選択してください。Visual Studio 2022 は人気の高い選択肢です。適切な拡張機能を追加すれば、Visual Studio Code も利用できます。Office アドインおよび SharePoint 開発向けの拡張機能を必ず追加してください。
Node.js と npm
コンピューターに Node.js と npm をインストールします。これらのツールは、プロジェクトの依存関係の管理やスクリプトの実行に役立ちます。多くの Microsoft 365 開発ツールは、プラグインのビルドとパッケージ化に Node.js を利用しています。
前提条件のインストール
必要な前提条件を次の手順でインストールします。
- Teams 管理センターでサイドローディングを有効にします。[Teams アプリ] に移動し、[セットアップ ポリシー] を選択して、[カスタム アプリのアップロード] をオンにします。
- Teams クライアントで [アプリ] に移動し、[アプリの管理] を選択して、サイドロードしたカスタム アプリを管理します。
- Power Platform 管理者に依頼して、Power Platform 管理センターで生成 AI 機能を有効にしてもらいます。
- Microsoft 365 テナントの管理者に、Microsoft 365 管理センターで Copilot Studio アプリを展開してもらいます。
ヒント: これらの設定にアクセスできない場合は、管理者チームに確認してください。
環境の構成
プラグインを作成するのに最適な環境を次のように設定します。
- 割引の検証や正味金額の計算など、ユースケースを明確に定義します。
- 事前操作や同期実行など、適切なステージとモードを選択します。
- 防御的なコードを記述します。エラーを防ぐために、null チェックと深度チェックを含めてください。
- フィルタリング属性と、更新用の事前イメージを指定してプラグインを登録します。構成には環境変数を使用します。
- さまざまなシナリオをテストし、Plugin Trace Log を使ってパフォーマンスを監視します。大量トランザクションをシミュレートして、スケーラビリティを確認してください。
カスタム プラグインの作成: プロジェクトの作成
Microsoft 365 向けにカスタム プラグインを作成する際、最初のステップはプラグインの種類を正しく選ぶことです。この選択によって、機能、統合オプション、ユーザー エクスペリエンスが決まります。プラグインの種類ごとに適した用途が異なるため、プロジェクトの目標に合った種類を選んでください。
プラグインの種類を選択
いくつかのプラグインの種類から選択できます。それぞれに固有のユースケースと異なるメリットがあります。
Office アドイン
Office アドインを使うと、Word、Excel、PowerPoint などのアプリを拡張できます。カスタム作業ウィンドウ、コンテンツ、コマンドを追加できます。これらのアドインを使うと、Office アプリの中で直接データを操作したり、タスクを自動化したり、外部サービスと連携したりできます。
Teams 拡張機能
Teams 拡張機能を使うと、Microsoft Teams に新しい機能を追加できます。メッセージ拡張機能、タブ、ボットを作成できます。これらの拡張機能を使うと、Teams を離れることなく情報にアクセスしたり、ワークフローを開始したり、共同作業を行ったりできます。
Outlook アドイン
Outlook アドインは Outlook の操作性を高めます。メールの作業を自動化したり、カスタム アクションを追加したり、他のアプリと連携したりできます。これらのアドインを使うと、メッセージの管理、会議の予定作成、外部データの取り込みが行えます。
ヒント: プラグインの種類は、必ずビジネスシナリオに合わせてください。たとえば、チャットベースのワークフローには Teams 拡張機能を、ドキュメントの自動化には Office アドインを使います。
プロジェクト テンプレートの利用
プロジェクト テンプレートを使うと、すぐに開発を始められ、セットアップのミスを防げます。Yeoman ジェネレーター、Visual Studio、Microsoft 365 Agents Toolkit などのツールを利用できます。これらのツールが、必要な基本ファイルとフォルダーを作成します。
プロジェクト構造の初期化
プロジェクトを初期化する際は、HTML、CSS、JavaScript または TypeScript を使用します。ユーザー インターフェイスの構築には React を選ぶ開発者も多くいます。チームのスキルに応じて、JavaScript と TypeScript のどちらかを選択してください。
- セットアップを効率化するには、Microsoft 365 Agents Toolkit または Yeoman Generator を使用します。
- コードを、スクリプト、スタイル、アセット用の明確なフォルダーに整理します。
- Microsoft 365 とプラグインがどのように連携するかを定義するマニフェスト ファイルを含めます。
プラグイン コードの開発
プラグイン アーキテクチャ
まず、堅牢なプラグインアーキテクチャを設計します。この工程によって、プラグインの動作、拡張性、セキュリティが決まります。Microsoft 365のプラグインでは、多くの場合レイヤー構造の設計が使われます。変更されることのない中核機能を担う基盤レイヤーを構築します。中間レイヤーには、リージョン間で共有するカスタマイズを配置します。最上位レイヤーでは、プロジェクトごとに個別の変更を加えられます。この構造により、プラグインを拡張しやすくなり、保守も容易になります。
コア機能の追加
プラグインを有用なものにするために、コア機能を追加します。これらの機能によって、Microsoft 365のアプリを接続し、タスクを自動化し、ユーザー エクスペリエンスを向上させます。
Microsoft Graph との統合
Microsoft Graph との統合により、外部のデータソースにアクセスできます。Planner、SharePoint、Teams、その他のMicrosoft 365サービスからリアルタイムの情報を取得できます。これにより、データの関連性と適時性が向上します。
SharePoint REST API
SharePoint REST API を使うと、SharePoint のリストやドキュメントを操作できます。更新を自動化したり、プロジェクトのステータスを取得したり、ファイルを管理したりできます。この API を使うと、さまざまなソースのデータを統合できます。
セキュアな認証
Microsoft 365 プラグインは、強固な認証で保護する必要があります。セキュアな認証によってデータが安全に保たれ、不正アクセスを防げます。プラグインを構築する際には、ユーザーやサービスがどのように本人確認を行うかを決定します。この工程は、すべての組織にとって重要です。
| 認証方法 | 説明 |
|---|---|
| Windows Hello for Business | 指紋や顔認識などの生体情報を使用し、安全なパスワードレスのアクセスを実現します。 |
| FIDO2 セキュリティキー | USB キーなどの物理デバイスを使用し、パスワードを使わずに強力な認証を提供します。 |
| Azure AD 証明書ベース認証 | デジタル証明書と多要素認証チェックを使用して、セキュリティをさらに強化します。 |
プラグインのデプロイとテスト
ビルドとパッケージ化
プラグインをテストまたはデプロイする前に、Microsoft 365 プラグインのビルドとパッケージ化を行う必要があります。この工程により、コードとすべての依存関係がさまざまな環境で使用できる状態になります。以下の手順に従って、プラグインを安全にビルドしてパッケージ化してください。
ローカルテスト
プラグインをローカルでテストすると、問題を早期に発見できます。このプロセスを容易にするために、いくつかのツールを利用できます。これらのツールは、ローカルでのテスト、統合、デバッグをサポートします。
Microsoft 365 へのデプロイ
ローカルテストが完了したら、プラグインを Microsoft 365 にデプロイできます。ファイルを Azure Storage にアップロードし、マニフェスト ファイルを編集してホストされたファイルを参照するように設定したうえで、Microsoft 365 管理センターの「統合アプリ」から、一元展開を使用してアドインを公開します。
ベストプラクティスとトラブルシューティング
互換性のヒント
カスタム プラグインを Microsoft 365 のアプリやデバイス間でスムーズに動作させたいところです。まず、プラグインの種類ごとにサポートされているプラットフォームを確認します。Office アドイン、Teams 拡張機能、Outlook アドインには、それぞれ固有の互換性要件があります。さまざまなブラウザーやオペレーティング システムでプラグインをテストしてください。
パフォーマンスの最適化
プラグインを高速に動作させ、大量のデータを処理できるようにしたいところです。非同期操作の利用、データのキャッシュ、アセットの圧縮、大量データセットへのページング処理の活用によって、コードを最適化します。
セキュリティに関する考慮事項
プラグインとユーザーデータを保護する必要があります。Microsoft Entra ID を使用した OAuth などのセキュアな認証方式を利用してください。最小特権の原則を適用し、シークレットは Azure Key Vault に安全に保管し、ユーザー入力は必ず検証してください。
よくある問題
Microsoft 365 向けのカスタム プラグインを構築する際、スレッドセーフティやコンテキストに関する問題、大量処理時のパフォーマンスのボトルネック、予期しない例外処理の問題に直面することがあります。必ず十分にテストし、トレースログを使用して問題を迅速に診断してください。
Microsoft 365 向けのカスタム プラグインの構築方法について学びました。環境のセットアップ、適切なプラグインの種類の選択、安全なコードの開発、ソリューションのデプロイを行いました。さらに詳しく学び、業界の専門家による議論を聞くには、関連エピソード Build Custom Microsoft 365 Copilot Plugins をぜひご覧ください。
高度な機能を引き続き探求し、Microsoft 365 開発者コミュニティに参加してください。
- 新しい API を試す
- ナレッジを共有する
- Microsoft のリソースで最新情報を入手する
継続的な学習は、より優れたプラグインの開発と職場の効率化につながります。