Microsoft Agent 365 SDK とCLI

エージェント 365 を初めて使用する場合

まず、統合オプションを選びます。 組み込みの統合やレジストリ同期が必要な機能を提供するなら、エージェントを登録するためにSDKを追加する必要はありません。 Google Vertex AIおよびAmazon Bedrockエージェントについては、「 Google Vertex AIおよびAmazon Bedrockエージェントの登録」をご覧ください。

エージェントがコードレベルの統合を必要とする場合は、出発点と望む結果に基づいてパスを選択してください。

出発点 ここから始める 最初の結果 始める前の準備
エージェントがいて、AI支援のオンボーディングを望んでいる場合です。 クイックスタート: Agent 365 Skills を使用して、既存のエージェントを Agent 365 に接続する。 エージェントを登録し、選択した機能を追加し、統合を検証します。 サポートされているスタック、コーディングアシスタント、テナントアクセス、役割、ライセンス要件を確認してください。
エージェントを持っていて、自分でCLIコマンドを実行したい場合です。 エージェントのブループリントを用意しましょう。 エージェントの識別情報と権限を定義するブループリントを作成しましょう。 CLI、テナント ロール、Azure サブスクリプションの要件を確認し、Agent identityを使って ID モデルを選択します。
自分のエージェントを変えるよりも、サンプルプロジェクトで学ぶべきです。 Python、Node.js、または .NET のサンプルを選びましょう。 サンプルを設定し、Agents Playgroundで最初の応答を受け取ります。 選択したクイックスタートまたはサンプルREADMEの前提条件(ランタイム、モデルアクセス、認証設定など)を確認しましょう。

サンプルパスについては、カタログにはPython + Microsoft Agent Framework、Node.js + LangChain、Node.js + Claude Agent SDK のクイックスタート、さらに .NET サンプルへのリンクがあります。 利用可能なフレームワークを見るには、カタログで言語を選択してください。

Note

ローカル応答があるだけでは、ライブの Microsoft 365 ツールや通知、テレメトリが動作している証拠にはなりません。 テナントに基づく機能については、テナント、同意、ライセンス要件およびテスト認証設定を確認してください。

Agent 365 SDK

Agent 365 SDK を使用すると、任意のエージェント SDK やプラットフォームで構築されたエージェントに、ID 管理、通知、セキュリティ、 Microsoft 365 データへの管理されたアクセス機能を追加できます。 可観測性にはMicrosoft OpenTelemetryを使いましょう。

Tip

事前構築済みのエージェントをお探しですか? 起動時に事前に統合されているエージェントについては、 エージェント 365 で使用可能なエコシステム パートナー エージェントを参照してください。

エージェントは独自のアイデンティティを持っています。 ユーザーは、一般的なジェスチャ (エンタープライズ ユーザーが通常操作するアプリ (Teams、Word、Outlook など) で @mentions) など) を使用して呼び出します。 彼らは信頼を築き、監査可能な行動を実行し、ツールやデータへの安全なアクセスを通じて観察可能な行動を示します。

Agent 365 SDKを使えば、エージェントは以下を行えます:

  • Entra支援のエージェントIDを、メールボックスなどの独自のユーザーリソースで安全に認証し、ツールやデータへのアクセスを管理しましょう。
  • teams、Outlook、Wordコメント、メールからの通知を受信して応答します。これは、Microsoft 365 アプリの人間の参加者と同じです。
  • Open Telemetryを通じて完全な観測性を得られ、監査され追跡可能なエージェント間のやり取り、推論イベント、ツールの使用が可能になります。
  • 管理されたモデル コンテキスト プロトコル (MCP) サーバーを呼び出して、管理下にあるMicrosoft 365ワークロード (メール、予定表、SharePoint、Teams など) にアクセスします。
  • IT承認のブループリントシステム内で機能し、各エージェントインスタンスがコンプライアンス、ガバナンス、セキュリティポリシーを継承することを保証します。

Agent 365のSDK概要を確認してください。

エージェント 365 CLI

Agent 365 CLI は、エージェント開発ライフサイクル全体を通じてエージェント 365 のコマンドライン バックボーンです。エンタープライズ対応エージェントのセットアップ、ID、構成、MCP 統合、発行、およびAzure展開の自動化。

Agent 365 CLIを使えば、開発者は以下のことができます:

  • エージェントの設計図と、それに必要なすべての支援リソースを作成します。
  • エージェントの既定の Work IQ ツール、アクセス許可、ツールを管理します。
  • エージェント コードをAzureにデプロイします。
  • エージェントアプリケーションパッケージをMicrosoft管理センターに公開します。
  • CLI によって作成されたエージェントブループリント、ID、およびその他のAzureリソースをクリーンアップします。

Agent 365 CLIについて詳しくはこちら

エージェント365 エージェント開発ライフサイクル

Agent 365は、任意のエージェントSDKやプラットフォーム上で構築されたエージェントと連携します。 これには、Copilot Studio や Azure AI Foundry などのローコード プラットフォームが含まれます。 また、Microsoft Agent Framework、Microsoft Agents SDK、OpenAI Agents SDK、Claude Code SDK、LangChain SDKなどのプロコードオプションもサポートしています。 Agent 365 は、Azure、アマゾン ウェブ サービス (AWS)、Google Cloud Platform (GCP)、その他のクラウド プロバイダーなど、あらゆるエンドポイントでホストされているエージェント コードでも機能します。

既存エージェントのクイックスタートは、登録、選択された機能、検証をカバーしています。 デプロイ、公開、クリーンアップには別々のガイドがあります。 あなたのシナリオに該当するフェーズを続けてください:

Phase ガイド
デプロイ前にインテグレーションを検証してください。 エージェント365 SDKの検証チェックリスト と エージェントのテスト。
エージェントコードをデプロイしてください。 Azure、AWS、またはGoogle Cloud Platform。
エージェントをパッケージ化して公開する。 Microsoft管理センターにエージェントを公開します。
デプロイ済みのエージェントインスタンスを作成・検証します。 エージェントインスタンスを作成し、デプロイしたエージェントをテストしてください。
不要になったリソースを削除する。 CLIのクリーンアップに関するリファレンス。詳細なクリーンアップおよびドライラン オプションが含まれます。

エージェント365 エージェント設計図

エージェント365エージェントの実例を扱う前に、エージェント365エージェントの設計図とは何かを理解することが役立ちます。 これは、Microsoft Entra エージェント ブループリント から取得され、IT が承認したエージェントの種類の事前構成済みの定義であり、基本的に、準拠しているエージェントを作成できるエンタープライズ "テンプレート" です。 エージェントの機能、必要な Work IQ ツールのアクセス、セキュリティとコンプライアンスの制約、監査要件、ライフサイクル メタデータ、DLP、外部アクセス制限、ログ記録ルールなどのリンクされたガバナンス ポリシー テンプレートが定義されます。 テナントで使用するためにブループリントがアクティブ化されると、ユーザーは、Microsoft 365管理センターのエージェント ブループリントから作成された新しいエージェント インスタンスの管理者を要求できます。 すべてのエージェント インスタンスはブループリントのルールを継承し、メール、予定表、Teams、SharePointアクセス、およびエージェントが触れるその他のMicrosoft 365ワークロード全体で一貫したガバナンスを確保します。 これによりシャドウエージェントやローグエージェントを防ぎ、可観測性を強制し、各エージェントを安全なEntraバックアップのアイデンティティおよび権限モデルに固定します。

Agent 365 SDKはどのように違うのでしょうか?

Agent 365 SDKは、Microsoft Agent FrameworkやMicrosoft Copilot Studioのようなエージェントフレームワークとは異なり、エージェントを作成またはホストしません。 その代わりに、基盤となるスタックに関係なく、すでに構築済みのエージェントを強化します。具体的には、Entra ベースのエージェント ID、管理された Work IQ ツールへのアクセス、Activity プロトコルによる通知、エージェント ID に基づくガバナンスなどのエンタープライズ機能を追加することで、エージェントの機能を強化します。 オブザーバビリティにはMicrosoft OpenTelemetryを使いましょう。

名前は非常に似ていますが、Microsoft 365 エージェント SDKとホスティング、アクティビティ プロトコル、ID に対して提供される機能は置き換えられません。 一方で、Agent 365 SDKは、Agentや他のプラットフォームで構築されたエージェントの上にガバナンス、コンプライアンス、ライフサイクルコントロールを重ねることで補完的です。

この図は、既存のエージェントをAgent 365 対応にする方法を示します

Agent 365 SDKとエージェントエコシステム

この表はレイヤードエージェントアーキテクチャをまとめており、Agent 365 SDKがエージェントロジックや選択したフレームワークが提供するLLMオーケストレーターランタイムの上にエンタープライズ機能を追加する仕組みを示しています。

レイヤー Role 提供元 (例えば、データプロバイダー)
エンタープライズ機能 Agent 365 SDKによる識別、通知、ツール;Microsoft OpenTelemetryによる観測可能性 Agent 365 SDKとMicrosoft OpenTelemetry
エージェント ロジック プロンプト、ワークフロー、推論 あなたのコードでの実装
LLM オーケストレーター実行環境 モデル呼び出しとツール オーケストレーション お好みのエージェントSDK/フレームワーク

次のステップ