Microsoft Agent 365 SDKは、すでに所有し実行しているエージェントをMicrosoft Agent 365に接続します。 エージェントのアイデンティティ、ガバナンス対象のWork IQツール、通知などの機能群へのコードレベルのアクセスに利用してください。
SDKがどこに位置づけられるか
Agent 365は、異なるソースのエージェントを一つのコントロールプレーンに集め、組織がそれらを発見し、管理し、大規模に保護できるようにします。 統合経路は、エージェントをどこでどのように構築するかによって異なります:
| エージェントのソース | 統合パス |
|---|---|
| Microsoftのプラットフォームとエージェント、そしてサポートされているサードパーティエージェント | プラットフォームのネイティブなAgent 365連携を活用してください。 これらのエージェントはAgent 365のインベントリに、Agent 365 SDKを追加しなくても表示されます。 |
| Microsoft 365 エージェント SDK、OpenAI Agents SDK、Microsoft Agent Framework、LangChain、CrewAI、LlamaIndexなどのSDKやフレームワークで構築されたエージェント | Work IQツールや通知などの開発者が統合できる機能に対応するために、Agent 365 SDKをエージェントコードに追加します。 |
| Vertex AIやAWS Bedrockのようなコネクテッドエージェントプラットフォーム | 各プラットフォームのレジストリ同期を設定し、エージェントをAgent 365インベントリにインポートします。 |
これら3つの経路はいずれも、エージェントをAgent 365およびそのMicrosoft Entra、Microsoft Defender、Microsoft Purview、Microsoft Intuneとの連携先に接続します。 ネイティブな統合やレジストリ同期は、必ずしもAgent 365 SDKと同じコードレベルの機能を提供するわけではありません。 プラットフォーム連携は進化するので、連携を変更する前に現在のプラットフォームガイダンスを確認してください。 「 統合オプションを選ぶ」をご覧ください。
Agent 365の機能がどのように組み合わさるか
Agent 365の開発者統合は4つの機能を提供します。 Agent 365 SDKは、アイデンティティ、ツール、通知を提供します。 Microsoft OpenTelemetryは以下のオブザーバビリティを提供します:
| 能力 | Description |
|---|---|
| Identity | Microsoft Entra ベースのエージェント ID を使用して、安全な認証とツールやデータへの管理されたアクセスを実現します。 独自のユーザー アカウントとメールボックスが必要なエージェントを利用できるのは、Frontier プレビュー プログラムに参加しているテナントのみです。 |
| 可観測性 | Microsoft OpenTelemetry Distroを別途使用して、監査済みで追跡可能なインタラクション、推論イベント、ツール使用を生成するテレメトリを発行します。 |
| ツール | 管理者の制御下で、Mail、カレンダー、Word、SharePoint、Teams などの Microsoft 365 ワークロードにアクセスするために、Work IQ Model Context Protocol (MCP) サーバーを呼び出します。 |
| 通知 | Teams、Outlook、Word のコメント、メールからのメッセージを受信して応答できます。Microsoft 365 アプリで人間の参加者のように動作します。 この機能はエージェントのユーザーアカウントを必要とし、Frontierプレビュープログラムに参加しているテナントのみが利用可能です。 |
Important
新しいObservability統合には 、廃止されたAgent 365 Observability SDK は使わないでください。 Microsoft OpenTelemetry Distroを使いましょう。 Agent 365のSDKパッケージは引き続き、アイデンティティ、開発ツール、通知の管理に活用してください。
SDKサーフェス全体を採用するのではなく、エージェントの要件に合った機能を選択してください。 アイデンティティ、ツール、通知はEntraの基盤としてエージェントアイデンティティブループリントを使用しています。 通知にもエージェントユーザーアカウントが必要です。 Microsoft OpenTelemetryは、エージェント ID ブループリントまたは標準の Microsoft Entra アプリの登録のいずれかを使用できます。
SDKはPython、JavaScript、.NET向けの言語別パッケージで提供されています。 選択した機能用のパッケージをインストールし、対応するアイデンティティ、権限、ランタイム統合を設定します。 利用可能なパッケージについては、 Agent 365 SDKパッケージをご覧ください。 新しい可観測性統合のために、Microsoft OpenTelemetryを別途インストールしてください。
Microsoft Agent 365 SDKとMicrosoft 365 エージェント SDKを比較
Microsoft Agent 365 SDK とMicrosoft 365 エージェント SDKは別々の製品です。
| Microsoft Agent 365 SDK（この SDK） | Microsoft 365 エージェント SDK |
|---|---|
|
ビルド エージェントを構築しない。 既に存在するエージェントを拡張して、アイデンティティ、ツール、通知を追加します。 Microsoft OpenTelemetryを使って可観測性を追加しましょう。 |
会話エージェントを構築するためのフレームワーク。 TeamsやMicrosoft Copilotなどのチャネルをまたいでメッセージ配信を担当し、会話の状態を管理します。 |
これらのSDKは連携して動作します。 Microsoft 365 エージェント SDKでエージェントを構築し、Agent 365 SDKをID/認証、ツール機能、通知に使用し、Microsoft OpenTelemetryで監視が可能です。
これは何で、何ではないか
エージェントを機能させる3つの層を引き続き管理しています:
| レイヤー | 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のツールや通知にはAgent 365 SDKを使用し、可観測性にはMicrosoft OpenTelemetryを使いましょう。 |
| 3. 検証 | エージェントを以前どおり実行し、その識別情報、テレメトリ、ツールアクセス、メッセージ処理を確認します。 |
| 4. 操作 | Agent 365のコントロールを使って接続されたエージェントを管理・監査してください。 |
これらの手順は手動で行うか、サポートされているコーディングアシスタントの Agent 365 Skills を利用することもできます。 スキルはセットアップを案内し、必要な変更を行い、結果を検証します。
リクエストの流れ
単一のインタラクションで4つの機能すべてを利用できます。 誰かがWordコメントであなたのエージェントを@mentionsでメンションしたとき:
- 通知はエージェントにそのメンションを伝えます。
- 識別と認証によって、エージェントが自分自身として行動するのか、サインインしたユーザーの代理として行動するのか、エージェントのユーザーアカウントを通じて行動するのかを決定します。 選択したモード、権限、同意、トークンの主体が利用可能なデータやアクションを定義します。
- ツールはエージェントに必要なMicrosoft 365データへの管理されたアクセスを提供します。
- 可観測性は呼び出し、ツール呼び出し、モデル推論を記録します。
その後、エージェントがコメント欄で返信します。
Agent 365 SDK パッケージ
対応言語のパッケージマネージャーでAgent 365のSDKパッケージを見つけてください。
Important
以下の表にあるオブザーバビリティ パッケージは非推奨となっています。 新しい統合には使わないでください。 既存の統合を移行する前に、Microsoft OpenTelemetry Distroを使用するか、廃止されたAgent 365 Observability SDKのドキュメントを必ず確認してください。
Python用のAgent 365 SDKパッケージは、Pythonパッケージインデックス(PYPI)で見つけることができます。
| パッケージ | Description |
|---|---|
| microsoft-agents-a365-notifications | AI エージェント アプリケーションの通知とメッセージング拡張機能。 Microsoft 365 アプリケーションのさまざまなチャネルとサブチャネルにわたるエージェント通知、ライフサイクル イベント、ルーティングを処理するためのユーティリティを提供します。 |
| microsoft-agents-a365-observability-core | 廃止:OpenTelemetry上で構築されたAIエージェント向けのレガシーテレメトリ、トレース、モニタリングコンポーネント。 コンテキスト伝搬とプラグイン可能なエクスポーターを使用して、エージェントの呼び出し、ツールの実行、LLM 推論の構造化スパンを提供します。 代わりにMicrosoft OpenTelemetry Distroを使いましょう。 |
| microsoft-agents-a365-observability-extensions-agent-framework | 廃止:Microsoft Agent Framework向けレガシーのオブザーバビリティ拡張。 Agent Framework ベースのアプリケーション専用の OpenTelemetry トレース統合を提供します。 代わりにMicrosoft OpenTelemetry Distroを使いましょう。 |
| microsoft-agents-a365-observability-extensions-openai | 非推奨: OpenAI Agents SDKのレガシーオブザーバビリティ拡張。 OpenAI エージェント ベースのアプリケーション向け OpenTelemetry トレース統合と、エージェント ワークフローとツール呼び出し用の自動インストルメンテーションを提供します。 代わりにMicrosoft OpenTelemetry Distroを使いましょう。 |
| microsoft-agents-a365-observability-extensions-langchain | 非推奨: LangChainフレームワーク用のレガシーオブザーバビリティ拡張。 チェーン、エージェント、ツールの自動インストルメンテーションを使用して、LangChain ベースの AI アプリケーション向け OpenTelemetry トレース統合を提供します。 代わりにMicrosoft OpenTelemetry Distroを使いましょう。 |
| microsoft-agents-a365-observability-extensions-semantic-kernel | 廃止:Semantic Kernelフレームワーク用のレガシー可観測性拡張。 カーネル関数、プラグイン、およびプランナー用の自動インストルメンテーションを使用して、Semantic Kernel ベースのアプリケーションの OpenTelemetry トレース統合を提供します。 代わりにMicrosoft OpenTelemetry Distroを使いましょう。 |
| 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 (モデル コンテキスト プロトコル) ツール登録サービスを提供します。 |