宣言型エージェントは、Microsoft 365 Copilot のマネージド オーケストレーションと言語モデル インフラストラクチャで実行されます。 独自の会話ランタイムを実装してホストするのではなく、エージェントの命令、ナレッジ ソース、およびサポートされている機能を構成します。
エージェントは、Microsoft 365 ナレッジ ソース、コード インタープリターなどの組み込み機能、 カスタム スキル (プレビュー)、MCP サーバーまたは REST API によって提供されるアクションを使用できます。 また、接続されたエージェントにタスクを委任することもできます。 使用できるかどうかは、作成ツール、マニフェストのバージョン、ターゲット エクスペリエンス、ライセンス、および組織のポリシーによって異なります。
この記事では、マネージド プラットフォームと、構成または運用するコンポーネントとの境界について説明します。 オーケストレーションとモデル ホスティングを制御できるアーキテクチャとの比較については、「 宣言型エンジン エージェントとカスタム エンジン エージェントの比較」を参照してください。
アーキテクチャ コンポーネント
Microsoft 365 Copilot には、ユーザー要求の解釈、関連するコンテキストの取得、機能の選択、応答の生成を行うランタイムが用意されています。 設定と外部サービスによって、エージェントがタスクを完了するために使用できるサービスが決まります。
| 要素 | マネージド プラットフォーム | 開発者の責任 |
|---|---|---|
| クライアント | サポートされている Microsoft 365 エクスペリエンスで会話をホストします。 | ターゲット エクスペリエンスを選択し、サポートされている対話式操作、ドキュメント コンテキスト、応答形式をテストします。 |
| インフラストラクチャ | Copilot オーケストレーションとモデル ランタイムをホストします。 | エージェントを構成し、エージェントが使用する外部 API、MCP サーバー、またはその他のサービスをホストします。 |
| カタログと配布 | サポートされている取得、公開、管理エクスペリエンスを提供します。 | サポートされているパッケージと配布ルートを選択し、バージョンを維持し、アクセスと展開について管理者と連携します。 |
| セキュリティとコンプライアンス | Microsoft 365 ID、データ アクセス、プラットフォームの保護を適用します。 | アクセス許可と認証を構成し、データ フローを評価し、外部サービスで承認とデータ保護を実施します。 |
| オーケストレーターと言語モデル | 機能を選択して呼び出し、応答を生成します。 | 指示とツールの説明を記述し、サポートされる動作設定を構成して、結果の動作を評価します。 マネージド オーケストレーターをカスタム ランタイム コードに置き換える必要はありません。 |
| 知識と能力 | サポートされているナレッジを取得し、有効な組み込み機能を実行します。 | 関連するソースと機能を選択し、ユーザー アクセスを確認し、取得品質をテストします。 |
| ツール呼び出し | サポートされている統合を使用して、構成された MCP または API アクションを呼び出します。 | ツールの入力と出力を定義し、認証と確認を構成し、信頼性の高いサービス動作を実装します。 |
サポートされている構成設定は、マネージド ランタイムに影響します。実装を完全に制御することはできません。 たとえば、マニフェストでは既定の 応答モードがサポートされており、ユーザーはこれを上書きできます。 選択したマニフェスト スキーマと作成ツールに従って設定を使用できるようにします。
注
取得したコンテンツとツールの応答に、信頼できない命令が含まれている可能性があります。 プラットフォームの保護は、サービスの承認チェックやエージェントの動作の評価に取って代わるものではありません。 該当する データ、プライバシー、およびセキュリティの要件を計画します。
宣言型エージェントのデータ フロー
次の概念フローでは、エージェントがその構成と機能をどのように使用するかを説明します。 これは、固定の実行シーケンスではなく、取得またはツール呼び出しの数を保証するものでもありません。
- 要求を受け取る。 ユーザーは、サポートされているエクスペリエンスでプロンプトを送信します。 会話履歴と使用可能なアプリ コンテキストが要求に含まれる場合があります。
- 関連するコンテキストと機能を選択します。 Copilot は、エージェントの指示、ナレッジ構成、ツールの説明を使用して、要求に対処する方法を決定します。
- 情報を取得したり、アクションを呼び出したりします。 Copilot は、利用可能なナレッジを取得するか、有効な機能を呼び出します。 外部アクションでは、構成された認証と 確認の動作が使用されます。 外部サービスは、独自の承認とビジネス ルールを適用します。
- 応答を生成します。 Copilot は、利用可能なコンテキストと機能の結果を使用して応答します。 タスクに応じて、対話には、さらなる通話、ユーザー入力の要求、または接続されたエージェントへの委任が含まれる場合があります。
宣言型エージェントは、API 呼び出しをチェーンし、ある呼び出しの出力を別の呼び出しの入力として使用し、SharePoint の知識またはコード インタープリターを API アクションと組み合わせることができます。 サポートされているパターンと例については、「 API プラグインでの関数呼び出しのチェーン」を参照してください。
命令はモデルの動作をガイドします。これらは、トランザクション、正確な実行順序、または回復手順を強制する必要があるアプリケーション ロジックの代わりではありません。 これらの要件を API またはワークフロー サービスに実装するか、オーケストレーションを所有する必要がある場合はカスタム エンジン アーキテクチャを評価します。
機能固有の制限を考慮した設計
各機能と統合のガイダンスの制限を確認します。 マニフェスト フィールドの文字数制限、ナレッジ ソース構成制限、およびランタイム コンテキスト制限は、さまざまな制約を表します。
| エリア | 設計に関する考慮事項 | ガイダンス |
|---|---|---|
| エージェントの構成 | 選択したスキーマ バージョンとオーサリング ツールでサポートされているプロパティと機能を使用します。 | 宣言型エージェント マニフェスト参照 |
| 知識の取得 | 関連するソースを選択し、ソース固有のファイル、スコープ、アクセス、インデックス作成の要件に従います。 応答には、ソース内のすべての項目が含まれるとは限りません。 | ナレッジ ソース と コンテンツ取得の最適化 |
| ツール定義とペイロード | ツールに重点を置き、入力と出力を適切な状態に保ちます。 大きなプラグインの入出力は切り捨てられ、有効なコンテキスト制限はモデルとシステムのオーバーヘッドによって変わる可能性があります。 | MCP と API プラグインの制限事項 |
| ドキュメント コンテキスト | すべてのドキュメント コンテンツが同じように表されることを想定するのではなく、ホスト アプリでサポートされているドキュメント操作とコンテンツ形式に従います。 | ドキュメントの操作 |
| サービスの動作と待機時間 | テストの応答時間、認証エラー、サービス エラー、および外部 API または MCP サーバーの制限。 | コンポーネントの統合とテスト |
大規模なデータ セットの場合は、すべてのレコードを会話に送信するのではなく、関連するサブセットをフィルター処理、集計、または返す API を設計します。 シナリオにドキュメント コンテンツが必要な場合は、サポートされているホスト エクスペリエンスをテストします。宣言型エージェントは、 ドキュメント形式の考慮事項に従って、Word および PowerPoint で開いているドキュメント全体にアクセスできます。
利点と制限
宣言型エージェントの主な利点と主な制限事項は、このアーキテクチャが特定のユース ケースに適切な場合を判断するのに役立ちます。
主な利点
宣言型エージェントは、既存の Microsoft 365 環境内で AI ソリューションを実装したい組織に大きなメリットをもたらします。
- マネージド会話型ランタイム: Microsoft はオーケストレーターとモデル インフラストラクチャをホストするため、そのランタイムを実装する必要はありません。
- Microsoft 機能へのアクセス: エージェントは、サポートされているナレッジ ソースと組み込みの機能を外部ツールと共に使用できます。
- 構成ベースのカスタマイズ: 指示、機能、およびアクションにより、カスタムの会話エンジンを必要とせずにエクスペリエンスをカスタマイズできます。 外部統合には、コードとホスティングが必要な場合があります。
主な制限事項
宣言型アプローチでは、特定のユースケースを制限する可能性のある制約も導入されます。
- マネージド オーケストレーション: 実行時のすべての決定を制御するのではなく、サポートされている構成を通じて動作に影響を与えます。 命令を確定的なワークフロー エンジンとして扱うのではなく、代表的なタスクを評価します。
- プラットフォームとホストの依存関係: 機能、応答の表示、ライセンス、管理は、選択した Microsoft 365 エクスペリエンスによって異なります。 各ターゲット ホストでサポートを確認します。
- コンテキストと取得の制約: 知識の取得とツールの結果は、使用可能なコンテキストに適合する必要があります。 大規模なソースまたはペイロードでは、応答の完全なカバレッジが保証されるわけではありません。
- 動的 Web コンテンツに関する考慮事項: 範囲指定 Web 検索では、基になるデータ ソースに直接クエリを実行するのではなく、Bing インデックス付きコンテンツを使用します。 動的に生成されたコンテンツは、不完全または古くなってしまいます。 タスクで現在の構造化データに直接アクセスする必要がある場合は、サポートされている API 統合を使用します。 Web 検索のグラウンディングと動的コンテンツを参照してください。
- 継続的な評価: プラットフォームとモデルの更新により、動作が変わる可能性があります。 エージェントとその依存関係が進化するにつれて、命令、取得、およびツールの使用をテストします。
ユース ケースのアラインメント
タスクに複数の手順があるかどうかだけでなく、ソリューションに必要な制御に基づいてアーキテクチャを選択してください。
最適なシナリオ
宣言型エージェントは、次の場合に最適です。
- 情報の取得: 主に Microsoft 365 または外部ソースから情報を検索および要約する必要があるエージェント。
- 支援されたアクション: 知識とサポートされている API または MCP アクションを組み合わせて、ユーザーがタスクを完了するのを支援するエージェント。
- ドキュメント支援と分析: サポートされているドキュメント コンテキストを操作するエージェント、またはコード インタープリターなどの機能を使用するエージェント。
- 生産性の向上: Microsoft 365 内の管理された会話エクスペリエンスの恩恵を受けるタスク。
不適切なシナリオ
要件に次のような場合は、カスタム エンジン エージェントまたは個別に実装されたワークフローを検討してください。
- カスタム ランタイム制御: マネージド Copilot ランタイムを使用するのではなく、独自のオーケストレーション、モデル ホスティング、またはユーザー インターフェイスを実装する必要があります。
- 永続的なビジネスプロセス: システムは、正確な実行順序、トランザクション境界、再試行、またはリカバリを、会話とは無関係に適用する必要があります。
- 大規模なデータ処理: このタスクでは、関連する会話コンテキストの検索や分析ではなく、データ セットの徹底的な処理が必要です。 サービスでその処理を実行し、適切な結果をエージェントに公開します。
- 動的ソースへの直接アクセス: このタスクには、Web 検索で適切に表されていないソースからの現在の順序付けされた結果が必要です。 範囲指定された Web 検索のみに依存するのではなく、サポートされている API または MCP 統合を提供します。
これらの要件によって、会話型インターフェイスとして宣言型エージェントが常に除外されるわけではありません。 エージェントが入力を収集し、サポートされているアクションを呼び出し、結果を提示している間、サービスはビジネス プロセスを所有できます。