Microsoft SharePoint ツールを使用する (プレビュー)

注

この記事では、Azure AI Foundry Agent Service 用の Microsoft SharePoint ツールについて説明します。 SharePoint サイトの使用と展開の詳細については、 SharePoint のドキュメントを参照してください。

エージェントを Microsoft SharePoint と統合して、プライベート ドキュメントと安全にチャットします。 contoso.sharepoint.com/sites/policies などの SharePoint サイトに接続して、そのデータを使用してエージェントをグラウンディングすることができます。 ユーザーがクエリを送信すると、エージェントは SharePoint を活用する必要があるかどうかを判断します。 その場合は、SharePoint ツールを使用してクエリが送信されます。このツールは、ユーザーが Microsoft 365 Copilot ライセンスを持っているかどうかを確認し、マネージド ID を使用してアクセス権を持つ関連ドキュメントを取得します。 取得の範囲には、この SharePoint サイトでサポートされているすべてのドキュメントが含まれます。 最後に、エージェントは取得した情報に基づいて応答を生成します。 ID パススルー (オンBehalf-Of) 承認により、この統合により、堅牢なセキュリティを維持しながら SharePoint のエンタープライズ データへのアクセスが簡素化され、適切なアクセス制御とエンタープライズ レベルの保護が保証されます。

動作方法

SharePoint ツールを使用すると、 Microsoft 365 Copilot API によって強化された SharePoint に格納されている AI エージェントとビジネス ドキュメント間のシームレスな統合が可能になります。 SharePoint ドキュメントを作成するには、接続するサイトまたはフォルダーを入力できます。SharePoint ツールでは 、組み込みのインデックス作成機能を 利用して、インテリジェントなインデックス作成、クエリ処理、コンテンツ チャンクなどの検索と取得のエクスペリエンスを強化します。

この機能は、開発者に SharePoint コンテンツのエクスポート、カスタム セマンティック インデックスの作成、ガバナンス コントロールの管理、更新ロジックの構成を要求する代わりに、取得パイプライン全体を自動化します。 ドキュメントのインデックスを動的に作成し、コンテンツを意味のあるチャンクに分割し、高度なクエリ処理を適用して最も関連性の高い情報を表示します。 Microsoft 365 Copilot を利用するのと同じエンタープライズ レベルの取得スタックを活用することで、AI エージェントの応答が最も up-to-date およびコンテキストに関連するコンテンツに基づくようにします。

お客様は、柔軟なドキュメント レベルのアクセス制御を使用してドキュメントにアクセス、作成、共有するために、SharePoint のデータ セキュリティに依存しています。 ID パススルー/オンBehalf-Of (OBO) 認証などのエンタープライズ機能により、適切なアクセス制御が保証され、エンド ユーザーはアクセス許可を持つ SharePoint ドキュメントから生成された応答を受信できます。 OBO 認証では、Foundry Agent サービスはエンド ユーザーの ID を使用して関連する SharePoint ドキュメントを承認および取得し、特定のエンド ユーザー向けに調整された応答を生成します。

利用サポート

Azure AI Foundry のサポート	Python SDK	C# SDK	JavaScript SDK	REST API	基本エージェントのセットアップ	標準エージェントのセットアップ
✔️	-	-	-	✔️	✔️	✔️

[前提条件]

• 開発者とエンド ユーザーは、Microsoft 365 Copilot API で必要とされる Microsoft 365 Copilot ライセンスを持っています。
• 開発者とエンド ユーザーには、少なくとも Azure AI User RBAC ロールがあります。
• 開発者とエンド ユーザーは、SharePoint サイトに少なくとも READ アクセスできます。

設定

注

• サポートされているドキュメントの種類: テキストデータとして次の形式: .pdf、.docx、.ppt、.txt、.aspx
• 最初に、単純なフォルダー構造と少数の短いドキュメントを含む SharePoint サイトを使用することをお勧めします。

1. クイック スタートの手順に従ってエージェントを作成します。

2. この記事の上部にあるコード例または Azure AI Foundry ポータルを使用して、SharePoint ツールをプログラムでエージェントに追加できます。 ポータルを使用する場合、エージェントの [作成とデバッグ] または [エージェント プレイグラウンド] 画面で、右側にある [設定] ペインを[ナレッジ] まで下にスクロールします。 その後、追加を選択します。

   

3. SharePoint を選択し、指示に従ってツールを追加します。 エージェントごとに追加できるのは 1 つだけです。

4. クリックして新しい接続を追加します。 接続を追加したら、既存の一覧から直接選択できます。

   1. 新しい接続を作成するには、SharePoint サイトで site_url を見つける必要があります。 SharePoint サイトまたは SharePoint フォルダーを追加できます。 SharePoint サイトの場合、 https://microsoft.sharepoint.com/teams/<site_name>のようになります。 SharePoint フォルダーの場合、次のようになります。 https://microsoft.sharepoint.com/teams/<site_name>/Shared%20documents/<folder_name>

      注

      • site_urlは上記の形式に従う必要があります。 SharePoint のアドレス バーから値全体をコピーすると、機能しません。

   2. その後、接続に追加できます。 [ シークレット ] オプションが選択されていることを確認します。

次のステップ

• SharePoint ツールの使用方法
• ツールで使用されるコンテンツの取得に関するリファレンス記事:
  • Microsoft 365 Copilot Retrieval API の概要。
  • Microsoft 365 Copilot のセマンティック インデックス作成