重要
TeamsFx SDK は 2025 年 9 月までに正式に非推奨となり、サポートは 2026 年 9 月まで継続されます。 Microsoft Teamsでエージェントを構築するために Teams SDK への移行を計画することをお勧めします。 他の Microsoft 365 プラットフォーム間でエージェントの機能を拡張するには、Microsoft 365 エージェント SDKを使用します。
ツール、SDK、およびライブラリを使用して、Microsoft Teams アプリをビルドして開発します。 現在、Microsoft は、Teams アプリをシームレスに作成、開発、テスト、デバッグ、発行するための包括的なプラットフォームを提供し、プロセス全体を効率的かつ合理化します。 Teams には、次のプラットフォームが用意されています。
ツール
Teams プラットフォームには、Teams アプリを構築および開発するためのさまざまなツールが用意されています。 アプリをビルドするには、次のツールを使用できます。
| ツール | なぜ必要なのですか? | 環境 | テストとデバッグ |
|---|---|---|---|
| Microsoft 365 Agents Toolkit (以前は Teams Toolkit と呼ばれる) | エージェント ツールキットを使用すると、Teams のアプリ開発を簡単に開始できます。 組織 (LOB アプリ) シナリオ用に構築された一般的なカスタム アプリのプロジェクト テンプレートから始めるか、サンプルから開始できます。 Visual Studio Code と Visual Studio を使用した自動アプリの登録と構成により、セットアップにかかる時間を節約できます。 |
Visual Studio Code: JavaScript と TypeScript Visual Studio: .NET と Blazor |
Visual Studio Code と Visual Studio で |
| Microsoft 365 Agents Toolkit CLI (以前は Teams Toolkit CLI と呼ばれる) | Agents Toolkit CLI は、Teams アプリケーション開発を高速化するテキスト ベースのコマンド ライン インターフェイス (CLI) です。 これは、Teams アプリケーションを構築するときにキーボード中心のエクスペリエンスを提供することを目的としています。 | JavaScript と .NET | コマンド プロンプトを使用する |
| Teams の開発者ポータル | Teams 用開発者ポータルは、Teams アプリを構成、配布、管理するための主要なツールです。 開発者ポータルでは、基本的なアプリ マニフェスト (以前は Teams アプリ マニフェスト) を作成し、アプリを Teams に発行できます。 | すべての言語をサポート | Teams の開発者ポータル |
エージェント ツールキットを使用した Teams アプリの構築に関する詳細。
| Agents Toolkit | |
|---|---|
| 環境変数 |
.env ファイルを使用する |
| マニフェストの生成 | Agents Toolkit は、プロジェクトの作成時に自動生成されます。 |
| Teams アプリを展開する | use コマンドを自動的に更新する Microsoft 365 Agents: Update Teams App |
| Microsoft Entra アプリを作成する | プロジェクトのデバッグまたはプロビジョニング時に自動的に作成されます。 ユーザーは、ファイルに Teams アプリ ID を入力することで、既存のMicrosoft Entra アプリ.env使用することもできます。 |
| SSO の追加 | SSO 対応のサンプルと、SSO を追加するためのハウツー ガイドを提供します。 |
| ボットまたはメッセージ拡張機能の登録 | プロジェクトのデバッグまたはプロビジョニング時に自動的に作成されます。 ユーザーは、独自のボット ID を指定することもできます。 |
| アプリ Node.js 公開する | タブ: localhost + HTTPS およびその他: Dev Tunnel |
| アプリ Node.js 実行する | npm run atk:dev |
| ワンクリック デバッグ | F5 または Visual Studio Code と Visual Studio でのデバッグ |
Teams のワークフロー
AI を統合することで、Teams でワークフローを作成できます。 Teams チャットでワークフローを管理および使用したり、毎週のリマインダーを送信したり、絵文字を使用してアクションをトリガーしたりするなどの実用的なワークフローのアイデアを含めることができます。 詳細については、「 Microsoft Teamsでワークフローを追加または実行する」を参照してください。
SDK とライブラリ
Teams プラットフォームを使用すると、さまざまな SDK、ライブラリ、API を使用して、Teams アプリを構築および開発できます。
Teams 開発者プラットフォーム SDK & ライブラリ
重要
- Teams AI ライブラリの名前が Teams SDK に変更されました。
- Teams AI ライブラリ v1 は非推奨になりました。 更新された Teams SDK を使用するようにエージェントをアップグレードすることをお勧めします。
Teams SDK は JavaScript と C# で一般公開され、開発者プレビューで Python がサポートされるようになりました。 簡略化された SDK、モデル コンテキスト プロトコル (MCP)、エージェント間通信 (A2A) のサポート、および開発者が Teams のインテリジェント エージェントを構築できるようにする合理化されたツールが提供されます。
| SDK とライブラリ | なぜ必要なのですか? | 関連する SDK とライブラリ |
|---|---|---|
| TeamsFx SDK | TeamsFx では、Teams シングル サインオン (SSO) を使用し、構成がゼロの単一行ステートメントにクラウド リソースにアクセスすることで、タスクが簡略化されます。 |
Bot Framework SDK、Teams JavaScript クライアント ライブラリ、Microsoft Graph SDK によって異なります。
Teams SDK とアダプティブ カードで使用できます。 |
| Teams JavaScript クライアント ライブラリ | Teams JavaScript クライアント ライブラリ (TeamsJS) を使用すると、Teams、Microsoft 365 アプリ、Outlook 内でホストされているエクスペリエンスを作成できます。 これらのエクスペリエンスには、iFrame でアプリ コンテンツをホストする必要があります。 | 参照を SharePoint Framework (SPFx) に渡すことができます。
Microsoft Graph SDK、アダプティブ カード、Fluent UI React コンポーネントで使用できます。 |
| SharePoint Framework (SPFx) | SharePoint Framework (SPFx) は、クライアント側の SharePoint 開発を完全にサポートし、SharePoint データとシームレスに統合し、Microsoft TeamsとMicrosoft Vivaを拡張するページおよび Web パーツ モデルを提供します。 |
Microsoft Graph SDK、アダプティブ カード、Fluent UI React コンポーネントで使用できます。
SharePoint REST API に基づく。 |
| Live Share SDK | Live Share は、専用のバックエンド コードを記述することなく、Teams アプリを共同作業のマルチユーザー エクスペリエンスに変えるために作成された SDK です。 |
Microsoft Graph SDK、アダプティブ カード、Fluent UI React コンポーネントで使用できます。
参照を Teams JavaScript クライアント ライブラリに渡すことができます。 |
Teams アプリを構築するためのコア SDK とライブラリ
| SDK とライブラリ | なぜ必要なのですか? | 関連する SDK とライブラリ |
|---|---|---|
| Bot Framework SDK | Microsoft Bot FrameworkとAzure AI Bot Serviceは、インテリジェント ボットの構築、テスト、デプロイ、管理を可能にするライブラリ、ツール、サービスのコレクションです。 Bot Framework には、ボットを構築し、AI サービスに接続するためのモジュール式の拡張可能な SDK が含まれています。 | Azure Bot Serviceに基づく。 |
| Microsoft Graph SDK | Microsoft Graph SDK は、Microsoft Graph にアクセスする高品質で効率的で回復力のあるアプリケーションの作成を簡素化するように設計されています。 SDK には、サービス ライブラリとコア ライブラリなどの 2 つのコンポーネントが含まれています。 | Microsoft Graph に基づく。 |
| Teams SDK | Teams SDK は、GPT ベースの共通言語モデルとユーザー 意図エンジンへの Teams 中心のインターフェイスです。 これにより、大規模言語モデル (LLM) と統合するための会話ボット ロジックの記述と管理の複雑でコストのかかるタスクを処理する必要が減ります。 |
Bot Framework SDK に依存します。
Azure OpenAI に基づく。 |
Teams アプリをビルドするための追加のライブラリと UI ユーティリティ
| SDK とライブラリ | なぜ必要なのですか? | 関連する SDK とライブラリ |
|---|---|---|
| アダプティブ カード | カスタマイズができるカードで、テキスト、音声、画像、ボタン、入力フィールドの任意の組み合わせを含めることができます。 | TeamsFx SDK、Teams JavaScript クライアント ライブラリ、SharePoint Framework (SPFx) で使用できます。 |
| Fluent UI React コンポーネント | Fluent UI React コンポーネントは、@fluentui/reactや@fluentui/react-northstarなど、運用環境で使用されるさまざまなReact ベースのコンポーネント ライブラリを組み合わせることから得た UI 要素とツールのコレクションです。 |
Teams JavaScript クライアント ライブラリとSharePoint Framework (SPFx) で使用できます。 |
| Fluid Framework | Fluid Framework は、共有状態の分散と同期に役立つクライアント ライブラリで構成されます。 これらのライブラリを使用すると、複数のクライアントが、ローカル データの操作に使用されるものと同様のコーディング パターンを使用して、共有データ構造を同時に作成および操作できます。 | 参照を Live Share SDK に渡すことができます。
Azure流体リレーに基づく。 |
Microsoft Entra IDセキュリティで保護されたサービスと API
| SDK とライブラリ | なぜ必要なのですか? | 関連する SDK とライブラリ |
|---|---|---|
| Azure Bot Services | Azure Bot Serviceは、インテリジェント ボットの構築、テスト、デプロイ、管理を行うライブラリ、ツール、サービスのコレクションです。 | Bot Framework SDK に使用されます。 |
| Azure OpenAI | Azure OpenAI Service は、GPT-3、Codex、Embeddings モデル シリーズを含む OpenAI の強力な言語モデルへの REST API アクセスを提供します。 また、新しい GPT-4 および ChatGPT (gpt-35-turbo) モデル シリーズがプレビューで利用可能になりました。 これらのモデルは、コンテンツの生成、要約、セマンティック検索、自然言語からコードへの翻訳など、特定のタスクに適応できます。ただし、これらに限定されません。 | Teams SDK に使用されます。 |
| Microsoft Graph | Microsoft Graph は、Microsoft 365 のデータとインテリジェンスへの入り口です。 Microsoft Graph は、Microsoft 365、Windows、および Enterprise Mobility + Security の膨大な量のデータにアクセスする際に使用できる統合型プログラミング モデルを提供します。 Microsoft Graph の豊富なデータを使用して、数百万人のユーザーを操作する組織やコンシューマー向けのアプリを作成できます。 | Microsoft Graph SDK に使用されます。 |
| SharePoint REST API | 表現状態転送 (REST) Web 要求をサポートする任意のテクノロジを使用して、SharePoint データをリモートで操作できます。 SharePoint によって提供される REST インターフェイスを使用して、基本的な作成、読み取り、更新、削除 (CRUD) 操作を実行できます。 | SharePoint Framework (SPFx) に使用されます。 |
| Azure液リレー | Fluid Framework は、プラットフォームに依存しないオープンソースフレームワークです。 Azure Fluid Relay は Fluid Framework のマネージド サービスであり、開発者がリアルタイムのコラボレーション エクスペリエンスを構築し、接続された JavaScript クライアント間で状態をリアルタイムでレプリケートするのに役立ちます。 | Fluid Framework に使用されます。 |
推奨事項
| ツール | 詳細 |
|---|---|
| Microsoft 365 Agents Toolkit | Agent Toolkit v5 を使用してアプリをビルドすることをお勧めします。Agent Toolkit v4 は機能が制限されている場合にのみ使用できます。 |
| Microsoft 365 Agents Toolkit CLI | TeamsFx CLI v1 と v2 は限られた機能でのみ使用できるように、 エージェント ツールキット CLI を使用して Teams アプリをビルドすることをお勧めします。 |
Platform Docs