注:
SharePoint Embedded エージェントは現在プライベート プレビュー段階です。 このページでは、最新の API と SDK の変更にご期待ください。
SPE エージェントの従量課金ベースのモデルは、2025 年 5 月に利用可能になります。 5 月 1 日以降、すべてのプライベート プレビューのお客様が標準課金モデルを利用できるようになり、このロールアウトは 5 月 15 日までに完了する予定です。 つまり、5 月 15 日以降、SPE アプリケーション内で SPE エージェントを使用するには、標準のコンテナーの種類を使用する必要があります。 SPE エージェントの対話 (Microsoft 365 Copilot ライセンス ユーザーからの操作を含む) は、コンテナーの種類に関連付けられている Azure サブスクリプションに課金されます。 SharePoint Embedded 課金管理の詳細については、こちらをご覧ください。
私たちは、SPEエージェントの直接顧客への課金モデルの有効化に積極的に取り組んでいます。 その他のお知らせをお待ちください。
SharePoint Embedded エージェントを使用すると、単純な SDK を使用して AI 機能をアプリケーションに追加できます。 このチャット コントロールには、次の機能があります。
- RAG を使用した SharePoint 埋め込みコンテナー内のドキュメントに対する理由。
- 開発者は、検索スコープをファイル、フォルダー、コンテナーに制限するようにアプリケーション コードを構成できます。
- 開発者は、スタート プロンプト、推奨されるプロンプト、色など、チャット コントロールをカスタマイズして構成できます。
この機能を構成する方法の詳細については、このデモをご覧ください。
SharePoint Embedded エージェントを使用する理由
SharePoint Embedded エージェントはセマンティック インデックスを活用して Retrieval-Augmented 生成 (RAG) を強化し、クエリ時に Microsoft 365 境界内のデータを安全に参照します。 これにより、広範な知識モデルへの依存を減らしながら、正確で根拠のある AI 応答が保証されます。 従量課金制の課金モデルは、コストを実際の使用量に合わせて調整します。
SharePoint Embedded エージェントを使用する方法
エージェントをビルドする方法
現在、TypeScript で記述された React SDK ライブラリを使用して、アプリケーションをビルドできます。 追加のフレームワークと環境をサポートする計画が発表されます。 SDK は、containerType の containerId インスタンスと、コールバックを介して提供する承認トークンと認証トークン ロジックで構成されます。 iFrame としてホスト アプリケーションに埋め込まれます。 既定では、iFrame には frame-ancestors
プロパティが与えられます。これにより、構成されるまで任意のホストによって埋め込まれるのを防ぐことができます。 詳細については、以下を参照してください。
SPE TypeScript React アプリケーション
クイック スタート ガイドに従って、事前構築済みのサンプル アプリケーションの使用を開始します。
API ドキュメント
ここで入手できる SharePoint Embedded React TypeScript NPM パッケージには、SharePoint Embedded エージェントをクライアント アプリケーションに統合するための SDK が用意されています。
よく寄せられる質問
従量課金ベースの課金は SPE エージェントで使用できますか?
はい。5 月 15 日以降、SPE アプリケーション内で SPE エージェントを使用するには、標準のコンテナーの種類を使用する必要があります。 SharePoint Embedded エージェントの相互作用 (Microsoft 365 Copilot ライセンス ユーザーからの操作を含む) は、コンテナーの種類に関連付けられている Azure サブスクリプションに課金されます。 SharePoint Embedded 課金管理の詳細
試用版コンテナーの種類は 30 日後に期限切れになります。このため、Standard コンテナーの種類から開始することをお勧めします。試用版からStandardコンテナーの種類へのアップグレード パスはありません。
標準または試用版のコンテナーの種類を使用する必要がありますか?
従量課金ベースの課金が有効になると、試用版コンテナーの種類でこの機能の使用が無効になり、今後のコンテナーの種類Standardでのみ有効になります。 このガイドに従って、Standard コンテナーの種類の作成を開始してください。
SharePoint Embedded エージェントのサポート
チャット コントロールのフィードバック ダイアログ
チャット コントロールに問題が発生した場合は、サムの上または下のフィードバック ボタンを使用して問題を報告してください。 この方法は、問題をより効果的に診断してトラブルシューティングするのに役立つテレメトリ データを提供するため、フィードバックを送信する場合に適しています。
サムダウンボタンをクリックすると、フィードバックダイアログが表示されます。 このダイアログに関連情報を含めてください。
詳細なTopicsの概要
高度なトピックでは、SharePoint Embedded エージェントがセマンティック インデックスを使用して Retrieval-Augmented 生成 (RAG) を容易にし、保存されたコンテンツで応答を正確に把握する方法について詳しく説明します。 また、エージェントを特定のデータ ソースにスコープを設定し、さまざまなファイル形式を設定し、エージェントエクスペリエンスを調整するようにロケール オプションを構成する方法についても説明します。 基礎作成、セマンティック インデックス作成、RAG ワークフローなどの概念を探索することで、エージェントの有効性を最適化し、Microsoft 365 の境界内でセキュリティを維持できます。