OfficeDev/microsoft-365-agents-toolkit

Microsoft 365 Agents Toolkit

何であるか – Microsoft 365 Copilot、Microsoft Teams、Office アドイン向けの エージェント およびその他の拡張機能を作成、実行、デバッグ、デプロイするための開発者ツール（VS Code 拡張、Visual Studio 拡張、CLI）のセットです。このツールキットは、スケルトン作成、認証ヘルパー、サーバーレス関数統合、CI/CD テンプレートをバンドルしており、アプリの AI ベースのロジックに集中できるように、インフラの構築作業を最小限に抑えます。

コアコンポーネント

パッケージ	役割
vscode-extension	Visual Studio Code 内にウィザード、ホットリロード、セキュアなトンネリング、プレイヤーを追加する IDE プラグイン。
cli	同じ機能のコマンドラインバージョン – キーボード中心のワークフローまたは CI パイプラインに便利。
sdk	クライアントサイドおよびサーバーサイドのコードの両方で Microsoft 365 認証を抽象化する軽量ライブラリ。
api	第三者プラグインがツールキットを拡張できるようにする型定義と契約。
fx-core	IDE と CLI で共有される実装（プロジェクトレベルの設定、ライフサイクル管理など）。
function-extension	Teams アプリに自動的に統合され、認証サポート付きの Azure Functions を追加するヘルパー。
spec-parser	OpenAPI スペックから API ベースのメッセージ拡張コードと Adaptive Card スケルトンを生成する。

主な機能

• Copilot エージェント、Teams チャットボット、タブ、メッセージ拡張、Office アドイン向けのエンドツーエンドのスケルトン作成。
• Microsoft 365 リソース向けの統合認証（シングルサインオン）。
• ホットリロードとセキュアなトンネリングを備えたフルスタックデバッグ、および迅速な反復に適した「エージェントプレイグラウンド」。
• Azure Functions を通じたサーバーレスバックエンド、組み込み認証処理。
• CI/CD サポート – 事前構成済みの GitHub Actions および Azure DevOps パイプライン。
• 複数言語対応 – CLI/VS Code 拡張で JavaScript/TypeScript、Visual Studio 拡張で .NET。

一般的な利用例

1. SharePoint、Outlook、またはカスタム API からデータを取得し、自然言語クエリに応答できる Microsoft 365 Copilot エージェントの構築。
2. Teams AI ライブラリを活用し、ローカルでホットリロードで実行可能な Teams チャットボットの作成。
3. OpenAPI 記述から自動的に生成されるカスタムメッセージ拡張（例：Adaptive Card UI）の追加。
4. ボイラープレート認証コードを書かずに、Azure Functions を使って Teams アプリのサーバーレスバックエンドをデプロイ。

導入方法

• VS Code: Marketplace から Microsoft 365 Agents Toolkit 拡張をインストールし、「新規プロジェクト作成」ウィザードを実行。
• Visual Studio: 対応する拡張をインストールし、.NET エージェント用のプロジェクトテンプレートを使用。
• CLI: npm install -g @microsoft/m365agentstoolkit-cli でインストール後、m365 init で新規プロジェクトをスケルトン化、m365 run でローカルデバッグを開始、m365 deploy で Azure にデプロイ。
• 詳細ドキュメントは https://aka.ms/teamsfx-docs にて。

コミュニティとサポート

• 問題と機能要望: https://github.com/OfficeDev/TeamsFx/issues
• 質問: Stack Overflow タグ teams-toolkit
• 直接フィードバック: ttkfeedback@microsoft.com

ライセンスとガバナンス

• リポジトリは Microsoft の Modern Lifecycle Policy に従っており、外部貢献には貢献者ライセンス契約（CLA）が含まれます。デフォルトでテレメトリが収集されますが、VS Code の FAQ にオプトアウト手順があります。

---

上記のすべての情報は、リポジトリの README から直接取得しています。