共用方式為

Azure DevOps Wiki Microsoft Graph 連接器

  • 發行項

Azure DevOps Wiki Microsoft Graph 連接器可讓您的組織在其 Azure DevOps 服務實例中為 Wiki 編製索引。 設定連接器之後，終端使用者可以在 [搜尋和 Microsoft 365 Copilot] 中，從 Azure DevOps 搜尋專案 Wiki 和程式代碼 wiki Microsoft。

本文適用於Microsoft 365 位系統管理員或設定、執行及監視 Azure DevOps Wiki Microsoft Graph 連接器的任何人。

重要事項

Azure DevOps Wiki Microsoft Graph 連接器僅支援 Azure DevOps 雲端服務。 此連接器不支援 Azure DevOps Server 2019、TFS 2018、TFS 2017、TFS 2015 和 TFS 2013。

功能

  • 從 Azure DevOps 為 Wiki 編製索引
  • 讓用戶能夠詢問與專案Wiki和程式碼Wiki相關的問題。
  • 在 Copilot 中使用語意搜尋 ，讓用戶能夠根據關鍵詞、個人喜好設定和社交連線來尋找相關內容。

限制

  • 連接器只會為每個連線編制一個 ADO 組織的索引。

必要條件

  • 您必須是組織Microsoft 365 租使用者的 搜尋管理員 。

  • 若要允許連接器連線到您的 Azure DevOps 組織，您必須透過 OAuth 啟用第三方應用程式存取。 若要深入瞭解，請參閱 Azure DevOps 檔以 管理安全策略 。

    透過 OAuth 存取第三方應用程式

  • 服務帳戶：若要連線到 Azure DevOps 並允許 Microsoft Graph 連接器定期更新 Wiki，您需要一個具有下列許可權的服務帳戶。

    許可權名稱 許可權類型 的必要專案
    檢視專案層級資訊 項目許可權 編目 Azure DevOps 工作專案。 此許可權是需要編製索引之專案的 必要 許可權。

    重要事項

    服務帳戶必須具有 基本 存取層級。 若要深入瞭解 Azure DevOps 中的存取層級，請閱讀 支援的存取層級。

開始使用

顯示適用於 Azure DevOps Wikis 的 Graph 連接器Microsoft連線建立畫面的螢幕快照。

1.顯示名稱

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

2.驗證類型

若要從 Azure DevOps 驗證和同步 Wiki，請選擇 兩個支援的方法之一 ：

重要事項

a. Microsoft Entra ID OAuth (預覽)

確定您的 ADO 組織已連線到 Microsoft Entra

Azure DevOps Graph 連接器只會為與租使用者 Microsoft Entra 連線的 ADO 組織內容編制索引。 若要確保您的 ADO 組織與 Microsoft Entra 帳戶連線，請使用下列步驟。

  1. 流覽至 [Azure DevOps] ，然後選取所需的組織。
  2. 選取 Organization settings。
  3. 在左側瀏覽窗格中，選取 Microsoft Entra [一般] 標頭下方。
  4. 確定組織已連線到租使用者的 Microsoft Entra 帳戶。

在 Microsoft Entra ID 上建立應用程式

  1. 移至 Azure 入口網站，並使用租用戶的系統管理員認證登入。
  2. 從瀏覽窗格流覽至 [Microsoft Entra ID ->Manage ->應用程式註冊]，然後選取 [新增註冊]。
  3. 提供應用程式的名稱，然後選取 [ 註冊]。
  4. 記下應用程式 (用戶端) 識別碼。 此標識碼可用來將 Microsoft Entra 應用程式存取權授與 ADO 組織中的專案。
  5. 從瀏覽窗格開啟 API 許可權，然後選取 [ 新增許可權]。
  6. 選 取 [Azure DevOps] ，然後選取 [ 委派的許可權]。
  7. 搜尋下列許可權，然後選取 [新增許可權]。
    a. 身分識別 (讀取)
    b. 讀取 (程式代碼)
    c. (讀取)
    d. 專案和小組 (讀取)
    e. 圖表 (讀取)
    f. MemberEntitlement 管理 (讀取)
    g. Wiki (讀取)
  8. 選 取 [TenantName] 的 [授與系統管理員同意] ，然後選取 [ 是] 來確認。
  9. 檢查許可權是否處於「已授與」狀態。
  10. 從瀏覽窗格開啟 [驗證 ]。 選取 Add a platform 並選擇 Web。 在 [重新導向 URI] 下新增下列其中一個 URI：
    • 針對 M365 企業版： https://gcs.office.com/v1.0/admin/oauth/callback
    • 針對 M365 Government： https://gcsgcc.office.com/v1.0/admin/oauth/callback
  11. 在 [隱含授與和混合式流程] 下，核取 的選項 ID tokens (used for implicit and hybrid flows) ，然後按兩下 [ 設定]。
  12. 從瀏覽窗格中，選取 [管理] 底下的 [憑證和秘密]。
  13. 選 取 [新增客戶端密碼 ]，然後選取秘密的到期期間。 複製產生的秘密 (值) 並儲存它，因為它不會再次顯示。
  14. 使用此客戶端密碼和應用程式識別碼來設定連接器。

將 Microsoft Entra 應用程式存取權授與 ADO 組織中的專案

您必須使用下列步驟，為 Microsoft Entra 應用程式提供需要編製索引之專案的必要存取權：

  1. 流覽至 [Azure DevOps] ，然後選取所需的組織。
  2. 選取 Organization settings。
  3. 在左側瀏覽窗格中，選取 Users [一般] 標頭下方。
  4. 選取 Add users。
  5. 將從應用程式取得的應用程式 (用戶端) 識別碼複製到「用戶或服務主體」。
  6. 授與存 Basic 取層級，然後選取專案以允許存取索引。 同時將 新增至 Project Reader Azure DevOps 群組 (或對等) ，以確保存取權。 取消選取將電子郵件邀請傳送給用戶的選項。

Azure DevOps OAuth

若要連線到您的 Azure DevOps 實例，您需要 Azure DevOps 組織應用程式識別碼和客戶端密碼，才能進行 OAuth 驗證。

註冊應用程式

在 Azure DevOps 中註冊應用程式，讓 Microsoft 搜尋應用程式和 Microsoft 365 Copilot 可以存取實例。 若要註冊應用程式，請瀏覽連結以 註冊應用程式。 若要深入瞭解，請參閱 Azure DevOps 檔，以瞭解如何 註冊應用程式。

下表提供如何填寫應用程式註冊窗體的指引：

必要欄位 描述 建議值
公司名稱 您的公司名稱。 使用適當的值。
應用程式名稱 識別您正在授權之應用程式的唯一值。 Microsoft搜尋]。
應用程式網站 在連接器設定期間要求存取 Azure DevOps 實例的應用程式 URL。 (必要) 。 針對 Microsoft 365 企業版：https:// gcs.office。com/，
For Microsoft 365 Government： https:// gcsgcc.office.com/
授權回呼 URL 授權伺服器重新導向的必要回呼 URL。 針對 Microsoft 365 企業版：https:// gcs.office。com/v1.0/admin/oauth/callback，
適用於 Microsoft 365 Government：https:// gcsgcc.office。com/v1.0/admin/oauth/callback
授權的範圍 應用程式的存取範圍 選取下列範圍：身分識別 (讀取) 、程式代碼 (讀取) 、權利 (讀取) 、專案和小組 (讀取) 、Graph (讀取) 、成員權利管理 (讀取) 、Wiki (讀取) 。

重要事項

為應用程式選取的授權範圍應該完全符合上面所列的範圍。 如果選取更多或更少的範圍，授權就會失敗。

註冊應用程式時，您會取得用來設定連接器的 應用程式識別 碼和 客戶端密碼 。

若要撤銷在 Azure DevOps 中註冊之任何應用程式的存取權，請移至 Azure DevOps 實例右上方的 [用戶設定]。 選 取 [配置檔 ]，然後在側邊窗格的 [安全性] 區段中選取 [ 授權 ]。 將滑鼠停留在授權的 OAuth 應用程式上，以查看應用程式詳細數據角落的 [撤銷] 按鈕。

3.選取 [組織]

Azure DevOps 連接器允許針對每個連線編製一個組織的索引。 若要連線到您的 Azure DevOps 服務，請從服務帳戶可存取的組織清單中選取正確的組織。

4.向有限的物件推出

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

此時，您已準備好建立 Azure DevOps Wiki 的連線。 您可以按兩下 [建立] ，從您的 Azure DevOps 組織發佈連線並編製 Wiki 的索引。

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

使用者 描述
訪問許可權 只有具有數據源中內容存取權的人員。
對應身分識別 使用 Microsoft Entra標識碼對應的數據源身分識別。
內容 描述
網站專案 所有項目都會編製索引。
管理屬性 若要檢查預設屬性及其架構，請參閱 內容
同步處理 描述
累加編目 頻率：每 15 分鐘
完整編目 頻率：每天

如果您要編輯其中任何一個值，您必須選擇 「自訂安裝程式」

自訂安裝程式

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

使用者

顯示 [使用者] 索引標籤標的螢幕快照，您可以在其中設定訪問許可權和使用者對應規則。

訪問許可權

Azure DevOps Wiki 連接器支援 「所有人 」或 「僅限具有此數據源存取權的人員」可看見的搜尋許可權。 如果您選擇 [ 所有人]，已編製索引的數據會出現在所有使用者的搜尋結果中。 如果您選擇 [僅限可存取此數據源的人員]，則已編製索引的數據會出現在具有此數據源存取權之使用者的搜尋結果中。

注意事項

匯報 管理訪問許可權的群組只會在完整編目中同步處理。 累加編目不支援處理許可權的更新。

內容

顯示 [內容] 索引標籤的螢幕快照，您可以在其中設定項目和連線架構。

選擇專案

在此步驟中，您會使用 Azure DevOps Wiki Microsoft Graph 連接器指定要編制索引的數據範圍。 然後，您可以選擇連線來為整個組織或所選組織內的特定項目編製索引。

如果您選擇為整個組織編製索引，則會為組織中所有專案中的Wiki編製索引。 新專案和Wiki會在建立之後的下一個編目期間編製索引。

如果您選擇為個別項目編製索引，則只會編製所選專案中的Wiki索引。

管理屬性

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

Source 屬性 標籤 描述 Schema
Authors Authors 為數據源中參與/共同作業專案的所有人員命名 取回
CommitId
內容 內容 Wiki 的內容本文 搜尋
GitItemPath
IconUrl IconUrl 代表Wiki的圖示URL 取回
isParentPage
LastPublishedAuthorEmail 上次修改者 取回
LastPublishedDate 上次修改日期時間 上次在數據源中修改專案的日期和時間 擷取
Organization 取回
路徑
Project 取回
ProjectId 取回
RemoteURL URL 數據源中Wiki的URL 取回
標題 標題 Wiki 頁面的標題 搜尋、擷取
版本 取回
WikiId 取回
WikiIdentifier 取回
WikiType

預覽數據

使用 [預覽結果] 按鈕來驗證所選屬性的範例值。

同步處理

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

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

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

設定搜尋結果頁面

發佈連線之後，您必須使用垂直和結果類型來自定義搜尋結果頁面。 若要瞭解如何自定義搜尋結果，請檢閱如何 管理垂直 和 結果類型。

您也可以使用 Azure DevOps Wiki Microsoft Graph 連接器的 範例結果配置 。 只要複製並貼上結果配置 JSON 即可開始使用。

疑難排解

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

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