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

エージェント レベルでナレッジ ソースとしてパブリック Web サイトを追加する場合は、公開されている情報を使用してエージェントのリーチを向上させます。

パブリック Web サイトを追加する

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

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

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

3. 公開 web サイト を選択します。

4. パブリック Web サイトの URL を 入力します。 静的 URL の代わりに 変数を使用 するには、URL フィールドの横にある変数ピッカー アイコンを選択し、 カスタム、 システム、または 環境変数 を選択します。

5. 名前を追加します (デフォルトでは、Web サイトの URL が使用されます)。

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

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

8. エージェントをテストして Web サイトのコンテンツに関連する質問にどの程度対応できるかを確認します。 より包括的にするために、モデレーションを下げる必要があるかどうかを判断するために、エッジ ケースの質問をテストすることをお勧めします。

URL の考慮事項

エージェントで使用する URL は、応答を生成するためのコンテンツのスコープを表します。 一部の URL には要件と制限があります。

URL の種類と構造

• URL の深さは最大 2 レベルで、サブパスはスラッシュ /で示されます。 ただし、末尾のスラッシュは許可されています。

  有効	無効
  www.contoso.com www.fabrikam.com/engines/rotary www.fabrikam.com/engines/rotary/	www.fabrikam.com/engines/rotary/dual-shaft

• URL が別のトップレベル サイトにリダイレクトされる場合、コンテンツは結果に含まれません:

  もしwww.fabrikam.comがwww.contoso.fabrikam.comにリダイレクトされる場合、エージェントはこれらの URL のいずれのコンテンツからも応答を生成しません。

• 認証が必要な Web サイト、またはBingによってインデックスが作成されていない Web サイトを指す URL はサポートされていません。

  たとえば、Wiki や SharePoint サイトでは認証が必要であるため、使用できません。

  • fabrikam.visualstudio.com/project/_wiki
  • fabrikam.sharepoint.com

URL ドメイン構造

エージェントは、指定した URL 内のパブリックに表示可能なコンテンツ (最上位ドメインのサブドメインを含む) を使用してコンテンツを生成します。

例:

• www.fabrikam.com/engines/rotaryを使用する場合、エージェントはwww.fabrikam.com/engines/rotary/dual-shaftのコンテンツも使用して応答を生成します。

  www.fabrikam.com/toolsはロータリーのサブドメインではないので、エージェントはのコンテンツを使用しません。

• www.fabrikam.com (www が存在する) を使用する場合、エージェントは news.fabrikam.com のコンテンツを使用しません (www は存在しません)。ニュースは最上位ドメイン fabrikam.com のサブドメインであるためです。

• fabrikam.com を使用する場合、エージェントは最上位ドメイン fabrikam.com の下に配置されるため、www.fabrikam.comと news.fabrikam.com のコンテンツを使用します。

ソーシャル ネットワークとフォーラムの URL

フォーラムやソーシャル ネットワーク サイトを URL として使用すると、エージェントが無意味な回答や関連のない回答、または不適切な回答を生成する可能性があります。 したがって、ソーシャル ネットワーク上のコミュニティ コンテンツにより、多くの場合、却下される回答が増加するリスクが高まります。

詳細については、生成型の回答に関するよくあるご質問を参照してください。 AI は、悪意のある攻撃的な応答を生成しないように訓練されています。

検索エンジン URL

bing.com などの検索エンジンの URL は、有用な応答が得られないため含めないでください。

変数を 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. [変換先] 設定で、[数式]を選び、Power Fx 関数を使用して、ProductTopic.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 のみを変更します。 コンテンツのインデックス作成または取得方法には影響しません。