ナレッジ ソースとしてSharePointを追加する

ナレッジ ソースとしてのSharePointは、エージェントとSharePoint URL またはSharePoint リストをペアリングすることによって機能します。 この記事では、ナレッジの追加 ダイアログで SharePoint オプションを選択することによって提供される完全なSharePoint統合機能について説明します。

注意

• ナレッジの追加 ダイアログには、2 つのSharePointオプションがあります。 ファイルのアップロード セクションの SharePoint オプション は、個々のSharePointファイルまたはフォルダーをアップロードするために使用され、ファイル同期機能を有効にします。 この記事では、Copilot Studio でのSharePointの完全なサポートを提供するSharePoint オプションについて説明します。

• 制限とサポートされているSharePoint機能の一覧については、Copilot Studio Web アプリのSharePoint制限を参照してください。

• 個々のSharePointファイルまたはフォルダーを追加するには、「ファイルとフォルダー SharePoint追加するを参照してください。

• SharePointをナレッジ ソースとして使用するエージェントの応答は、conversation トランスクリプトには含まれません。

• SharePointナレッジ ソースに基づくエージェントの場合、セマンティック検索を使用したテナント グラフ グラウンディングの有効化により、知識の取得と応答の品質が向上します。 この機能は最先端の内部検索ツールを用いており、エージェントはより大量のコンテキストをより正確に取得できます。 しかし、システムの複雑さが増すため、特定のユーザーやクエリではわずかな遅延増加が起こる可能性があります。

エージェントを公開すると、エージェントで構成された認証設定を使用して、エージェントとチャットしているユーザーに代わって、生成型回答を使用した通話が行われます。 既定では、Copilot Studio と Microsoft Teams で作成されたエージェントは、Microsoft Teams、Power Apps、Microsoft 365 Copilotなどの環境で機能する Authenticate と Microsoft 認証オプションを使用して構成されます。

注意

Microsoft Teamsチャット内のSharePointデータと共に生成的な回答を使用することができ、手動認証は必要ありません。 以前に発行されたエージェントにこのメソッドを使用するには、エージェントを再構成してMicrosoftで認証を利用してから、もう一度Microsoft Teamsに発行します。 この変更が有効になるまでに数時間かかる場合があります。 ユーザーが会話の途中で変更が有効になっていないように見える場合は、チャットで「最初からやり直す」と入力すると、最新バージョンの エージェント で会話を強制的に再開できます。 これらの変更は、ユーザーと エージェント 間の Teams の 1 対 1 のチャットで利用できるようになりました。 グループ チャットやチャネル メッセージではまだ利用できません。

エージェントに手動認証を使用する場合は、 高度な認証シナリオを参照してください。

SharePointサイトをナレッジソースとして追加する

ユーザーが質問をしたときに、エージェント に回答に使用するトピックがない場合、エージェント は URL とすべてのサブパスを検索します。 たとえば、contoso.sharepoint.com/sites などの URL には、contoso.sharepoint.com/sites/policies などのサブパスも含まれます。 生成的な回答は、このコンテンツをターゲットを絞った回答に要約します。

ナレッジ ソースとして SharePoint サイトを追加するには、次の手順に従います。

1. エージェント アプリを開きます。

2. 概要 ページ、ナレッジ ページ、または 生成型回答ノード の プロパティ ページから、ナレッジの追加 を選択します。

3. Featured セクションで、SharePoint を選択します。

   [ナレッジの追加] ダイアログのスクリーンショットで、SharePoint オプションが強調表示されています。

4. SharePoint URL を指定します。 複数の URL は手動で改行して区切ります (ShiftEnter を使用)。

5. 名前と説明を追加します。 説明が生成オーケストレーションを支援するので、特に生成 AI が有効になっている場合は、説明をできるだけ詳細にする必要があります。

6. [ エージェントに追加] を 選択して、ナレッジ ソースの追加を完了します。

ナレッジ ソースとしてSharePointリストを追加する

SharePoint リストは、表形式のデータを格納し、情報にすばやく簡単にアクセスできる一般的な方法です。 エージェントは、これらのリストをナレッジ ソースとして使用できます。 SharePoint リストをナレッジ ソースとして追加すると、ソースへのリアルタイム接続が作成されるため、最新のデータがクエリと推論に使用されます。 ユーザーは、SharePoint資格情報を使用して認証されます。これにより、エージェントが応答を提供する前に、データにアクセスするアクセス許可が付与されます。

1. エージェント アプリを開きます。

2. 概要 ページ、ナレッジ ページ、または 生成型回答ノード の プロパティ ページから、ナレッジの追加 を選択します。

3. Featured セクションで、SharePoint を選択します。

4. Browse items を選択して目的のリストを検索するか、特定のSharePointリストの URL を入力します。

   

5. 項目の参照を選択すると、ダイアログには自動的にマイリストと最近のリストが表示されます。 My Lists には、SharePoint Lists アプリで作成されたリストのみが表示されます。 その他のリストは最近のリストに表示されます。 必要なリストが表示されない場合は、SharePoint開いてリストにアクセスすると、リストが Recent Lists に表示されます。

   

   一度に最大 15 のリストを選択できます。 各リストは、個々の項目としてエージェントのナレッジ ソースに追加されます。 エージェントにリストを追加するには、次の手順をもう一度使用し、他のリストを選択します。

   注意

   共有アクセスでSharePointリストを使用するが、Recent Listsに表示されない場合は、リストの URL を URL 選択に貼り付けます。

6. 目的のリストを選択したら、選択の確定を選択します。

7. 名前と説明を追加します。 説明が生成オーケストレーションを支援するので、特に生成 AI が有効になっている場合は、説明をできるだけ詳細にする必要があります。

8. [ エージェントに追加] を 選択して、ナレッジ ソースの追加を完了します。

高度な認証シナリオ

既定では、Copilot Studio は、Microsoft Teams、Power Apps、またはMicrosoft 365 Copilotを介してエージェントに接続するときに、Microsoft 認証を使用してユーザーを認証し、SharePoint ソースにアクセスするようにエージェントを事前構成します。 ただし、認証を手動で構成する必要がある場合は、SharePointデータ ソースを操作するための生成応答に次の手順が必要です。

重要

Restricted SharePoint Search が有効になっている場合、SharePointの使用はブロックされます。

• SHAREPOINT ソースから生成された回答は、SSO 対応アプリの guest ユーザーには利用できません。

• エージェント を認証するには、認証 を参照してください。

• 必要なMicrosoft Entra IDアプリケーションの登録を作成する方法については、「 Microsoft Entra ID。 この登録を作成するときは、Microsoft Entra ID アプリの登録プロセスで Sites.Read.All スコープと Files.Read.All スコープを指定する必要があります。

• 認証なしを選択すると、エージェントがSharePointから情報を取得しないことを指定します。

• 認証を構成する際には、スコープによってユーザーのアクセスが制御されます。 Copilot Studio の既存の Sites.Read.All と Files.Read.All の値の近くにあるスコープ フィールドに、profile と openid を指定します。 これらのスコープでは、エージェントを使用する際にユーザーにアクセス許可が増えるわけではありませんが、生成応答用に構成されたSharePoint サイトからの許容されるコンテンツは許可されます。

• SharePointでは、次の認証サービス プロバイダーで Authenticate の手動設定がサポートされます。

  • Microsoft Entra ID
  • Microsoft Entra ID V2 をフェデレーション資格情報で使用する
  • 証明書を使用した Microsoft Entra ID V2
  • Microsoft Entra ID V2のクライアント シークレットを使用する

• SharePointでは、Generic OAuth を使用した手動認証はサポートされていません。

• この構成は生成型の回答にのみ適用され、Power Platform コネクタには適用されません。

SharePoint ソースをフィルター処理する

作成者は、検索クエリ パラメーターを指定することで、エージェントのSharePointナレッジ ソースのパフォーマンスを向上させることができます。 これらのクエリパラメータは、知識ソース内で何を検索するかを定義します。 例えば、過去6ヶ月以内に修正された項目のみを検索したいと指定できます。 この種類のフィルターは、次のように構成されます。

属性	オペレーター	値
Modified on	on or after	X date

フィルター条件を作成する

SharePointナレッジ ソースを追加したら、検索条件を設定できます。

1. Knowledge ページで、SharePoint ソースを選択します。

2. 「…」（3 つのドット）のSharePointソースを選択し、「編集」を選択します。

3. 詳細設定を選択します。

4. SharePointナレッジ ソースの情報を含めたり除外したりするためのフィルターを作成します。 フィルターは、次のいずれかの選択項目に基づいて行うことができます。

   • タイトル
   • 著者
   • よって修正された
   • 変更された日

5. 条件の値は、次のいずれかの値に設定できます:

   • 静的な値
   • エージェントとの会話中にユーザーが提供する可変入力で、カスタム グローバル変数として保存されます
   • システム変数

6. フィルターの構成が完了したら、保存を選択します。

検索を改善するその他の設定

SharePoint ソースをフィルター処理する場合は、次の設定をオフにする必要があります。

• Web 検索
• エージェント レベルでは、エージェントの生成 AI 設定内の汎用ナレッジを使用する設定
• トピックレベルでは、生成回答ノード内の AI が自身の汎用ナレッジ (プレビュー) の使用を許可する

これらの設定をオフにすると、フィルター処理されたSharePointナレッジ ソースで結果が見つからない場合、エージェントは "応答なし" で応答します。