共用方式為

企業網站雲端Microsoft Graph 連接器

  • 發行項

企業網站雲端Microsoft Graph 連接器可讓您的組織 從公司擁有的網站 或因特網上的公用網站為網頁和內容編製索引。 在您從網站設定連接器和索引內容之後，用戶可以在 [搜尋] 和 [Microsoft 365 Copilot] 中搜尋該內容Microsoft。

本文適用於Microsoft 365 個系統管理員或設定、執行及監視企業網站雲端Microsoft Graph 連接器的任何人。

重要事項

您可以利用 企業網站內部部署Microsoft圖形連接器 ，為裝載於內部部署或私人雲端上的網站編製索引。

功能

  • 為來自雲端可存取網站的網頁編製索引。
  • 在單一連線中最多編製 50 個網站的索引。
  • 使用排除規則從編目中排除網頁。
  • 在 Copilot 中使用語意搜尋 ，讓用戶能夠尋找相關內容。

支援的檔案類型

副檔名 檔案類型 描述
.pdf PDF 可攜式檔格式
.odt OpenDocument 文字 OpenDocument 文字檔
.ods OpenDocument 試算表 OpenDocument 試算表
.odp OpenDocument 簡報 OpenDocument 簡報
.odg OpenDocument 圖形 OpenDocument 圖形
.xls Excel (Old) 舊格式 (Excel 電子表格)
.xlsx Excel (新) Excel 電子表格 (新格式)
.ppt PowerPoint (舊) PowerPoint 簡報 (舊格式)
.pptx PowerPoint (新) PowerPoint 簡報 (新格式)
.doc Word (舊) Word 舊格式 (檔)
.docx Word (新) Word 檔 (新格式)
.csv CSV Comma-Separated 值
.txt 純文字 純文本檔案
.xml XML 可延伸標記語言
.md Markdown Markdown 檔案
.rtf RTF 格式 RTF 格式
.tsv 索引標籤分隔值 Tab-Separated 值

支援的MIME類型

MIME 類型 描述
text/html 用來格式化網頁結構的超文本標記語言 (HTML) 。
text/webviewhtml 用於 WebView 控件中呈現之 Web 內容的 MIME 類型。
text/x-server-parsed-html 伺服器剖析的 HTML 檔，通常用於伺服器端包含 (SSI) 。

限制

  • 連接器不支援SAML、JWT令牌、Forms型驗證等驗證機制。
  • 連接器不支援在網頁中編目動態內容。

必要條件

  • 您必須是組織Microsoft 365 租使用者的 搜尋管理員 。
  • 網站 URL：若要連線到您的網站內容，您需要網站的 URL。 您可以在單一連線 (最多 50 個) 來為多個網站編製索引。
  • 服務帳戶 (選擇性) ：只有當您的網站需要驗證時，才需要服務帳戶。 公用網站不需要驗證，而且可以直接進行編目。 對於需要驗證的網站，建議您使用專用帳戶來驗證和編目內容。

開始使用

此螢幕快照顯示 Microsoft Graph Connector for Enterprise Websites 雲端的連線建立畫面。

1.顯示名稱

顯示名稱可用來識別 Copilot 中的每個引文，協助使用者輕鬆辨識相關聯的檔案或專案。 顯示名稱也代表受信任的內容。 顯示名稱也會當做 內容來源篩選條件使用。 此欄位有預設值，但您可以將它自定義為組織中用戶可辨識的名稱。

2.要編制索引的網站 URL

指定您想要編目之網站的根目錄。 企業網站雲端Microsoft圖形連接器會使用此 URL 作為起點，並遵循此 URL 中的所有鏈接進行編目。 您可以在單一連線中編製最多 50 個不同網站 URL 的索引。 在 [URL] 欄位中，輸入以逗號分隔的網站 URL (，) 。 例如，https://www.contoso.com,https://www.contosoelectronics.com。

注意事項

連接器一律會從 URL 的根目錄開始編目。 例如 - 如果您提供的 URL 是 https://www.contoso.com/electronics，則連接器會從 開始編 https://www.contoso.com目。

連接器只會編目根 URL 網域中的網頁，不支援編目網域外 URL。 只有相同網域內才支援重新導向。 如果網頁中有要編目的重新導向，您可以直接在要編目的 URL 清單中新增重新導向的 URL。

使用網站圖進行編目

選取時，連接器只會編目網站映射中列出的 URL。 此選項也可讓您在稍後的步驟中設定累加編目。 如果未選取或找不到網站圖，連接器會對網站根 URL 上找到的所有鏈接進行深層編目。

選取此選項時，編目程式會執行下列步驟：

a. 編目程式會在根位置尋找 robots.txt 檔案。 例如 - 如果您提供的 URL 是 https://www.contoso.com，則編目程式會在 尋找 robots.txt 檔案 https://www.contoso.com/robots.txt。

b. 尋找 robots.txt 檔案時，編目程式會在 robots.txt 檔中尋找網站圖連結。

c. 編目程式接著會編目網站對應檔中所列的所有網頁。

d. 如果上述任何步驟發生失敗，編目程式會執行網站的深層編目，而不會擲回任何錯誤。

3.驗證類型

您選擇的驗證方法適用於您提供給連線索引的所有網站。 若要從網站驗證和同步處理內容，請選擇 四個支援的方法之一 ：

a. 無
如果您的網站可在沒有任何驗證需求的情況下公開存取，請選取此選項。

b. 基本驗證
輸入您帳戶的使用者名稱和密碼，以使用基本身份驗證進行驗證。

c. SiteMinder
月臺管理員驗證需要格式正確的 URL、 https://custom_siteminder_hostname/smapi/rest/createsmsession使用者名稱和密碼。

d. Microsoft Entra OAuth 2.0 客戶端認證
具有 Microsoft Entra ID 的 OAuth 2.0 需要資源識別碼、用戶端識別碼和客戶端密碼。

資源標識碼、用戶端標識碼和客戶端密碼值取決於您如何為網站設定 Microsoft Entra ID 型驗證。 這兩個指定選項的其中一個可能適用於您的網站：

  1. 如果您使用 Microsoft Entra 應用程式作為識別提供者和用戶端應用程式來存取網站，則用戶端識別碼和資源識別碼是此單一應用程式的應用程式識別碼，而用戶端密碼是您在此應用程式中產生的秘密。

    注意事項

    如需將用戶端應用程式設定為身分識別提供者的詳細步驟，請參閱快速入門：向 Microsoft 身分識別平台 註冊應用程式和設定您的 App Service 或 Azure Functions 應用程式以使用 Microsoft Entra 登入。

    設定用戶端應用程式之後，請務必前往應用程式的 [ 憑證 & 秘密 ] 區段來建立新的客戶端密碼。 複製頁面中顯示的客戶端密碼值，因為它不會再次顯示。

    在下列螢幕快照中，您可以看到取得用戶端標識碼和客戶端密碼的步驟，如果您要自行建立應用程式，請設定應用程式。

    • 品牌區段中的設定檢視：

      顯示品牌頁面上 [設定] 區段的影像。

    • 驗證區段中的設定檢視：

      顯示驗證頁面上設定區段的影像。

      注意事項

      您的網站上不需要有上述指定的重新導向 URI 路由。 只有當您在網站中使用 Azure 所傳送的使用者令牌進行驗證時，您才需要有路由。

    • Essentials 區段上的用戶端識別碼檢視：

      顯示 [基本資訊] 區段上用戶端標識符的影像。

    • 在 [ 憑證 & 秘密 ] 區段上檢視客戶端密碼：

      顯示客戶端密碼的影像。

  2. 如果您使用應用程式 (第一個應用程式) 作為網站的身分識別提供者作為資源，而另一個應用程式 (第二個應用程式) 存取網站，則用戶端標識符是第二個應用程式的應用程式標識符，而用戶端密碼是第二個應用程式中設定的秘密。 不過，資源標識碼是您第一個應用程式的標識碼。

    注意事項

    如需將用戶端應用程式設定為識別提供者的步驟，請參閱快速入門：向 Microsoft 身分識別平台 註冊應用程式和設定您的 App Service 或 Azure Functions 應用程式以使用 Microsoft Entra 登入。

    您不需要在此應用程式中設定客戶端密碼，但您需要在 [ 應用程式 角色] 區段中新增應用程式角色，稍後會指派給用戶端應用程式。 請參閱影像以瞭解如何新增應用程式角色。

    • 建立新的應用程式角色：

      顯示建立應用程式角色選項的影像。

    • 編輯新的應用程式角色：

      顯示編輯應用程式角色區段的影像。

      設定資源應用程式之後，請在用戶端應用程式的 API 許可權中新增上述設定的應用程式角色，以建立用戶端應用程式，並授與其存取資源應用程式的許可權。

      注意事項

      若要瞭解如何將許可權授與用戶端應用程式，請 參閱快速入門：設定用戶端應用程式以存取 Web API。

    下列螢幕快照顯示將許可權授與用戶端應用程式的區段。

    • 新增權限：

      顯示新增許可權選項的影像。

    • 選取權限：

      顯示區段以選取 API 的影像。

    • 新增權限：

      顯示所選取權限的影像。

    指派許可權之後，您必須前往 [憑證 & 秘密] 區段，為此應用程式建立新的客戶端密碼。 複製頁面上顯示的客戶端密碼值，因為它不會再次顯示。 使用此應用程式的應用程式識別碼作為用戶端標識碼、使用此應用程式的秘密作為客戶端密碼，並使用第一個應用程式的應用程式識別碼作為資源識別符。

4.向有限的物件推出

如果您想要先在 Copilot 和其他搜尋介面中驗證此連線，再將推出擴充至更廣泛的物件，請將此連線部署至有限的使用者基底。 若要深入瞭解有限的推出，請參閱 分段推出。

此時，您已準備好建立雲端網站的連線。 您可以按下 [建立] ，從您的網站發佈連線和索引網頁。

對於其他設定，例如 訪問許可權、 數據包含規則、 架構、 編目頻率等，我們會根據最適合網站的內容來設定預設值。 您可以在下方看到預設值：

使用者 描述
訪問許可權 組織中的每個人都會看到此內容
內容 描述
要排除的URL 無
管理屬性 若要檢查預設屬性及其架構，請參閱 內容
同步處理 描述
累加編目 頻率：網站圖編目 (僅支援每隔 15 分鐘)
完整編目 頻率：每天

如果您想要編輯其中任何一個值，您必須選擇 [自訂安裝] 選項。

自訂安裝程式

自訂設定適用於想要編輯上表所列設定之預設值的系統管理員。 按兩下 [自定義安裝] 選項之後，您會看到另外三個索引標籤 - [使用者]、[內容] 和 [同步]。

使用者

顯示 [使用者] 索引標籤的螢幕快照

訪問許可權

企業網站雲端連接器僅支援 每個人都 能看見的搜尋許可權。 索引數據會出現在組織中所有使用者的搜尋結果中。

內容

顯示 [內容] 索引標籤的螢幕快照，您可以在其中設定排除規則和屬性

新增 URL 以排除選用編目限制 ()

有兩種方式可防止頁面編目：不允許在您的 robots.txt 檔案中編目頁面，或將它們新增至排除清單。

  1. 支援 robots.txt

    連接器會檢查根網站是否有 robots.txt 檔案。 如果有的話，它會遵循並遵循該檔案中找到的指示。 如果您不想讓連接器編目網站上的特定頁面或目錄，請在 robots.txt 檔案的 「不允許」宣告中包含頁面或目錄。

  2. 新增要排除的 URL

    如果內容敏感或不值得編目，您可以選擇性地建立 排除清單 ，以排除某些 URL 不進行編目。 若要建立排除清單，請流覽根URL。 您可以在設定程式期間，將排除的URL新增至清單。

管理屬性

在這裡，您可以從網站新增或移除可用的屬性、將架構指派給屬性 (定義屬性是否可搜尋、可查詢、可擷取或可精簡) 、變更語意標籤，以及將別名新增至 屬性。 以下列出預設選取的屬性。

Source 屬性 標籤 描述 Schema
Authors Authors 人員 參與數據源中項目的人員 查詢、擷取
內容 內容 網頁中的所有文字內容 搜尋
CreatedDateTime 建立日期時間 在數據源中建立項目的數據和時間 查詢、擷取
描述 擷取、搜尋
FileType 副檔名 編目內容的擴展名 查詢、精簡、擷取
IconURL IconUrl 網頁的圖示 URL 取回
LastModifiedBy 上次修改者 上次修改數據源中項目的人員 查詢、擷取
LastModifiedDateTime 上次修改日期時間 上次在數據源中修改專案的日期和時間。 查詢、擷取
標題 標題 您想要在 Copilot 和其他搜尋體驗中顯示的項目標題 擷取、搜尋
URL URL 數據源中項目的目標 URL 取回

企業網站雲端連接器支援兩種類型的來源屬性：

  1. Meta 標籤

    連接器會擷取根 URL 可能擁有的任何中繼標籤，並顯示它們。 您可以選取要包含哪些標籤以進行編目。 如果可以的話，選取的標籤會針對所有提供的網址編制索引。

    顯示具有中繼標籤面板之 [內容] 索引標籤的螢幕快照

    選取的中繼標記可用來建立自定義屬性。 此外，在架構頁面上，您可以進一步管理它們 (可查詢、可搜尋、可擷取、可精簡的) 。

  2. 自訂屬性設定

    您可以為選取的中繼標記或連接器的預設屬性建立自定義屬性，藉此擴充索引數據。

    顯示具有自定義屬性面板之 [內容] 索引標籤的螢幕快照

    若要新增自訂屬性：

    1. 輸入屬性名稱。 此名稱會出現在此連接器的搜尋結果中。
    2. 針對值，選取 [靜態] 或 [字串/Regex 對應]。 靜態值會包含在此連接器的所有搜尋結果中。 字串/regex 值會根據您新增的規則而有所不同。
    3. 如果您選取靜態值，請輸入您想要顯示的值。
    4. 如果您選取 String/rRegex 值：
      • 在 [ 新增表達式] 區段的 [ 屬性 ] 列表中，從清單中選取預設屬性或中繼標記。 針對 [範例值]，輸入字串來表示可能出現的值類型。 當您預覽規則時，會使用此範例。 針對 [表達式]，輸入 regex 表達式來定義應該出現在搜尋結果中的屬性值部分。 您最多可以新增三個運算式。
      • 在 [ 建立公式] 區段中，輸入公式來結合從表達式擷取的值。

若要深入瞭解 regex 表達式，請參閱 .NET 正則表示式 或在 Web 中搜尋 regex 表達式參考指南。

同步處理

顯示 [同步] 索引標籤的螢幕快照，您可以在其中設定編目頻率。

重新整理間隔會決定數據源與 Graph 連接器索引之間同步處理資料的頻率。 重新整理間隔有兩種類型 ： 完整編目和累加編目。 如需詳細資訊，請參閱 重新整理設定。

您可以視需要從這裏變更重新整理間隔的預設值。

注意事項

只有在選取 sitemap 編目選項時，才支援累加編目。

疑難排解

發佈連線之後，您可以在系統管理中心的 [數據源] 索引卷標下檢閱狀態。 若要瞭解如何進行更新和刪除，請參閱 管理您的連接器。 您可以 在這裡找到常見問題的疑難解答步驟。

如果您有問題或想要提供意見反應，請 連絡 Microsoft Graph |支援。