Microsoft Agent 365 SDKは、すでに所有し実行しているエージェントをMicrosoft Agent 365に接続します。 エージェントがエージェントID、可観測性、制御されたWork IQツール、通知などAgent 365の機能にコードレベルでアクセスする必要がある場合に利用してください。
SDKがどこに位置づけられるか
統合モデルは、組み込みの統合、レジストリ同期、開発者統合のAgent 365 SDKシナリオの境界を示しています。
Agent 365と統合されたプラットフォーム上のエージェントや、レジストリ同期を通じてインポートされたエージェントは、すでにAgent 365のインベントリに表示できます。 エージェントがプラットフォームパスにない機能を必要とし、コード内で設定しなければならない場合(例えば観測可能性やWork IQツールなど)SDKを追加します。 プラットフォーム統合は進化するため、SDKが必要かどうか判断する前に現在のプラットフォームガイダンスを確認してください。 「 統合オプションを選ぶ」をご覧ください。
SDKが追加すること
SDKは以下の4つの機能を提供します:
| Capability | Description |
|---|---|
| アイデンティティ | Microsoft Entraで支援されたエージェントIDを使用して、安全な認証とツールやデータへの管理されたアクセスを実現します。 独自のユーザーアカウントとメールボックスが必要なエージェントは、Frontierプレビュープログラムに参加しているテナントのみが利用可能です。 |
| 可観測性 | OpenTelemetryを通じてテレメトリを発信し、監査済みで追跡可能なインタラクション、推論イベント、ツールの使用を生成します。 |
| ツール | Invokeは、管理管理下でMail、カレンダー、Word、SharePoint、TeamsなどのMicrosoft 365ワークロードにアクセスできるために、Work IQ Model Context Protocol(MCP)サーバーを制御していました。 |
| 通知 | Teams、Outlook、Wordのコメント、メールからのメッセージを受け取り、返信できるのは、Microsoft 365アプリの人間参加者のようにです。 この機能はエージェントのユーザーアカウントを必要とし、Frontierプレビュープログラムに参加しているテナントのみが利用可能です。 |
SDKサーフェス全体を採用するのではなく、エージェントの要件に合った機能を選択してください。 アイデンティティ、ツール、通知はEntraの基盤としてエージェントアイデンティティブループリントを使用しています。 通知にはエージェントユーザーアカウントが必要ですが、観測機能はエージェントのアイデンティティブループリントまたは標準のMicrosoft Entraアプリ登録のいずれかを使用できます。
SDKはPython、JavaScript、.NET向けの言語別パッケージで提供されています。 選択した機能用のパッケージをインストールし、対応するアイデンティティ、権限、ランタイム統合を設定します。 利用可能なパッケージについては、 Agent 365 SDKパッケージをご覧ください。
Microsoft Agent 365 SDKとMicrosoft 365 エージェント SDKを比較してください
Microsoft Agent 365 SDKとMicrosoft 365 エージェント SDKは別々の製品です。
| Microsoft Agent 365 SDK (This SDK) | Microsoft 365 エージェント SDK |
|---|---|
|
エージェントを育てるわけでもない。 既に存在するエージェントを拡張して、アイデンティティ、観測可能性、ツール、通知を追加します。 |
会話エージェントを構築するためのフレームワーク。 TeamsやMicrosoft 365 Copilotなどのチャネル間でのメッセージ配信を担当し、会話の状態も管理します。 |
これら2つのSDKは連携しているため、Microsoft 365 エージェント SDKでエージェントを構築し、Agent 365 SDKを使ってアイデンティティ、観察可能性、ツール、通知を付与できます。
それが何で何でないか
エージェントを機能させる三つの層を引き続き所有しています:
| レイヤー | Description |
|---|---|
| Model | エージェントが呼びかける言語モデルや推論エンジン。 SDKはモデルを呼び出したり選択したりしません。 |
| フレームワークまたはランタイム | LangChain、Microsoft Agent Framework、Semantic Kernel、OpenAI Agents SDK、Claude Agent SDK、またはカスタムコードなどがあります。 SDKはエージェントの作成、ステップの計画やオーケストレーション、ツールの実行を行いません。 |
| Host | 現在、エージェントが動いている場所、例えばAzure、AWS、Google Cloud、またはオンプレミスなど、どこでも対応可能です。 SDKはエージェントをホストしたりデプロイしたりしません。 |
Microsoft Agent 365 SDKはこれらのレイヤーと並行して動作します。 エージェントの構築、ホスト、デプロイ、オーケストレーション、実行は行いません。
Note
Microsoft Agent 365 SDKは、ガバナントされたMCPサーバーを登録するため、エージェントはMicrosoft 365ワークロードにアクセスできますが、実行時は引き続きツール呼び出しを実行します。
オンボーディングの流れ
統合は4つの段階を経ます。
| 段階 | Description |
|---|---|
| 1. 登録 | Microsoft EntraでエージェントIDのブループリントとエージェントIDを作成します。 |
| 2. 拡張 | エージェントが必要とする機能、例えば観測可能性、Work IQツール、通知機能などを追加しましょう。 |
| 3. 検証 | エージェントを以前通り実行し、本人確認、テレメトリ、ツールアクセス、メッセージ処理を確認します。 |
| 4. 運用 | Agent 365のコントロールを使って接続されたエージェントを管理・監査してください。 |
これらの手順は手動で行うか、サポートされているコーディングアシスタントの Agent 365 Skills を利用することもできます。 スキルはセットアップを導き、必要な変更を行い、結果を検証します。
リクエストの流れ
単一のインタラクションで4つの機能すべてを利用できます。 誰かがあなたのエージェントにWordコメントで@mentionsったとき:
- 通知は代理店にその情報を伝えます。
- 識別と認証によって、エージェントが自分自身として行動するのか、サインインしたユーザーの代理として行動するのか、エージェントのユーザーアカウントを通じて行動するのかを決定します。 選択したモード、権限、同意、トークンの主体が利用可能なデータやアクションを定義します。
- ツールリングはエージェントに必要なMicrosoft 365データへのガバナードされたアクセス権を提供します。
- 可観測性は呼び出し、ツール呼び出し、モデル推論を記録します。
その後、エージェントがコメント欄で返信します。
Agent 365 SDK パッケージ
対応言語のパッケージマネージャーでAgent 365のSDKパッケージを見つけてください。
Python用のAgent 365 SDKパッケージはPythonパッケージインデックス(PYPI)にあります。
| Package | Description |
|---|---|
| microsoft-agents-a365-notifications | AI エージェント アプリケーションの通知とメッセージング拡張機能。 Microsoft 365 アプリケーションのさまざまなチャネルとサブチャネルにわたるエージェント通知、ライフサイクル イベント、ルーティングを処理するためのユーティリティを提供します。 |
| microsoft-agents-a365-observability-core | OpenTelemetry 上に構築された AI エージェントのテレメトリ、トレース、および監視コンポーネント。 コンテキスト伝搬とプラグイン可能なエクスポーターを使用して、エージェントの呼び出し、ツールの実行、LLM 推論の構造化スパンを提供します。 |
| microsoft-agents-a365-observability-extensions-agent-framework | Microsoft Agent Framework 向け監視の拡張機能。 Agent Framework ベースのアプリケーション専用の OpenTelemetry トレース統合を提供します。 |
| microsoft-agents-a365-observability-extensions-openai | OpenAI Agents SDK 向け監視の拡張機能。 OpenAI エージェント ベースのアプリケーション向け OpenTelemetry トレース統合と、エージェント ワークフローとツール呼び出し用の自動インストルメンテーションを提供します。 |
| microsoft-agents-a365-observability-extensions-langchain | LangChain フレームワーク向け監視の機能拡張。 チェーン、エージェント、ツールの自動インストルメンテーションを使用して、LangChain ベースの AI アプリケーション向け OpenTelemetry トレース統合を提供します。 |
| microsoft-agents-a365-observability-extensions-semantic-kernel | Semantic Kernel フレームワークの可観測性拡張。 カーネル関数、プラグイン、およびプランナー用の自動インストルメンテーションを使用して、Semantic Kernel ベースのアプリケーションの OpenTelemetry トレース統合を提供します。 |
| microsoft-agents-a365-runtime | AI エージェント アプリケーションのコア ランタイム ユーティリティと環境管理。 Power Platform API の基本的な検出、環境の構成、認証スコープの解決を提供します。 |
| microsoft-agents-a365-tooling | Microsoft Agent 365 SDK を使用して構築されたアプリケーションでの MCP (モデル コンテキスト プロトコル) ツール サーバー管理のコア ツーリング機能。 さまざまな AI フレームワークにわたってツール サーバーを検出、登録、管理するための基盤を提供します。 |
| microsoft-agents-a365-tooling-extensions-agentframework | AI エージェント開発用の Agent Framework 固有ツールとサービス。 Agent Framework エージェントに MCP (モデル コンテキスト プロトコル) サーバーを動的に追加するための MCP ツール登録サービスを提供します。 |
| microsoft-agents-a365-tooling-extensions-openai | AI エージェント開発用の OpenAI Agents SDK 固有ツールとサービス。 OpenAI Agents SDK ベースのエージェントに MCP (モデル コンテキスト プロトコル) サーバーを動的に追加するための MCP ツール登録サービスを提供します。 |
| microsoft-agents-a365-tooling-extensions-semantickernel | AI エージェント開発のためのSemantic Kernelに関連するツールとサービス。 MCP サーバーを Semantic Kernel ベースのエージェントに動的に追加するための MCP (モデル コンテキスト プロトコル) ツール登録サービスを提供します。 |
| microsoft-agents-a365-tooling-extensions-azureaifoundry | Azure AI Foundryに特化したAIエージェント開発のためのツールとサービス。 MCP サーバーを Azure AI Foundry エージェントに動的に追加するための MCP (モデル コンテキスト プロトコル) ツール登録サービスを提供します。 |