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

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

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

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

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

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

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

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

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

   

4. SharePoint の URL を入力します。 複数の URL は手動で改行して区切ります (Shift + Enter を使用)。 静的 URL の代わりに 変数を使用 するには、URL フィールドの横にある変数ピッカー アイコンを選択し、 カスタム、 システム、または 環境変数 を選択します。

5. 名前と説明を追加します。 詳細な説明 (特に、生成型 AI が有効な場合) を入力します。この説明は 生成オーケストレーションに役立ちます。

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

SharePoint サイトまたはフォルダーの名前が変更された場合は、ソース リンクを更新します

ナレッジ ソースが使用するSharePoint サイトまたはフォルダーの名前を変更すると、既存のソース リンクが破損し、アクセス許可のギャップが発生する可能性があります。 このシナリオが発生すると、エージェントがナレッジ ベースへのアクセスに失敗する可能性があります。

アクセスを復元するには:

1. SharePoint 管理者に、名前が変更された場所に対する適切なアクセス許可を付与し、新しいソース リンクを生成するように依頼します。

2. エージェントを開き、SharePointナレッジ ソースを新しく生成されたリンクで更新します。

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

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

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

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

3. [おすすめ] セクションまたは [ファイルのアップロード] セクションで、SharePointを選択します。

   

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

   

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

   

   一度に最大 10 個のリストを選択できます。 最適な結果を得るには、エージェントごとに最大 10 個のリストのみを使用します。 35,000 行を超える行を含むリストは、品質と待機時間に影響します。

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

   Note

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

6. 目的のリストを選択したら、[選択内容の確認] を選択 します。

7. 名前と説明を追加します。 詳細な説明 (特に、生成型 AI が有効な場合) を入力します。この説明は 生成オーケストレーションに役立ちます。

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

高度な認証シナリオ

既定では、Copilot Studio は、Microsoft Teams、Power Apps、またはMicrosoft 365 Copilotを介してエージェントに接続するときに、Microsoft 認証を使用してユーザーを認証し、SharePoint ソースにアクセスするようにエージェントを事前構成します。 ただし、認証を手動で構成する必要がある場合は、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 バージョン2
  • 証明書を使用した Microsoft Entra ID V2
  • Microsoft Entra ID V2のクライアント シークレットを使用する

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

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

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

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

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

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

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

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

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

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

   • タイトル
   • Author
   • 変更者
   • 変更日

5. 条件の値を次のいずれかの値に設定します。

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

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

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

SharePointソースをフィルター処理するには、次の設定をオフにします。

• Web 検索
• エージェントレベルでは、Generative AI設定の一般知識の使用オプションを設定します。
• トピック レベルでは、生成応答ノードで AI が独自の一般的な知識 (プレビュー) 設定を使用できるようにする

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

変数を URL として使用する

パブリック Web サイトまたはナレッジ ソース URL SharePoint変数を使用して、エージェントが使用するコンテンツの範囲を動的に制御します。

さまざまなシナリオで複数のナレッジ ソースを作成する代わりに、1 つのナレッジ ソースを定義し、URL に変数を挿入します。 実行時に、Copilot Studioは変数を処理し、結果の URL を基礎として使用します。

変数のサポート

パブリック Web サイトまたはナレッジ ソース URL SharePoint追加または編集するときに、URL フィールドに変数を挿入できます。

次の場合に変数を使用します。

• ベース URL へのパスの追加

  https://www.contoso.com/{variable}

• URL 全体を置き換える

  {variable}

実行時に、変数は文字列値に解決されます。 ナレッジ ソースのスコープは、解決された URL に限定されています。

変数を作成して設定する

パブリック Web サイトまたは SharePoint ナレッジ ソースで変数を使用するには:

1. グローバル スコープを持つ文字列変数を作成します。

2. 次のいずれかのオプションを使用して変数の値を設定します。

   • トピックの入力
   • ユーザー プロファイルのプロパティ (言語など)
   • 環境変数
   • エージェントフローまたはコネクター

3. {x} (変数の挿入) を選択して、URL フィールドに変数を挿入します。

4. エージェントをテストして、変数が予想される URL に解決されたことを確認します。

例: 製品別のスコープ

ユーザーのクエリに基づいて、さまざまな製品領域にナレッジの範囲を指定できます。

1. トピック入力を使用して、製品名を Product という名前の変数としてキャプチャします。

2. [トリガー] ノードの後に [変数値の設定] ノードを追加し、ProductTableという名前の新しい変数を作成します。

3. Power Fx 数式を使用して、製品名を定義し、URL パスにマップします。

    Table(
        { Product: "Copilot", Path: "microsoft-365-copilot" },
        { Product: "Teams", Path: "microsoft-teams" },
        { Product: "Surface", Path: "surface" }
    )
   

4. 別の 変数値の設定 ノードを追加し、それを使用して、 GlobalProductURLという名前の新しい文字列型グローバル変数を作成します。

5. To value 設定で 数式 を選択し、Power Fx 関数を使用して、Product 入力変数 Topic.Product の値に基づいてテーブルを参照します。

   LookUp(Topic.ProductTable, Product = Topic.Product, Path)

6. ナレッジ ソース URL で変数を使用します。

   https://www.microsoft.com/en-us/{GlobalProductURL}

エージェントは、実行時に Web サイトのスコープ付きセクションのみを照会します。

一般的なシナリオ

パブリック Web サイトのナレッジ ソースで次の変数を使用します。

• 製品ベースのルーティング: クエリを特定の製品ドキュメントにスコープ指定します。

• 地域または言語のフィルター処理: User.Language をローカライズされた URL ( en-us、 it-it など) にマップします。

• 環境固有の URL: 開発サイト、テスト サイト、運用サイトを切り替えます。

Considerations

• パブリック Web サイトのナレッジ ソースは、Bing検索を使用し、インデックス付きコンテンツに依存します。
• 変数を使用する場合でも、URL 深度の制限が適用されます。
• 変数は、ターゲット URL のみを変更します。 コンテンツのインデックス作成または取得方法には影響しません。