生成的な回答にSharePointコンテンツを使用する

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

Important

生成型回答ノードで定義されたナレッジソースは、エージェントレベルでナレッジソースよりも優先されます。 エージェントレベルのソースはフォールバックとして機能します。 エージェント レベルでナレッジ ソースとしてSharePointを追加する方法については、「ナレッジ ソースとしてSharePointを追加するを参照してください。 トピックレベルまたはエージェント レベルでナレッジ ソースとしてSharePointを使用するエージェント応答は、conversation トランスクリプトには含まれません。

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

Note

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

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

Note

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

  • Copilot Studio のエージェントは、このナレッジ ソースを使用するために Dataverse 検索が必要です。 Dataverse 対応ファイルをエージェントに追加できない場合は、環境内で Dataverse 検索を有効にするように管理者に依頼してください。 Dataverse 検索とその管理方法の詳細については、「 Dataverse 検索とは」 および「環境 に対する Dataverse 検索の構成」を参照してください。

生成応答ノードでSharePointを使用する

Important

トピックで 生成型の回答ノード を使用する場合、統合セキュリティが選択されていると、作成キャンバスおよびトピック チェッカーでエラーが発生することがあります。 このエラーは無害なものであり、機能の動作を妨げるものではありません。

  1. トピック内で生成回答ノードを追加します。

  2. 該当トピックの生成回答ノードで、2つの場所のいずれかから データソース 設定パネルを開きます。

    1. 生成型回答の作成 ノードで、データ ソース の下にある 編集 を選択します。

      プロパティ ペインを選択する場所を示すスクリーンショット。

    2. あるいは、「生成回答を作成」ノードで3つの点を選択し、プロパティを選択してデータソースを選択します。

  3. [ ナレッジ ソース] で、[ ナレッジの追加] を選択します。 [ 選択したソースのみを検索 ] がオンになっていることを確認します。

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

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

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

    Note

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

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

  7. 上部の 保存 を選択して、トピックの変更を保存します。

  8. コンテンツが返されると予想されるフレーズでエージェントをテストします。

    Note

    copilotstudio.microsoft.com へのサインインに使用したユーザー アカウントがSharePoint サイトにアクセスできない場合は、コンテンツが表示されないか、システム エラーが表示されることがあります。

変数を URL として使用する

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

さまざまなシナリオで複数のナレッジ ソースを作成する代わりに、1 つのナレッジ ソースを定義し、URL に変数を挿入します。 実行時に、Copilot Studioは変数を解決し、得られた URL を基準を定めるために手段とします。

変数のサポート

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

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

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

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

  • URL 全体を置き換える

    {variable}

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

Note

変数を使用すると、接地に使用する URL が変更されます。 パブリック Web サイトの 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: 開発サイト、テスト サイト、運用サイトを切り替えます。

考慮事項

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

Important

変数は、パブリック Web サイトのナレッジ ソースの要件を満たす有効なパブリック URL に解決する必要があります。 無効な URL またはサポートされていない URL は、結果を返さない可能性があります。

高度な認証シナリオ

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

Important

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 バージョン2
    • 証明書を使用した Microsoft Entra ID V2
    • Microsoft Entra ID V2のクライアント シークレットを使用する

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

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

  • Last updated on